Poll a transactional invocation's status/result

GET

/v1/proxy/{id}/invocations/{inv_id}

curl --request GET \
  --url https://example.com/v1/proxy/example/invocations/example \
  --header 'Authorization: Bearer <token>'

• The gateway serves this contract at its own root; no fixed host is baked in (self-hostable).

Authorizations

• oidcBearer

Parameters

Path Parameters

id

required

string

The agt_<uuidv7> agent ID.

inv_id

required

string

The inv_<uuidv7> invocation ID returned by POST /v1/proxy/{id}.

Responses

200

The invocation’s current status and, once complete, its captured response body.

Media typeapplication/json

object

invocation_id

required

string

agent_id

required

string

status

required

string

Allowed values: pending running succeeded failed

created_at

required

string format: date-time

updated_at

required

string format: date-time

completed_at

required

string format: date-time

nullable

upstream_status

required

integer

nullable

latency_ms

required

integer format: int64

nullable

mcp_method

required

string

nullable

mcp_tool

required

string

nullable

payment_network

required

string

nullable

payment_asset

required

string

nullable

payment_amount

required

string

nullable

payment_payer

required

string

nullable

payment_nonce

required

string

nullable

response_body_b64

The captured upstream response body, base64-encoded. Present only when a response body was captured.

string format: byte

Example

{
  "status": "pending"
}

401

Missing or invalid bearer token, or the token’s tenant/user claims are absent. No body.

404

Not found, or the invocation does not belong to the agent in the path.

Media typeapplication/json

The uniform error body for all 4xx responses that carry one.

object

error

required

A coarse, caller-safe message. Never contains internal state (invariant

string

Example^generated

{
  "error": "example"
}

500

An unexpected server-side error. No body (internal detail is never returned to callers, invariant