Agents / REST API

Release agent work order

Release an external coding agent work-order lease without submitting an artifact. Use this when the agent cannot complete the task so another worker can claim it. This does not launch or send anything.

POST /api/agents/work-orders/external/releaseDeterministic operation

Parameters

workspaceIdOptional · string
Optional with an API key, inferred from the key.
workOrderIdRequired · string
See the input schema for this field.
claimTokenRequired · string
Lease token returned by claim-agent-work-order.
Request example
curl -X POST "https://app.pipeline.help/api/agents/work-orders/external/release" \
  -H "Authorization: Bearer $PIPELINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workOrderId":"00000000-0000-4000-8000-000000000000","claimToken":"00000000-0000-4000-8000-000000000001"}'
Full input schema
Input schema
{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "description": "Optional with an API key, inferred from the key."
    },
    "workOrderId": {
      "type": "string"
    },
    "claimToken": {
      "type": "string",
      "description": "Lease token returned by claim-agent-work-order."
    }
  },
  "required": [
    "workOrderId",
    "claimToken"
  ]
}
See this operation inCLI MCP TypeScript SDK
API reference | Pipeline v2 preview