SIsimplified
tasks

PM · Tasks · Update task fields; supports inline assignee/tag diffs and status moves

Partial update for a task. All fields optional. To move the task to a different status (column), pass status with the destination status UUID. Composite fields assignees_add/assignees_remove and tags_add/tags_remove are handled by the middleware — they trigger sub-resource calls automatically. description is converted to a Quill Delta (rich_description) by the toolkit.

patch/api/v1/pm/tasks/{task_id}

Request

  • Base URL
    https://api.simplified.com
  • Auth
    API key in header Authorization

Path parameters

task_idstring required

Task UUID or slug.

Headers

Organizationstring

Workspace (organization) ID the request is scoped to.

Spacestring

Optional sub-space ID for further scoping inside the workspace.

Request body

titlestring
descriptionstring

Plain text task description. This is the field agents and CLI users should set. The toolkit converts it to a Quill Delta and writes rich_description automatically.

rich_descriptionobject

INTERNAL — Quill Delta representation. Set automatically by the toolkit when you pass description. Do not pass directly unless you have a pre-built Delta and know what you're doing.

statusstring uuid

Move task to a new status (on the same or different board).

start_datestring date-time nullable
due_datestring date-time nullable
priorityinteger
completeboolean

Marking a task complete is rejected if the task has incomplete blockers or a running timer.

estimated_hoursnumber double nullable
orderinteger

Pass to reposition the task inside its status.

extraobject
custom_fieldsobject
assignees_addinteger[]

Integer user IDs to add as assignees (get from listWorkspaceMembers). Toolkit calls POST /tasks/{id}/assignees/ with {"add": [...]} after the PATCH.

assignees_removeinteger[]

Integer user IDs to remove from assignees (get from listWorkspaceMembers). Toolkit calls POST /tasks/{id}/assignees/ with {"remove": [...]} after the PATCH.

tags_addstring[]

Composite field — tag names to add. Toolkit calls POST /tasks/{id}/tags/ with {"add": [...]} after the PATCH.

tags_removestring[]

Composite field — tag names to remove. Toolkit calls POST /tasks/{id}/tags/ with {"remove": [...]} after the PATCH.

Response

Task updated.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.