Poll a held tool call

When a tool call returns decision: "hold", poll this endpoint with the approvalId until a human resolves it. The server long-polls (~8s per request), so polling is cheap. Authenticate with the SAME agent key that made the call; another agent's holds return an opaque 404.

get/api/v1/gateway/approvals/{approvalId}

Request

  • Base URL: https://app.axiorank.com
  • URL: https://app.axiorank.com/api/v1/gateway/approvals/{approvalId}
  • Auth: HTTP bearer

Path parameters

approvalIdstring uuid required

Response

The current approval state. decision stays hold while pending.

statusstring required

Approval state: pending while awaiting a human; approved/denied once resolved; expired on timeout.

decision'allow' | 'deny' | 'hold' required

hold while still pending; resolves to allow/deny.

reasonstring nullable
auditLogIdstring nullable
resolvedBystring nullable

Operator who resolved the hold, if any.

Changes

No recorded changes to this operation across all 1 revision of this API.