Claim a human task

POST

/spaces/:spaceId/playbook-runs/:runId/tasks/:taskId/claim

POST

/spaces/:spaceId/playbook-runs/:runId/tasks/:taskId/claim

$ curl -X POST https://api.cloudraker.com/spaces/spaceId/playbook-runs/runId/tasks/taskId/claim \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

200Successful

1 {
2   "data": {
3     "id": "task-9f8b7c6d-1234-4e56-8a9b-0c1d2e3f4a5b",
4     "title": "Review Security Audit Report",
5     "status": "in_progress",
6     "summary": "Security audit report review in progress",
7     "completedAt": null,
8     "instructions": "Please review the attached security audit report and provide your feedback by end of day.",
9     "dependsOn": [
10       "task-7a6b5c4d-9876-4f32-8b1a-0d2e3f4a5b6c"
11     ],
12     "executor": "human",
13     "assignee": "[email protected]",
14     "claimedBy": "[email protected]",
15     "completedBy": null,
16     "note": null,
17     "fileIds": [
18       "file-123e4567-e89b-12d3-a456-426614174000"
19     ]
20   }
21 }

Marks a ready human task in_progress with the caller as claimant. Claiming is optional — anyone in the space may complete an unassigned task without claiming it. Authorization: space:contribute (org admins bypass); missing → 403. Errors: 409 task_claimed (someone else holds it), 409 task_resolved (already completed/skipped), 409 run_not_running, 422 not_human_task, 404 unknown task.

Marks a `ready` human task `in_progress` with the caller as claimant. Claiming is optional — anyone in the space may complete an unassigned task without claiming it. Authorization: `space:contribute` (org admins bypass); missing → 403. Errors: 409 `task_claimed` (someone else holds it), 409 `task_resolved` (already completed/skipped), 409 `run_not_running`, 422 `not_human_task`, 404 unknown task.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired

runIdstringRequired

taskIdstringRequired

Response

The updated task.

dataobject