mcpDeterministic

Release agent work order

tools/call

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.

Parameters

workspaceId

string

Optional with an API key, inferred from the key.

workOrderIdrequired

string

No description.

claimTokenrequired

string

Lease token returned by claim-agent-work-order.

Example

MCP tools/calljson

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "release-agent-work-order",
    "arguments": {
      "workOrderId": "00000000-0000-4000-8000-000000000000",
      "claimToken": "00000000-0000-4000-8000-000000000001"
    }
  }
}

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "released": {
      "type": "boolean"
    }
  },
  "required": [
    "released"
  ]
}

JSON-RPC errors

-32602: Invalid parameters. Field-level details are returned in the JSON-RPC error data.
-32001: Authentication or hosted AI consent is required.
-32003: Workspace access is denied.
-32029: The request was rate limited.