Skip a human task

POST

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

POST

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

$ curl -X POST https://api.cloudraker.com/spaces/spaceId/playbook-runs/runId/tasks/taskId/skip \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "note": "Skipping this task due to dependency issues and to unblock subsequent steps."
> }'

200Successful

1 {
2   "data": {
3     "id": "task-98765",
4     "title": "Review Project Documentation",
5     "status": "skipped",
6     "summary": "Documentation review skipped to maintain project timeline.",
7     "completedAt": "2024-01-15T09:30:00Z",
8     "instructions": "Please review the latest project documentation and provide feedback.",
9     "dependsOn": [
10       "task-12345"
11     ],
12     "executor": "human",
13     "assignee": "[email protected]",
14     "claimedBy": "[email protected]",
15     "completedBy": "[email protected]",
16     "note": "Skipping this task due to dependency issues and to unblock subsequent steps.",
17     "fileIds": [
18       "file-abc123"
19     ]
20   }
21 }

Flags a human task as skipped (note required) and unblocks the work behind it exactly like a completion. Authorization: space:contribute (org admins bypass). Errors: 409 task_blocked, 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.

notestringRequired1-2000 characters

Response

The skipped task.

dataobject