Release work-item claim

Gives up a claim the caller holds, returning the work item to the claimable pool immediately rather than at lease expiry. Releasing a claim you do not hold is reported rather than silently ignored, because an agent that believes it released will not retry.

DELETE/api/v1/work-items/:id/claim

Authorization

work-items:assignapi key scoperequired

Required scope when calling with an API key.

Path parameters

idstringrequired

Canonical work-item ID

Example: work_01k2...

Request body

claim_ownerstringrequired

The same agent or session identifier that holds the lease

Example request

{
  "claim_owner": "agent-7f3c"
}

Request

DELETE /api/v1/work-items/:id/claim

curl -X DELETE "https://www.digitalstack360.com/api/v1/work-items/work_01k2.../claim" \
  -H "Authorization: Bearer $DS_API_KEY"

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": {
    "released": true,
    "id": "work_01k2..."
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks work-items:assign scope

400

invalid_request

claim_owner is missing or exceeds 200 characters

404

not_found

Work item does not exist or is outside the key account

409

claim_not_held

You do not hold a claim on this work item