v1

latestOpenAPI 3.0.32026-08-0425108247.7 KB

Tasks

Record a task update

Records a task update and optional task/resource changes.

post/tasks/{taskId}/updates

Path parameters

taskIdstring required

Task identifier.

Headers

Idempotency-Keystring

Idempotency key.

Idempotency key for safely retrying this write.

Request body

expected_state_versioninteger

Optimistic task state version expected by the caller.

Example request

{
  "resource_ops": [
    {
      "resource_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
    }
  ]
}

Response

Recorded task update.

Example response

{
  "changed_resources": [
    {
      "created_at": "2026-05-14T08:00:00.000Z",
      "id": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "task_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
      "updated_at": "2026-05-14T08:00:00.000Z",
      "workspace_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
    }
  ],
  "entry": {
    "created_at": "2026-05-14T08:00:00.000Z",
    "id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "task_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "updated_at": "2026-05-14T08:00:00.000Z",
    "workspace_id": "01jzn7e61x3a7v9h2r7t2m3q4p"
  },
  "task": {
    "created_at": "2026-05-14T08:00:00.000Z",
    "id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "last_activity_at": "2026-05-14T08:00:00.000Z",
    "updated_at": "2026-05-14T08:00:00.000Z"
  }
}