{ "error": "Invalid priority. Must be one of: urgent, high, medium, low, none"}
{ "error": "Invalid API key"}
{ "error": "Scope 'tasks:write' is required for this endpoint"}
{ "error": "Task not found"}
Requires the tasks:write scope. Viewers cannot edit tasks. Access-restricted
members receive 403 if the task belongs to, or is being moved to, a list
outside their permitted scope.
Array of numeric user IDs to assign to the task. Replaces the current
assignees entirely. Pass an empty array to remove all assignees. Omit this
field to leave the current assignees unchanged. All IDs must be members of the
same workspace; non-member IDs are silently ignored.
Optional array of custom field values to update. Each entry must contain a numeric id and a string value (or null to clear that field’s value). Omitting this field entirely leaves all custom field values unchanged. Only fields that apply to the task’s list and are visible to the API key user are processed; other fields are silently ignored.
{ "error": "Invalid priority. Must be one of: urgent, high, medium, low, none"}
{ "error": "Invalid API key"}
{ "error": "Scope 'tasks:write' is required for this endpoint"}
{ "error": "Task not found"}
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Arca Documentation","colors":{"primary":"#3A72F2","light":"#3A72F2","dark":"#3A72F2"},"logo":{"light":"https://mintcdn.com/arca-8f4cdaaf/LBZ6XQwOq9jaxx8a/logo/light.svg?fit=max\u0026auto=format\u0026n=LBZ6XQwOq9jaxx8a\u0026q=85\u0026s=ad9c52e4c7e2b71cc11fe3cf92c54ef1","dark":"https://mintcdn.com/arca-8f4cdaaf/LBZ6XQwOq9jaxx8a/logo/dark.svg?fit=max\u0026auto=format\u0026n=LBZ6XQwOq9jaxx8a\u0026q=85\u0026s=a33f9281003b4f1534d60b3cbaf02f31"},"favicon":"https://mintcdn.com/arca-8f4cdaaf/LBZ6XQwOq9jaxx8a/favicon.svg?fit=max\u0026auto=format\u0026n=LBZ6XQwOq9jaxx8a\u0026q=85\u0026s=ec17aff983f1769d8b8b06ab480c2a5f","api":{"playground":{"display":"interactive","proxy":false},"examples":{"languages":["bash","javascript","typescript","node","python","go","php","rust","dart","ruby","java","swift","csharp","c","c++","dotnet","kotlin"]},"mdx":{"auth":{"method":"bearer"},"server":"https://api.getarca.app"}},"navbar":{"links":[{"href":"mailto:info@getarca.app","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/arca_app","linkedin":"https://linkedin.com/company/getarca","website":"https://getarca.app"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","cursor"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Arca Website","icon":"globe","href":"https://getarca.app/"},{"anchor":"Download Arca","icon":"download","href":"https://getarca.app/download"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"arca-8f4cdaaf","hasAudioNarration":false,"actualSubdomain":"arca-8f4cdaaf","customDomains":["docs.getarca.app"],"gitSource":{"type":"github","owner":"gre-dev","repo":"arca-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae94a1fad87a8c861a8109f:success","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Knowledge base","count":62},{"language":"default","tag":"API reference","count":32},{"language":"default","tag":"Integrations","count":24},{"language":"default","tag":"Tasks","count":16},{"language":"default","tag":"Administration","count":15},{"language":"default","tag":"Arca Apps","count":13},{"language":"default","tag":"General features","count":6},{"language":"default","tag":"Lists","count":5},{"language":"default","tag":"Views","count":5},{"language":"default","tag":"Account","count":4}]},"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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/tasks/update","slug":"/api-reference/tasks/update","pageMetadata":{"title":"Update task","api":"PATCH /api/v1/tasks/{id}","description":"Updates one or more fields of a task. Only the fields you include are changed.","href":"/api-reference/tasks/update"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Updates one or more fields of a task. Only the fields you include are changed.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Info,ParamField,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[`Requires the `,_jsx(_components.code,{children:`tasks:write`}),` scope. Viewers cannot edit tasks. Access-restricted\nmembers receive `,_jsx(_components.code,{children:`403`}),` if the task belongs to, or is being moved to, a list\noutside their permitted scope.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path parameters`}),`\n`,_jsx(ParamField,{path:`id`,type:`string`,required:true,id:`param-id`,children:_jsx(_components.p,{children:`The numeric task ID.`})}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request body`}),`\n`,_jsx(_components.p,{children:`All fields are optional. Send only the fields you want to update.`}),`\n`,_jsx(ParamField,{body:`title`,type:`string`,id:`param-title`,children:_jsx(_components.p,{children:`New task title. Cannot be set to an empty string.`})}),`\n`,_jsx(ParamField,{body:`description`,type:`string`,id:`param-description`,children:_jsx(_components.p,{children:`Task description as an HTML string.`})}),`\n`,_jsx(ParamField,{body:`priority`,type:`string`,id:`param-priority`,children:_jsxs(_components.p,{children:[`Task priority. Must be one of `,_jsx(_components.code,{children:`urgent`}),`, `,_jsx(_components.code,{children:`high`}),`, `,_jsx(_components.code,{children:`medium`}),`, `,_jsx(_components.code,{children:`low`}),`, or `,_jsx(_components.code,{children:`none`}),`.`]})}),`\n`,_jsx(ParamField,{body:`status_id`,type:`string`,id:`param-status-id`,children:_jsx(_components.p,{children:`Numeric ID of a workspace status to apply. The status must belong to the same\nworkspace.`})}),`\n`,_jsx(ParamField,{body:`list_id`,type:`string`,id:`param-list-id`,children:_jsx(_components.p,{children:`Numeric ID of a list to move the task into. The list must belong to the same\nworkspace.`})}),`\n`,_jsx(ParamField,{body:`due_date`,type:`string | null`,id:`param-due-date`,children:_jsxs(_components.p,{children:[`Due date in ISO 8601 UTC format (e.g., `,_jsx(_components.code,{children:`\"2026-03-30T17:00:00Z\"`}),`). Pass `,_jsx(_components.code,{children:`null`}),` or an empty string to remove the due date.`]})}),`\n`,_jsx(ParamField,{body:`start_date`,type:`string | null`,id:`param-start-date`,children:_jsxs(_components.p,{children:[`Start date in ISO 8601 UTC format. Pass `,_jsx(_components.code,{children:`null`}),` or an empty string to remove the start date.`]})}),`\n`,_jsx(ParamField,{body:`assignee_ids`,type:`array`,id:`param-assignee-ids`,children:_jsx(_components.p,{children:`Array of numeric user IDs to assign to the task. Replaces the current\nassignees entirely. Pass an empty array to remove all assignees. Omit this\nfield to leave the current assignees unchanged. All IDs must be members of the\nsame workspace; non-member IDs are silently ignored.`})}),`\n`,_jsxs(ParamField,{body:`custom_fields`,type:`array`,id:`param-custom-fields`,children:[_jsxs(_components.p,{children:[`Optional array of custom field values to update. Each entry must contain a numeric `,_jsx(_components.code,{children:`id`}),` and a string `,_jsx(_components.code,{children:`value`}),` (or `,_jsx(_components.code,{children:`null`}),` to clear that field’s value). Omitting this field entirely leaves all custom field values unchanged. Only fields that apply to the task’s list and are visible to the API key user are processed; other fields are silently ignored.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"custom_fields\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Starter\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`Returns the full updated task including its current assignees.`}),`\n`,_jsx(ResponseField,{name:`id`,type:`number`,required:true,id:`param-id-1`,children:_jsx(_components.p,{children:`Task identifier.`})}),`\n`,_jsx(ResponseField,{name:`workspace_id`,type:`number`,required:true,id:`param-workspace-id`,children:_jsx(_components.p,{children:`Workspace this task belongs to.`})}),`\n`,_jsx(ResponseField,{name:`list_id`,type:`number | null`,id:`param-list-id-1`,children:_jsx(_components.p,{children:`List this task belongs to.`})}),`\n`,_jsx(ResponseField,{name:`title`,type:`string`,required:true,id:`param-title-1`,children:_jsx(_components.p,{children:`Task title.`})}),`\n`,_jsx(ResponseField,{name:`description`,type:`string | null`,id:`param-description-1`,children:_jsx(_components.p,{children:`Task description.`})}),`\n`,_jsx(ResponseField,{name:`priority`,type:`string`,required:true,id:`param-priority-1`,children:_jsx(_components.p,{children:`Task priority.`})}),`\n`,_jsx(ResponseField,{name:`identifier`,type:`number`,required:true,id:`param-identifier`,children:_jsx(_components.p,{children:`Workspace-scoped sequential task number.`})}),`\n`,_jsx(ResponseField,{name:`due_date`,type:`string | null`,id:`param-due-date-1`,children:_jsx(_components.p,{children:`UTC ISO-8601 due date.`})}),`\n`,_jsx(ResponseField,{name:`start_date`,type:`string | null`,id:`param-start-date-1`,children:_jsx(_components.p,{children:`UTC ISO-8601 start date.`})}),`\n`,_jsx(ResponseField,{name:`creator_id`,type:`number`,required:true,id:`param-creator-id`,children:_jsx(_components.p,{children:`User ID of the task creator.`})}),`\n`,_jsx(ResponseField,{name:`created_at`,type:`string`,required:true,id:`param-created-at`,children:_jsx(_components.p,{children:`UTC ISO-8601 creation timestamp.`})}),`\n`,_jsxs(ResponseField,{name:`status`,type:`object | null`,id:`param-status`,children:[_jsx(_components.p,{children:`Current task status.`}),_jsxs(Expandable,{title:`Status fields`,children:[_jsx(ResponseField,{name:`id`,type:`number`,required:true,id:`param-id-2`,children:`Status identifier.`}),_jsx(ResponseField,{name:`name`,type:`string`,required:true,id:`param-name`,children:`Status label.`}),_jsx(ResponseField,{name:`icon`,type:`string | null`,id:`param-icon`,children:`Icon.`}),_jsx(ResponseField,{name:`color`,type:`string | null`,id:`param-color`,children:`Color.`}),_jsxs(ResponseField,{name:`category`,type:`string`,required:true,id:`param-category`,children:[`One of `,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`in_progress`}),`, `,_jsx(_components.code,{children:`completed`}),`, or `,_jsx(_components.code,{children:`cancelled`}),`.`]})]})]}),`\n`,_jsxs(ResponseField,{name:`assignees`,type:`array`,required:true,id:`param-assignees`,children:[_jsx(_components.p,{children:`Current assignees. Empty array if unassigned.`}),_jsxs(Expandable,{title:`Assignee fields`,children:[_jsx(ResponseField,{name:`id`,type:`number`,required:true,id:`param-id-3`,children:`User ID.`}),_jsx(ResponseField,{name:`name`,type:`string`,required:true,id:`param-name-1`,children:`Display name.`}),_jsx(ResponseField,{name:`avatar_url`,type:`string | null`,id:`param-avatar-url`,children:`Profile picture URL.`})]})]}),`\n`,_jsxs(ResponseField,{name:`custom_fields`,type:`array`,required:true,id:`param-custom-fields-1`,children:[_jsx(_components.p,{children:`Custom fields that apply to the task’s list, each with its current value after the update.\nFields the user does not have access to are not returned.`}),_jsxs(Expandable,{title:`Custom field entry`,children:[_jsx(ResponseField,{name:`id`,type:`number`,required:true,id:`param-id-4`,children:`Custom field identifier.`}),_jsxs(ResponseField,{name:`name`,type:`string`,required:true,id:`param-name-2`,children:[`Custom field name (e.g., `,_jsx(_components.code,{children:`\"Customer Tier\"`}),`).`]}),_jsx(ResponseField,{name:`type`,type:`string`,required:true,id:`param-type`,children:_jsxs(_components.p,{children:[`Field type. One of `,_jsx(_components.code,{children:`text`}),`, `,_jsx(_components.code,{children:`number`}),`, `,_jsx(_components.code,{children:`date`}),`, `,_jsx(_components.code,{children:`checkbox`}),`, `,_jsx(_components.code,{children:`rating`}),`, `,_jsx(_components.code,{children:`dropdown`}),`, `,_jsx(_components.code,{children:`money`}),`, or `,_jsx(_components.code,{children:`people`}),`.`]})}),_jsxs(ResponseField,{name:`config`,type:`object | null`,id:`param-config`,children:[_jsx(_components.p,{children:`Type-specific configuration.`}),_jsx(_components.p,{children:`For example:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`rating`}),` fields include `,_jsx(_components.code,{children:`icon`}),` and `,_jsx(_components.code,{children:`color`}),`;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`dropdown`}),` fields include an `,_jsx(_components.code,{children:`options`}),` array of strings;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`money`}),` fields include `,_jsx(_components.code,{children:`currency`}),` and `,_jsx(_components.code,{children:`decimals`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[`It’s `,_jsx(_components.code,{children:`null`}),` for field types with no configuration (which are `,_jsx(_components.code,{children:`text`}),`, `,_jsx(_components.code,{children:`number`}),`, `,_jsx(_components.code,{children:`date`}),`, `,_jsx(_components.code,{children:`checkbox`}),` and `,_jsx(_components.code,{children:`people`}),`).`]})]}),_jsx(ResponseField,{name:`position`,type:`number`,required:true,id:`param-position`,children:`Sort position of the field within the workspace.`}),_jsx(ResponseField,{name:`value`,type:`string | null`,id:`param-value`,children:_jsxs(_components.p,{children:[`The task’s value for this field. `,_jsx(_components.code,{children:`null`}),` when no value has been set.`]})})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update task","api":"PATCH /api/v1/tasks/{id}","description":"Updates one or more fields of a task. Only the fields you include are changed.","href":"/api-reference/tasks/update"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Info,ParamField,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[`Requires the `,_jsx(_components.code,{children:`tasks:write`}),` scope. Viewers cannot edit tasks. Access-restricted\nmembers receive `,_jsx(_components.code,{children:`403`}),` if the task belongs to, or is being moved to, a list\noutside their permitted scope.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path parameters`}),`\n`,_jsx(ParamField,{path:`id`,type:`string`,required:true,id:`param-id`,children:_jsx(_components.p,{children:`The numeric task ID.`})}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request body`}),`\n`,_jsx(_components.p,{children:`All fields are optional. Send only the fields you want to update.`}),`\n`,_jsx(ParamField,{body:`title`,type:`string`,id:`param-title`,children:_jsx(_components.p,{children:`New task title. Cannot be set to an empty string.`})}),`\n`,_jsx(ParamField,{body:`description`,type:`string`,id:`param-description`,children:_jsx(_components.p,{children:`Task description as an HTML string.`})}),`\n`,_jsx(ParamField,{body:`priority`,type:`string`,id:`param-priority`,children:_jsxs(_components.p,{children:[`Task priority. Must be one of `,_jsx(_components.code,{children:`urgent`}),`, `,_jsx(_components.code,{children:`high`}),`, `,_jsx(_components.code,{children:`medium`}),`, `,_jsx(_components.code,{children:`low`}),`, or `,_jsx(_components.code,{children:`none`}),`.`]})}),`\n`,_jsx(ParamField,{body:`status_id`,type:`string`,id:`param-status-id`,children:_jsx(_components.p,{children:`Numeric ID of a workspace status to apply. The status must belong to the same\nworkspace.`})}),`\n`,_jsx(ParamField,{body:`list_id`,type:`string`,id:`param-list-id`,children:_jsx(_components.p,{children:`Numeric ID of a list to move the task into. The list must belong to the same\nworkspace.`})}),`\n`,_jsx(ParamField,{body:`due_date`,type:`string | null`,id:`param-due-date`,children:_jsxs(_components.p,{children:[`Due date in ISO 8601 UTC format (e.g., `,_jsx(_components.code,{children:`\"2026-03-30T17:00:00Z\"`}),`). Pass `,_jsx(_components.code,{children:`null`}),` or an empty string to remove the due date.`]})}),`\n`,_jsx(ParamField,{body:`start_date`,type:`string | null`,id:`param-start-date`,children:_jsxs(_components.p,{children:[`Start date in ISO 8601 UTC format. Pass `,_jsx(_components.code,{children:`null`}),` or an empty string to remove the start date.`]})}),`\n`,_jsx(ParamField,{body:`assignee_ids`,type:`array`,id:`param-assignee-ids`,children:_jsx(_components.p,{children:`Array of numeric user IDs to assign to the task. Replaces the current\nassignees entirely. Pass an empty array to remove all assignees. Omit this\nfield to leave the current assignees unchanged. All IDs must be members of the\nsame workspace; non-member IDs are silently ignored.`})}),`\n`,_jsxs(ParamField,{body:`custom_fields`,type:`array`,id:`param-custom-fields`,children:[_jsxs(_components.p,{children:[`Optional array of custom field values to update. Each entry must contain a numeric `,_jsx(_components.code,{children:`id`}),` and a string `,_jsx(_components.code,{children:`value`}),` (or `,_jsx(_components.code,{children:`null`}),` to clear that field’s value). Omitting this field entirely leaves all custom field values unchanged. Only fields that apply to the task’s list and are visible to the API key user are processed; other fields are silently ignored.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"custom_fields\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Starter\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(_components.p,{children:`Returns the full updated task including its current assignees.`}),`\n`,_jsx(ResponseField,{name:`id`,type:`number`,required:true,id:`param-id-1`,children:_jsx(_components.p,{children:`Task identifier.`})}),`\n`,_jsx(ResponseField,{name:`workspace_id`,type:`number`,required:true,id:`param-workspace-id`,children:_jsx(_components.p,{children:`Workspace this task belongs to.`})}),`\n`,_jsx(ResponseField,{name:`list_id`,type:`number | null`,id:`param-list-id-1`,children:_jsx(_components.p,{children:`List this task belongs to.`})}),`\n`,_jsx(ResponseField,{name:`title`,type:`string`,required:true,id:`param-title-1`,children:_jsx(_components.p,{children:`Task title.`})}),`\n`,_jsx(ResponseField,{name:`description`,type:`string | null`,id:`param-description-1`,children:_jsx(_components.p,{children:`Task description.`})}),`\n`,_jsx(ResponseField,{name:`priority`,type:`string`,required:true,id:`param-priority-1`,children:_jsx(_components.p,{children:`Task priority.`})}),`\n`,_jsx(ResponseField,{name:`identifier`,type:`number`,required:true,id:`param-identifier`,children:_jsx(_components.p,{children:`Workspace-scoped sequential task number.`})}),`\n`,_jsx(ResponseField,{name:`due_date`,type:`string | null`,id:`param-due-date-1`,children:_jsx(_components.p,{children:`UTC ISO-8601 due date.`})}),`\n`,_jsx(ResponseField,{name:`start_date`,type:`string | null`,id:`param-start-date-1`,children:_jsx(_components.p,{children:`UTC ISO-8601 start date.`})}),`\n`,_jsx(ResponseField,{name:`creator_id`,type:`number`,required:true,id:`param-creator-id`,children:_jsx(_components.p,{children:`User ID of the task creator.`})}),`\n`,_jsx(ResponseField,{name:`created_at`,type:`string`,required:true,id:`param-created-at`,children:_jsx(_components.p,{children:`UTC ISO-8601 creation timestamp.`})}),`\n`,_jsxs(ResponseField,{name:`status`,type:`object | null`,id:`param-status`,children:[_jsx(_components.p,{children:`Current task status.`}),_jsxs(Expandable,{title:`Status fields`,children:[_jsx(ResponseField,{name:`id`,type:`number`,required:true,id:`param-id-2`,children:`Status identifier.`}),_jsx(ResponseField,{name:`name`,type:`string`,required:true,id:`param-name`,children:`Status label.`}),_jsx(ResponseField,{name:`icon`,type:`string | null`,id:`param-icon`,children:`Icon.`}),_jsx(ResponseField,{name:`color`,type:`string | null`,id:`param-color`,children:`Color.`}),_jsxs(ResponseField,{name:`category`,type:`string`,required:true,id:`param-category`,children:[`One of `,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`in_progress`}),`, `,_jsx(_components.code,{children:`completed`}),`, or `,_jsx(_components.code,{children:`cancelled`}),`.`]})]})]}),`\n`,_jsxs(ResponseField,{name:`assignees`,type:`array`,required:true,id:`param-assignees`,children:[_jsx(_components.p,{children:`Current assignees. Empty array if unassigned.`}),_jsxs(Expandable,{title:`Assignee fields`,children:[_jsx(ResponseField,{name:`id`,type:`number`,required:true,id:`param-id-3`,children:`User ID.`}),_jsx(ResponseField,{name:`name`,type:`string`,required:true,id:`param-name-1`,children:`Display name.`}),_jsx(ResponseField,{name:`avatar_url`,type:`string | null`,id:`param-avatar-url`,children:`Profile picture URL.`})]})]}),`\n`,_jsxs(ResponseField,{name:`custom_fields`,type:`array`,required:true,id:`param-custom-fields-1`,children:[_jsx(_components.p,{children:`Custom fields that apply to the task’s list, each with its current value after the update.\nFields the user does not have access to are not returned.`}),_jsxs(Expandable,{title:`Custom field entry`,children:[_jsx(ResponseField,{name:`id`,type:`number`,required:true,id:`param-id-4`,children:`Custom field identifier.`}),_jsxs(ResponseField,{name:`name`,type:`string`,required:true,id:`param-name-2`,children:[`Custom field name (e.g., `,_jsx(_components.code,{children:`\"Customer Tier\"`}),`).`]}),_jsx(ResponseField,{name:`type`,type:`string`,required:true,id:`param-type`,children:_jsxs(_components.p,{children:[`Field type. One of `,_jsx(_components.code,{children:`text`}),`, `,_jsx(_components.code,{children:`number`}),`, `,_jsx(_components.code,{children:`date`}),`, `,_jsx(_components.code,{children:`checkbox`}),`, `,_jsx(_components.code,{children:`rating`}),`, `,_jsx(_components.code,{children:`dropdown`}),`, `,_jsx(_components.code,{children:`money`}),`, or `,_jsx(_components.code,{children:`people`}),`.`]})}),_jsxs(ResponseField,{name:`config`,type:`object | null`,id:`param-config`,children:[_jsx(_components.p,{children:`Type-specific configuration.`}),_jsx(_components.p,{children:`For example:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`rating`}),` fields include `,_jsx(_components.code,{children:`icon`}),` and `,_jsx(_components.code,{children:`color`}),`;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`dropdown`}),` fields include an `,_jsx(_components.code,{children:`options`}),` array of strings;`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`money`}),` fields include `,_jsx(_components.code,{children:`currency`}),` and `,_jsx(_components.code,{children:`decimals`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[`It’s `,_jsx(_components.code,{children:`null`}),` for field types with no configuration (which are `,_jsx(_components.code,{children:`text`}),`, `,_jsx(_components.code,{children:`number`}),`, `,_jsx(_components.code,{children:`date`}),`, `,_jsx(_components.code,{children:`checkbox`}),` and `,_jsx(_components.code,{children:`people`}),`).`]})]}),_jsx(ResponseField,{name:`position`,type:`number`,required:true,id:`param-position`,children:`Sort position of the field within the workspace.`}),_jsx(ResponseField,{name:`value`,type:`string | null`,id:`param-value`,children:_jsxs(_components.p,{children:[`The task’s value for this field. `,_jsx(_components.code,{children:`null`}),` when no value has been set.`]})})]})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200`,numberOfLines:`37`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`37`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`110`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"workspace_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"list_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`20`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Write unit tests\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cp>Cover all service layer methods.\u003c/p>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"priority\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"urgent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"identifier\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`14`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"due_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-03-22T09:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"start_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"creator_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-03-18T18:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"To Do\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"icon\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"todo\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"color\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"gray\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"category\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pending\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"assignees\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`7`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Alice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"avatar_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"custom_fields\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Customer Tier\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"dropdown\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"config\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"options\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Free\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Starter\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Pro\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`] },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"position\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Starter\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`400`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Invalid priority. Must be one of: urgent, high, medium, low, none\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`401`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Invalid API key\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`403`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Scope 'tasks:write' is required for this endpoint\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`404`,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Task not found\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update task","api":"PATCH /api/v1/tasks/{id}","description":"Updates one or more fields of a task. Only the fields you include are changed.","href":"/api-reference/tasks/update"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Path parameters","slug":"path-parameters","depth":2,"children":[]},{"title":"Request body","slug":"request-body","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"37\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">110\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"workspace_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">3\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"list_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">20\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"title\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Write unit tests\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"description\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u0026#x3C;p>Cover all service layer methods.\u0026#x3C;/p>\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"priority\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"urgent\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"identifier\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">14\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"due_date\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-03-22T09:00:00.000Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"start_date\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"creator_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"created_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-03-18T18:00:00.000Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"To Do\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"icon\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"todo\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"color\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"gray\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"category\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"pending\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"assignees\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">7\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Alice\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"avatar_url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"custom_fields\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Customer Tier\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"dropdown\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"config\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"options\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Free\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Starter\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Pro\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">] },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"position\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"value\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Starter\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"400","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Invalid priority. Must be one of: urgent, high, medium, low, none\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"401","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Invalid API key\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"403","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Scope 'tasks:write' is required for this endpoint\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"404","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"3\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Task not found\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Update task","path":"/api/v1/tasks/{id}","servers":[{"url":"https://api.getarca.app"}],"method":"patch","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{"id":{"schema":[{"type":"string","description":"The numeric task ID.","required":true}]}}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"title":[{"type":"string","description":"New task title. Cannot be set to an empty string."}],"description":[{"type":"string","description":"Task description as an HTML string."}],"priority":[{"type":"string","description":"Task priority. Must be one of `urgent` , `high` , `medium` , `low` , or `none` ."}],"status_id":[{"type":"string","description":"Numeric ID of a workspace status to apply. The status must belong to the same workspace."}],"list_id":[{"type":"string","description":"Numeric ID of a list to move the task into. The list must belong to the same workspace."}],"due_date":[{"type":"object","properties":{},"description":"Due date in ISO 8601 UTC format (e.g., `\"2026-03-30T17:00:00Z\"` ). Pass `null` or an empty string to remove the due date."}],"start_date":[{"type":"object","properties":{},"description":"Start date in ISO 8601 UTC format. Pass `null` or an empty string to remove the start date."}],"assignee_ids":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Array of numeric user IDs to assign to the task. Replaces the current assignees entirely. Pass an empty array to remove all assignees. Omit this field to leave the current assignees unchanged. All IDs must be members of the same workspace; non-member IDs are silently ignored."}],"custom_fields":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Optional array of custom field values to update. Each entry must contain a numeric `id` and a string `value` (or `null` to clear that field’s value). Omitting this field entirely leaves all custom field values unchanged. Only fields that apply to the task’s list and are visible to the API key user are processed; other fields are silently ignored."}]}}],"examples":{"example":{"value":{"title":"\u003cstring>","description":"\u003cstring>","priority":"\u003cstring>","status_id":"\u003cstring>","list_id":"\u003cstring>","due_date":{},"start_date":{},"assignee_ids":[{}],"custom_fields":[{}]}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"id":[{"type":"number","description":"Task identifier.","required":true}],"workspace_id":[{"type":"number","description":"Workspace this task belongs to.","required":true}],"list_id":[{"type":"object","properties":{},"description":"List this task belongs to."}],"title":[{"type":"string","description":"Task title.","required":true}],"description":[{"type":"object","properties":{},"description":"Task description."}],"priority":[{"type":"string","description":"Task priority.","required":true}],"identifier":[{"type":"number","description":"Workspace-scoped sequential task number.","required":true}],"due_date":[{"type":"object","properties":{},"description":"UTC ISO-8601 due date."}],"start_date":[{"type":"object","properties":{},"description":"UTC ISO-8601 start date."}],"creator_id":[{"type":"number","description":"User ID of the task creator.","required":true}],"created_at":[{"type":"string","description":"UTC ISO-8601 creation timestamp.","required":true}],"status":[{"type":"object","properties":{"id":[{"type":"number","description":"Status identifier.","required":true}],"name":[{"type":"string","description":"Status label.","required":true}],"icon":[{"type":"object","properties":{},"description":"Icon."}],"color":[{"type":"object","properties":{},"description":"Color."}],"category":[{"type":"string","description":"One of `pending` , `in_progress` , `completed` , or `cancelled` .","required":true}]},"description":"Current task status."}],"assignees":[{"type":"array","items":[{"type":"object","properties":{"id":[{"type":"number","description":"User ID.","required":true}],"name":[{"type":"string","description":"Display name.","required":true}],"avatar_url":[{"type":"object","properties":{},"description":"Profile picture URL."}]}}],"description":"Current assignees. Empty array if unassigned.","required":true}],"custom_fields":[{"type":"array","items":[{"type":"object","properties":{"id":[{"type":"number","description":"Custom field identifier.","required":true}],"name":[{"type":"string","description":"Custom field name (e.g., `\"Customer Tier\"` ).","required":true}],"type":[{"type":"string","description":"Field type. One of `text` , `number` , `date` , `checkbox` , `rating` , `dropdown` , `money` , or `people` .","required":true}],"config":[{"type":"object","properties":{},"description":"Type-specific configuration. For example: `rating` fields include `icon` and `color` ; `dropdown` fields include an `options` array of strings; `money` fields include `currency` and `decimals` . It’s `null` for field types with no configuration (which are `text` , `number` , `date` , `checkbox` and `people` )."}],"position":[{"type":"number","description":"Sort position of the field within the workspace.","required":true}],"value":[{"type":"object","properties":{},"description":"The task’s value for this field. `null` when no value has been set."}]}}],"description":"Custom fields that apply to the task’s list, each with its current value after the update. Fields the user does not have access to are not returned.","required":true}]}}],"examples":{"example":{"value":{"id":123,"workspace_id":123,"list_id":{},"title":"\u003cstring>","description":{},"priority":"\u003cstring>","identifier":123,"due_date":{},"start_date":{},"creator_id":123,"created_at":"\u003cstring>","status":{"id":123,"name":"\u003cstring>","icon":{},"color":{},"category":"\u003cstring>"},"assignees":[{"id":123,"name":"\u003cstring>","avatar_url":{}}],"custom_fields":[{"id":123,"name":"\u003cstring>","type":"\u003cstring>","config":{},"position":123,"value":{}}]}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"arca-8f4cdaaf","siteName":"Arca Documentation","title":"Update task - Arca Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-05T20:45:23.097Z","originalFileLocation":"api-reference/tasks/update.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;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=\"system\"}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 of a task. Only the fields you include are changed.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Arca Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/arca-8f4cdaaf/Qzscc4kEYgLv-77g/_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/arca-8f4cdaaf/Qzscc4kEYgLv-77g/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/arca-8f4cdaaf/Qzscc4kEYgLv-77g/_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/arca-8f4cdaaf/Qzscc4kEYgLv-77g/_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/arca-8f4cdaaf/Qzscc4kEYgLv-77g/_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/arca-8f4cdaaf/Qzscc4kEYgLv-77g/_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/arca-8f4cdaaf/Qzscc4kEYgLv-77g/_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/arca-8f4cdaaf/Qzscc4kEYgLv-77g/_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/arca-8f4cdaaf/Qzscc4kEYgLv-77g/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update task - Arca Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Updates one or more fields of a task. Only the fields you include are changed.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Arca Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getarca.app/api-reference/tasks/update\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://arca-8f4cdaaf.mintlify.site/_mintlify/api/og/v2?division=Tasks\u0026amp;title=Update+task\u0026amp;description=Updates+one+or+more+fields+of+a+task.+Only+the+fields+you+include+are+changed.\u0026amp;theme=bdbeccab4109ea00ec17c251\u0026amp;signature=71aec3d4e085dad5d05ea6651397043f2f479b5927be6da0ce706d8fd1f6e450\">\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 - Arca Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Updates one or more fields of a task. Only the fields you include are changed.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://arca-8f4cdaaf.mintlify.site/_mintlify/api/og/v2?division=Tasks\u0026amp;title=Update+task\u0026amp;description=Updates+one+or+more+fields+of+a+task.+Only+the+fields+you+include+are+changed.\u0026amp;theme=bdbeccab4109ea00ec17c251\u0026amp;signature=71aec3d4e085dad5d05ea6651397043f2f479b5927be6da0ce706d8fd1f6e450\">\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/arca-8f4cdaaf/Qzscc4kEYgLv-77g/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Arca Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3A72F2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getarca.app/api-reference/tasks/update\">\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.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.getarca.app/#organization\",\"name\":\"Arca Documentation\",\"url\":\"https://docs.getarca.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/arca-8f4cdaaf/LBZ6XQwOq9jaxx8a/logo/light.svg?fit=max\u0026auto=format\u0026n=LBZ6XQwOq9jaxx8a\u0026q=85\u0026s=ad9c52e4c7e2b71cc11fe3cf92c54ef1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getarca.app#website\",\"name\":\"Arca Documentation\",\"url\":\"https://docs.getarca.app\",\"publisher\":{\"@id\":\"https://docs.getarca.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getarca.app/api-reference/tasks/update#webpage\",\"url\":\"https://docs.getarca.app/api-reference/tasks/update\",\"name\":\"Update task\",\"description\":\"Updates one or more fields of a task. Only the fields you include are changed.\",\"dateModified\":\"2026-06-05T20:45:23.097Z\",\"isPartOf\":{\"@id\":\"https://docs.getarca.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getarca.app/api-reference/tasks/update#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getarca.app/api-reference/tasks/update#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tasks\",\"item\":\"https://docs.getarca.app/api-reference/tasks/list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update task\",\"item\":\"https://docs.getarca.app/api-reference/tasks/update\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.getarca.app/api-reference/tasks/update#apireference\",\"headline\":\"Update task\",\"name\":\"Update task\",\"description\":\"Updates one or more fields of a task. Only the fields you include are changed.\",\"url\":\"https://docs.getarca.app/api-reference/tasks/update\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getarca.app/api-reference/tasks/update#webpage\"},\"dateModified\":\"2026-06-05T20:45:23.097Z\",\"publisher\":{\"@id\":\"https://docs.getarca.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getarca.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Arca Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Arca Documentation","nav":{"global":{"anchors":[{"anchor":"Arca Website","icon":"globe","href":"https://getarca.app/"},{"anchor":"Download Arca","icon":"download","href":"https://getarca.app/download"}]},"tabs":[{"tab":"Knowledge base","pages":[{"title":"Knowledge base","href":"/getting-started/introduction"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/introduction"}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","icon":"circle-info","href":"/api-reference/introduction"},{"title":"Authentication","icon":"key","href":"/api-reference/authentication"},{"title":"Rate limits","icon":"gauge","href":"/api-reference/rate-limits"},{"title":"Errors","icon":"triangle-exclamation","href":"/api-reference/errors"}]},{"group":"User","pages":[{"title":"Get current user","api":"GET /api/v1/me","href":"/api-reference/user/me"}]},{"group":"Workspaces","pages":[{"title":"List workspaces","api":"GET /api/v1/workspaces","href":"/api-reference/workspaces/list"},{"title":"Get workspace","api":"GET /api/v1/workspaces/{id}","href":"/api-reference/workspaces/get"},{"title":"List workspace members","api":"GET /api/v1/workspaces/{id}/members","href":"/api-reference/workspaces/members"},{"title":"List custom fields","api":"GET /api/v1/workspaces/{id}/custom-fields","href":"/api-reference/workspaces/custom-fields"}]},{"group":"Folders","pages":[{"title":"List folders","api":"GET /api/v1/workspaces/{id}/folders","href":"/api-reference/folders/list"},{"title":"Create folder","api":"POST /api/v1/folders","href":"/api-reference/folders/create"},{"title":"Update folder","api":"PATCH /api/v1/folders/{id}","href":"/api-reference/folders/update"},{"title":"Delete folder","api":"DELETE /api/v1/folders/{id}","href":"/api-reference/folders/delete"}]},{"group":"Lists","pages":[{"title":"List lists","api":"GET /api/v1/workspaces/{id}/lists","href":"/api-reference/lists/list"},{"title":"Create list","api":"POST /api/v1/lists","href":"/api-reference/lists/create"},{"title":"Update list","api":"PATCH /api/v1/lists/{id}","href":"/api-reference/lists/update"},{"title":"Delete list","api":"DELETE /api/v1/lists/{id}","href":"/api-reference/lists/delete"}]},{"group":"Tasks","pages":[{"title":"List tasks","api":"GET /api/v1/workspaces/{id}/tasks","href":"/api-reference/tasks/list"},{"title":"Get task","api":"GET /api/v1/tasks/{id}","href":"/api-reference/tasks/get"},{"title":"Create task","api":"POST /api/v1/tasks","description":"Creates a new task in a workspace.","href":"/api-reference/tasks/create"},{"title":"Update task","api":"PATCH /api/v1/tasks/{id}","href":"/api-reference/tasks/update"},{"title":"Delete task","api":"DELETE /api/v1/tasks/{id}","description":"Permanently deletes a task.","href":"/api-reference/tasks/delete"}]},{"group":"Statuses","pages":[{"title":"List statuses","api":"GET /api/v1/workspaces/{id}/statuses","href":"/api-reference/statuses/list"},{"title":"Create status","api":"POST /api/v1/statuses","href":"/api-reference/statuses/create"},{"title":"Update status","api":"PATCH /api/v1/statuses/{id}","href":"/api-reference/statuses/update"},{"title":"Delete status","api":"DELETE /api/v1/statuses/{id}","href":"/api-reference/statuses/delete"}]},{"group":"Labels","pages":[{"title":"List labels","api":"GET /api/v1/workspaces/{id}/labels","href":"/api-reference/labels/list"},{"title":"Create label","api":"POST /api/v1/labels","href":"/api-reference/labels/create"},{"title":"Update label","api":"PATCH /api/v1/labels/{id}","href":"/api-reference/labels/update"},{"title":"Delete label","api":"DELETE /api/v1/labels/{id}","href":"/api-reference/labels/delete"}]},{"group":"Comments","pages":[{"title":"List comments","api":"GET /api/v1/tasks/{id}/comments","href":"/api-reference/comments/list"},{"title":"Create comment","api":"POST /api/v1/tasks/{id}/comments","href":"/api-reference/comments/create"}]}]}]},"basePath":"","title":"Update task - Arca Documentation","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","b0f84f53ff","2b790eda92"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-Dr40SSJq.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js"]}