agents

Read the delivery status of a command sent to the agent.

Returns the lifecycle status of a mailbox command (pending, claimed, sent, or failed with a failure code). Pass wait (ms, capped server-side) to hold the request open until the command reaches sent or failed; at the bound the current status is returned.

get/agents/{id}/commands/{commandId}

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/agents/{id}/commands/{commandId}
  • Auth: none declared. Required headers: x-organization-id

Path parameters

idstring required
commandIdstring required

Query parameters

waitinteger

Headers

x-organization-idstring required

Active organization id (or slug). Required for org-scoped operations; the generated client enforces it at compile time.

Response

Response

commandIdstring required
status'pending' | 'claimed' | 'sent' | 'failed' required

Changes

No recorded changes to this operation across all 50 revisions of this API.