Complete a human task

POST

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

POST

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

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

200Successful

1 {
2   "data": {
3     "id": "task-987654321",
4     "title": "Review Quarterly Budget Report",
5     "status": "completed",
6     "summary": "Budget report reviewed and approved with minor comments.",
7     "completedAt": "2024-01-15T09:30:00Z",
8     "instructions": "Please review the attached budget report and provide your approval or feedback by end of day.",
9     "dependsOn": [
10       "task-123456789"
11     ],
12     "executor": "human",
13     "assignee": "[email protected]",
14     "claimedBy": "[email protected]",
15     "completedBy": "[email protected]",
16     "note": "Reviewed the figures and confirmed accuracy. No major issues found.",
17     "fileIds": [
18       "file-abc123xyz"
19     ]
20   }
21 }

Completes a human task out-of-band, with an optional note and file references that flow into the agent’s context for the tasks that follow. Anyone in the space may complete an unassigned task; claiming first is optional. A second completion is a no-op. Authorization: space:contribute (org admins bypass). Errors: 409 task_blocked (gates not cleared), 409 run_not_running, 422 not_human_task, 404.

Completes a human task out-of-band, with an optional note and file references that flow into the agent’s context for the tasks that follow. Anyone in the space may complete an unassigned task; claiming first is optional. A second completion is a no-op. Authorization: `space:contribute` (org admins bypass). Errors: 409 `task_blocked` (gates not cleared), 409 `run_not_running`, 422 `not_human_task`, 404.

Authentication

AuthorizationBearer

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

Path parameters

spaceIdstringRequired

runIdstringRequired

taskIdstringRequired

Request

This endpoint expects an object.

notestringOptional<=2000 characters

fileIdslist of stringsOptional

Response

The completed task.

dataobject