{
"statusCode": 404,
"message": "Task not found"
}
{
"statusCode": 429,
"message": "Too many requests"
}
Tasks
Update task
Updates one or more fields on an existing task. Only fields included in the request body are changed. Accepts either a UUID or an external ID (e.g. PROJ-42).
Files attached to this task. Each entry contains only the attachment ID and filename. Use GET /{projectSlug}/tasks/{taskId}/attachments/{attachmentId} to retrieve the full attachment details including the download URL.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"elean","colors":{"primary":"#80b85c","light":"#80b85c","dark":"#80b85c"},"logo":{"light":"https://mintcdn.com/elean/V4s0CNdIDIc0PYdY/images/logo-standard.svg?fit=max\u0026auto=format\u0026n=V4s0CNdIDIc0PYdY\u0026q=85\u0026s=f6a5a39821a593612f0739bdba79a7c1","dark":"https://mintcdn.com/elean/V4s0CNdIDIc0PYdY/images/logo-alt.svg?fit=max\u0026auto=format\u0026n=V4s0CNdIDIc0PYdY\u0026q=85\u0026s=f1985b397210ad0d9e106f127fe169d9"},"favicon":"https://mintcdn.com/elean/P9KpzXbLj7fNcTb3/images/favicon.ico?fit=max\u0026auto=format\u0026n=P9KpzXbLj7fNcTb3\u0026q=85\u0026s=dd9315e6a859439b82d22d2431720316","appearance":{"default":"dark","strict":true},"navbar":{"links":[],"primary":{"type":"button","label":"Dashboard","href":"https://elean.app/login"}},"footer":{"socials":{"x":"https://x.com/elean_app","discord":"https://discord.gg/elean"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"book-open-cover","href":"https://elean.app/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"elean","hasAudioNarration":false,"actualSubdomain":"elean","customDomains":["docs.elean.app"],"gitSource":{"type":"github","owner":"elean-app","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ac67aea48199c28249a9f3d","collectionId":"477ed5cd-7588-4b99-914c-e8ac7f726eb0","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac67aea48199c28249a9f3d"},"feedback":{"thumbs":false},"entitlements":{},"buildId":"6ac67aea48199c28249a9f3d","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API reference","count":13},{"language":"default","tag":"Endpoints","count":12},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Tasks","count":7},{"language":"default","tag":"Integrations","count":3},{"language":"default","tag":"AI agents (MCP)","count":3},{"language":"default","tag":"Getting started","count":2},{"language":"default","tag":"Comments","count":2},{"language":"default","tag":"API documentation","count":1},{"language":"default","tag":"Labels","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/tasks/update-task","slug":"/api-reference/tasks/update-task","pageMetadata":{"title":"Update task","description":"Updates one or more fields on an existing task. Only fields included in the request body are changed. Accepts either a UUID or an external ID (e.g. `PROJ-42`).\n\nRequires the `task:update` scope.","deprecated":null,"version":null,"openapi":"/api-reference/api.json patch /{projectSlug}/tasks/{taskId}","href":"/api-reference/tasks/update-task","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Updates one or more fields on an existing task. Only fields included in the request body are changed. Accepts either a UUID or an external ID (e.g. \", _jsx(_components.code, {\n children: \"PROJ-42\"\n }), \").\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Requires the \", _jsx(_components.code, {\n children: \"task:update\"\n }), \" scope.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update task","description":"Updates one or more fields on an existing task. Only fields included in the request body are changed. Accepts either a UUID or an external ID (e.g. `PROJ-42`).\n\nRequires the `task:update` scope.","deprecated":null,"version":null,"openapi":"/api-reference/api.json patch /{projectSlug}/tasks/{taskId}","href":"/api-reference/tasks/update-task","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"updateTask","summary":"Update task","description":"Updates one or more fields on an existing task. Only fields included in the request body are changed. Accepts either a UUID or an external ID (e.g. `PROJ-42`).\n\nRequires the `task:update` scope.","tags":["Tasks"],"parameters":["fcad7107-f2da-45a6-bd0b-416bcf3723f2","9e6d0fea-62b0-4033-9f27-7c5590d8e5e0"],"requestBody":"2ce45ac1-2b38-4954-aa81-603cd75453e8","responses":{"200":"8cae0ee2-9e63-43ae-9de4-6e642e570f1a","400":"27c73d6b-2b02-463e-a8db-55c1d8cc48d9","401":"0358c903-73df-46fc-afdf-6a3e9c5afb84","403":"97047a7d-fa66-4051-98c9-7a899769ae2e","404":"8db02119-4996-48ea-b8dc-a32d14063c02","429":"8b3d682f-f140-4b46-85ca-74185f3411b5"},"method":"patch","type":"path","servers":["43459fd6-e304-42c8-8f50-f1bf6e9e9050"],"security":["1630755e-3e90-4018-82e7-005e57e50b35"],"path":"/{projectSlug}/tasks/{taskId}","baseUrlOptions":["https://api.elean.app/v1/public"],"title":"Update task","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"fcad7107-f2da-45a6-bd0b-416bcf3723f2":{"name":"projectSlug","in":"path","required":true,"description":"The slug of the project.","schema":{"type":"string","example":"my-project","isRequired":true,"description":"The slug of the project.","uniqueKey":"","typeLabel":"string"}},"9e6d0fea-62b0-4033-9f27-7c5590d8e5e0":{"name":"taskId","in":"path","required":true,"description":"UUID of the task, or its external ID (e.g. `PROJ-42`).","schema":{"type":"string","example":"PROJ-42","isRequired":true,"description":"UUID of the task, or its external ID (e.g. `PROJ-42`).","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Fields to update. Only included fields are changed.","properties":{"title":{"type":"string","minLength":1,"maxLength":500,"description":"New task title.","example":"Fix login bug (Safari)","uniqueKey":"title","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"New description as plain text, or `null` to clear it.","example":"Reproducible on Safari 17+.","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","description":"New description as plain text, or `null` to clear it.","example":"Reproducible on Safari 17+.","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"priority":{"type":"string","enum":["none","low","medium","high","urgent"],"example":"urgent","uniqueKey":"priority","typeLabel":"enum\u003cstring>"},"dueDate":{"oneOf":[{"type":"string","format":"date-time","description":"Due date in ISO 8601 format, or `null` to clear it.","example":"2026-04-01T00:00:00.000Z","uniqueKey":"dueDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Due date in ISO 8601 format, or `null` to clear it.","example":"2026-04-01T00:00:00.000Z","uniqueKey":"dueDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"dueDate","typeLabel":"string\u003cdate-time> | null"},"statusId":{"type":"string","format":"uuid","description":"UUID of the custom status to assign.","example":"018e1b2c-aaaa-0000-0000-000000000002","uniqueKey":"statusId","typeLabel":"string\u003cuuid>"},"assigneeIds":{"type":"array","description":"Replaces the full list of assignees. Pass an empty array to remove all assignees. Maximum 5. Use `GET /{projectSlug}/members` to retrieve available IDs.","items":{"type":"string","format":"uuid","uniqueKey":"assigneeIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"example":["018e1b2c-0000-0000-0000-000000000099"],"uniqueKey":"assigneeIds","typeLabel":"string\u003cuuid>[]"},"labelIds":{"type":"array","description":"Replaces the full list of labels. Pass an empty array to remove all labels. Use `GET /{projectSlug}/labels` to retrieve available IDs.","items":{"type":"string","format":"uuid","uniqueKey":"labelIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"example":["018e1b2c-aaaa-0000-0000-000000000010"],"uniqueKey":"labelIds","typeLabel":"string\u003cuuid>[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"priority":"urgent","statusId":"018e1b2c-aaaa-0000-0000-000000000002"},"examples":{"Example":{"title":"Example","value":{"priority":"urgent","statusId":"018e1b2c-aaaa-0000-0000-000000000002"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"8cae0ee2-9e63-43ae-9de4-6e642e570f1a":{"description":"Task updated successfully.","content":{"application/json":{"schema":{"type":"object","description":"A task object returned by the API.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the task.","example":"018e1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c","uniqueKey":"id","typeLabel":"string\u003cuuid>"},"externalId":{"type":"string","description":"Human-readable task identifier, unique within the project (e.g. `PROJ-42`).","example":"PROJ-42","uniqueKey":"externalId","typeLabel":"string"},"title":{"type":"string","description":"Task title.","example":"Fix login bug","uniqueKey":"title","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"Task description as plain text. Newlines are preserved.","example":"Users cannot log in with SSO on Safari.","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Task description as plain text. Newlines are preserved.","example":"Users cannot log in with SSO on Safari.","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"category":{"type":"string","enum":["todo","in_progress","done"],"description":"Status category of the task. For the specific named status, see `status`.","example":"in_progress","uniqueKey":"category","typeLabel":"enum\u003cstring>"},"status":{"oneOf":[{"type":"object","description":"The specific custom status assigned to this task, or `null` if none is set.","properties":{"id":{"type":"string","format":"uuid","example":"018e1b2c-aaaa-0000-0000-000000000002","uniqueKey":"status.oneOf.0.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","example":"In Review","uniqueKey":"status.oneOf.0.name","typeLabel":"string"},"color":{"oneOf":[{"type":"string","example":"#f59e0b","uniqueKey":"status.oneOf.0.color.oneOf.0","typeLabel":"string"},{"type":"null","example":"#f59e0b","uniqueKey":"status.oneOf.0.color.oneOf.1","typeLabel":"null"}],"uniqueKey":"status.oneOf.0.color","typeLabel":"string | null"},"category":{"type":"string","enum":["todo","in_progress","done"],"example":"in_progress","uniqueKey":"status.oneOf.0.category","typeLabel":"enum\u003cstring>"}},"uniqueKey":"status.oneOf.0","typeLabel":"object"},{"type":"null","description":"The specific custom status assigned to this task, or `null` if none is set.","uniqueKey":"status.oneOf.1","typeLabel":"null"}],"uniqueKey":"status","typeLabel":"object | null"},"priority":{"type":"string","enum":["none","low","medium","high","urgent"],"description":"Priority level of the task.","example":"high","uniqueKey":"priority","typeLabel":"enum\u003cstring>"},"dueDate":{"oneOf":[{"type":"string","format":"date-time","description":"Due date in ISO 8601 format, or `null` if not set.","example":"2026-03-15T00:00:00.000Z","uniqueKey":"dueDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Due date in ISO 8601 format, or `null` if not set.","example":"2026-03-15T00:00:00.000Z","uniqueKey":"dueDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"dueDate","typeLabel":"string\u003cdate-time> | null"},"assignees":{"type":"array","description":"List of users assigned to the task.","items":{"type":"object","description":"A minimal representation of a user assigned to a task.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the user.","example":"018e1b2c-0000-0000-0000-000000000099","uniqueKey":"assignees.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"name":{"oneOf":[{"type":"string","description":"Display name of the user.","example":"Jane Smith","uniqueKey":"assignees.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Display name of the user.","example":"Jane Smith","uniqueKey":"assignees.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"assignees.items.[INDEX].name","typeLabel":"string | null"}},"uniqueKey":"assignees.items.[INDEX]","typeLabel":"object"},"uniqueKey":"assignees","typeLabel":"object[]"},"labels":{"type":"array","description":"Labels attached to the task.","items":{"type":"object","description":"A label that can be attached to tasks.","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the label.","example":"018e1b2c-aaaa-0000-0000-000000000010","uniqueKey":"labels.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"Display name of the label.","example":"bug","uniqueKey":"labels.items.[INDEX].name","typeLabel":"string"},"color":{"type":"string","description":"Hex color code of the label.","example":"#EF4444","uniqueKey":"labels.items.[INDEX].color","typeLabel":"string"}},"uniqueKey":"labels.items.[INDEX]","typeLabel":"object"},"uniqueKey":"labels","typeLabel":"object[]"},"attachments":{"type":"array","description":"Files attached to this task. Each entry contains only the attachment ID and filename. Use `GET /{projectSlug}/tasks/{taskId}/attachments/{attachmentId}` to retrieve the full attachment details including the download URL.","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier of the attachment.","example":"018e1b2c-aaaa-bbbb-cccc-000000000001","uniqueKey":"attachments.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"filename":{"type":"string","description":"Original filename of the uploaded file.","example":"screenshot.png","uniqueKey":"attachments.items.[INDEX].filename","typeLabel":"string"}},"uniqueKey":"attachments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"attachments","typeLabel":"object[]"},"createdAt":{"type":"string","format":"date-time","description":"ISO 8601 timestamp of when the task was created.","example":"2026-03-01T12:00:00.000Z","uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"ISO 8601 timestamp of the last update.","example":"2026-03-02T09:30:00.000Z","uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"018e1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c","externalId":"PROJ-42","title":"Fix login bug","description":"Users cannot log in with SSO on Safari.","category":"in_progress","status":{"id":"018e1b2c-aaaa-0000-0000-000000000002","name":"In Review","color":"#f59e0b","category":"in_progress"},"priority":"high","dueDate":"2026-03-15T00:00:00.000Z","assignees":[{"id":"018e1b2c-0000-0000-0000-000000000099","name":"Jane Smith"}],"labels":[{"id":"018e1b2c-aaaa-0000-0000-000000000010","name":"bug","color":"#EF4444"}],"attachments":[{"id":"018e1b2c-aaaa-bbbb-cccc-000000000001","filename":"screenshot.png"}],"createdAt":"2026-03-01T12:00:00.000Z","updatedAt":"2026-03-02T09:30:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"27c73d6b-2b02-463e-a8db-55c1d8cc48d9":{"description":"The request body is missing required fields or contains invalid values.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":401,"uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","example":"Invalid API key","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":400,"message":"title must be longer than or equal to 1 characters"},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"message":"title must be longer than or equal to 1 characters"}}},"exampleType":"examples"}},"exampleType":"examples"},"0358c903-73df-46fc-afdf-6a3e9c5afb84":{"description":"The API key is missing, invalid, or expired.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":401,"uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","example":"Invalid API key","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":401,"message":"Invalid API key"},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"message":"Invalid API key"}}},"exampleType":"examples"}},"exampleType":"examples"},"97047a7d-fa66-4051-98c9-7a899769ae2e":{"description":"The API key does not have the required scope, or the project is outside the key's allowed scope.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":401,"uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","example":"Invalid API key","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":403,"message":"Missing required scope: task:create"},"examples":{"Example":{"title":"Example","value":{"statusCode":403,"message":"Missing required scope: task:create"}}},"exampleType":"examples"}},"exampleType":"examples"},"8db02119-4996-48ea-b8dc-a32d14063c02":{"description":"The project or task was not found within the key's workspace.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":401,"uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","example":"Invalid API key","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":404,"message":"Task not found"},"examples":{"Example":{"title":"Example","value":{"statusCode":404,"message":"Task not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"8b3d682f-f140-4b46-85ca-74185f3411b5":{"description":"The rate limit for this API key has been exceeded. Retry after the indicated delay.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","example":401,"uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","example":"Invalid API key","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":429,"message":"Too many requests"},"examples":{"Example":{"title":"Example","value":{"statusCode":429,"message":"Too many requests"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"1630755e-3e90-4018-82e7-005e57e50b35":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"el_\u003ctoken>","description":"API key created in **Workspace Settings → API Keys**. Pass it in the `Authorization` header as a Bearer token, or in the `X-API-Key` header.\n\nFormat: `el_` followed by 40 hex characters.","scopes":[]}}},"servers":{"43459fd6-e304-42c8-8f50-f1bf6e9e9050":{"url":"https://api.elean.app/v1/public","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"el_\u003ctoken>","description":"API key created in **Workspace Settings → API Keys**. Pass it in the `Authorization` header as a Bearer token, or in the `X-API-Key` header.\n\nFormat: `el_` followed by 40 hex characters.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key created in **Workspace Settings → API Keys**. Pass it in the `Authorization` header as a Bearer token, or in the `X-API-Key` header.\n\nFormat: `el_` followed by 40 hex characters.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/api.json"},"subdomain":"elean","siteName":"elean","title":"Update task - elean","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-15T19:17:24.721Z","originalFileLocation":"api-reference/tasks/update-task.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Updates one or more fields on an existing task. Only fields included in the request body are changed. Accepts either a UUID or an external ID (e.g. PROJ-42). Requires the task:update scope.\">\u003cmeta data-mint-head name=\"application-name\" content=\"elean\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/elean/w_Oj6yMCSW1B_pVu/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/elean/w_Oj6yMCSW1B_pVu/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/elean/w_Oj6yMCSW1B_pVu/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/elean/w_Oj6yMCSW1B_pVu/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/elean/w_Oj6yMCSW1B_pVu/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/elean/w_Oj6yMCSW1B_pVu/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/elean/w_Oj6yMCSW1B_pVu/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/elean/w_Oj6yMCSW1B_pVu/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/elean/w_Oj6yMCSW1B_pVu/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update task - elean\">\u003cmeta data-mint-head property=\"og:description\" content=\"Updates one or more fields on an existing task. Only fields included in the request body are changed. Accepts either a UUID or an external ID (e.g. PROJ-42). Requires the task:update scope.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"elean\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.elean.app/api-reference/tasks/update-task\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://elean.mintlify.app/_mintlify/api/og/v2?division=Tasks\u0026amp;title=Update+task\u0026amp;description=Updates+one+or+more+fields+on+an+existing+task.+Only+fields+included+in+the+request+body+are+changed.+Accepts+either+a+UUID+or+an+external+ID+%28e.g.+%60PROJ-42%60%29.%0A\u0026amp;theme=13f3c7d57c4261ab8cfd7035\u0026amp;signature=8cd78cd6baab43ce756df20a69e109b9a4a3a5d33435fefe09ed78338b7ca1d1\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update task - elean\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Updates one or more fields on an existing task. Only fields included in the request body are changed. Accepts either a UUID or an external ID (e.g. PROJ-42). Requires the task:update scope.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://elean.mintlify.app/_mintlify/api/og/v2?division=Tasks\u0026amp;title=Update+task\u0026amp;description=Updates+one+or+more+fields+on+an+existing+task.+Only+fields+included+in+the+request+body+are+changed.+Accepts+either+a+UUID+or+an+external+ID+%28e.g.+%60PROJ-42%60%29.%0A\u0026amp;theme=13f3c7d57c4261ab8cfd7035\u0026amp;signature=8cd78cd6baab43ce756df20a69e109b9a4a3a5d33435fefe09ed78338b7ca1d1\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/elean/w_Oj6yMCSW1B_pVu/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"elean\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#80b85c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.elean.app/api-reference/tasks/update-task\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tasks/update-task.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.elean.app/#organization\",\"name\":\"elean\",\"url\":\"https://docs.elean.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/elean/V4s0CNdIDIc0PYdY/images/logo-standard.svg?fit=max\u0026auto=format\u0026n=V4s0CNdIDIc0PYdY\u0026q=85\u0026s=f6a5a39821a593612f0739bdba79a7c1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.elean.app#website\",\"name\":\"elean\",\"url\":\"https://docs.elean.app\",\"publisher\":{\"@id\":\"https://docs.elean.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.elean.app/api-reference/tasks/update-task#webpage\",\"url\":\"https://docs.elean.app/api-reference/tasks/update-task\",\"name\":\"Update task\",\"description\":\"Updates one or more fields on an existing task. Only fields included in the request body are changed. Accepts either a UUID or an external ID (e.g. PROJ-42). Requires the task:update scope.\",\"dateModified\":\"2026-05-15T19:17:24.721Z\",\"isPartOf\":{\"@id\":\"https://docs.elean.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.elean.app/api-reference/tasks/update-task#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.elean.app/api-reference/tasks/update-task#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.elean.app/api-reference/labels/list-labels\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tasks\",\"item\":\"https://docs.elean.app/api-reference/tasks/list-tasks\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update task\",\"item\":\"https://docs.elean.app/api-reference/tasks/update-task\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.elean.app/api-reference/tasks/update-task#apireference\",\"headline\":\"Update task\",\"name\":\"Update task\",\"description\":\"Updates one or more fields on an existing task. Only fields included in the request body are changed. Accepts either a UUID or an external ID (e.g. PROJ-42). Requires the task:update scope.\",\"url\":\"https://docs.elean.app/api-reference/tasks/update-task\",\"mainEntityOfPage\":{\"@id\":\"https://docs.elean.app/api-reference/tasks/update-task#webpage\"},\"dateModified\":\"2026-05-15T19:17:24.721Z\",\"publisher\":{\"@id\":\"https://docs.elean.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.elean.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"elean\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"elean","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"book-open-cover","href":"https://elean.app/changelog"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"API documentation","pages":[{"title":"Public API","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"Labels","pages":[{"title":"List labels","deprecated":null,"version":null,"openapi":"/api-reference/api.json get /{projectSlug}/labels","href":"/api-reference/labels/list-labels"}]},{"group":"Members","pages":[{"title":"List members","deprecated":null,"version":null,"openapi":"/api-reference/api.json get /{projectSlug}/members","href":"/api-reference/members/list-members"}]},{"group":"Statuses","pages":[{"title":"List statuses","deprecated":null,"version":null,"openapi":"/api-reference/api.json get /{projectSlug}/statuses","href":"/api-reference/statuses/list-statuses"}]},{"group":"Tasks","pages":[{"title":"List tasks","deprecated":null,"version":null,"openapi":"/api-reference/api.json get /{projectSlug}/tasks","href":"/api-reference/tasks/list-tasks"},{"title":"Create task","deprecated":null,"version":null,"openapi":"/api-reference/api.json post /{projectSlug}/tasks","href":"/api-reference/tasks/create-task"},{"title":"Get task","deprecated":null,"version":null,"openapi":"/api-reference/api.json get /{projectSlug}/tasks/{taskId}","href":"/api-reference/tasks/get-task"},{"title":"Delete task","description":"Permanently deletes a task. This action cannot be undone. Accepts either a UUID or an external ID (e.g. `PROJ-42`).\n\nRequires the `task:update` scope.","deprecated":null,"version":null,"openapi":"/api-reference/api.json delete /{projectSlug}/tasks/{taskId}","href":"/api-reference/tasks/delete-task"},{"title":"Update task","deprecated":null,"version":null,"openapi":"/api-reference/api.json patch /{projectSlug}/tasks/{taskId}","href":"/api-reference/tasks/update-task"},{"title":"Get attachment","description":"Returns a single attachment by its UUID. The attachment must belong to the specified task.\n\nRequires the `task:read` scope.","deprecated":null,"version":null,"openapi":"/api-reference/api.json get /{projectSlug}/tasks/{taskId}/attachments/{attachmentId}","href":"/api-reference/tasks/get-attachment"},{"title":"Upload attachment","deprecated":null,"version":null,"openapi":"/api-reference/api.json post /{projectSlug}/tasks/{taskId}/attachments","href":"/api-reference/tasks/upload-attachment"}]},{"group":"Comments","pages":[{"title":"List comments","deprecated":null,"version":null,"openapi":"/api-reference/api.json get /{projectSlug}/tasks/{taskId}/comments","href":"/api-reference/comments/list-comments"},{"title":"Add comment","deprecated":null,"version":null,"openapi":"/api-reference/api.json post /{projectSlug}/tasks/{taskId}/comments","href":"/api-reference/comments/add-comment"}]}]}]}]},"title":"Update task - elean","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}