API reference
Pause a harness to stop new tasks, or retire it by deleting it.
A paused harness refuses new tasks until you resume it; a deleted harness's tasks can be restored with it for 30 days.
Pause and resume
- While paused, a new task for the harness answers 409 with
harness_paused. - An AI member of your organization can pause a harness but never resume it, so resuming is always a person's decision.
PUT /v1/harnesses/{id}/pause pause
DELETE /v1/harnesses/{id}/pause resumeRetire
Deleting a harness retires its tasks with it: they leave every list and read at once. Support can restore them with the harness for 30 days, until restorableUntil in the delete's answer, in Unix seconds.
- HarnessesDeleting a configured agent.
- Deletion and retentionWhat each delete keeps, and for how long.
Ready to run this against a live workspace?Create API key