← All primitives

Durable Workbox

implemented P0 /v1/work

Why it matters: Lets producers enqueue durable agent work and workers safely claim, complete, or retry it without losing lifecycle state.

Durable, account-scoped work items with leased execution, bounded retries, and artifact-backed outcomes.

GitHub issue →

API endpoints

MethodPathDescription
POST/v1/workCreate durable work
GET/v1/workList account work
POST/v1/work/claimClaim pending work with a lease
POST/v1/work/:id/completeComplete leased work
POST/v1/work/:id/failFail or retry leased work

Examples

Create durable work

curl -X POST https://cloudharness.ai/v1/work \
  -H "Authorization: Bearer <CLOUDHARNESS_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"type":"document.process","payload":{"artifactRef":"art_input"},"idempotencyKey":"document-123"}'