Skip to content
Farcaster

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>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “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

Section titled “Responses”

200

Section titled “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

Section titled “401”

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

404

Section titled “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
Examplegenerated
{
  "error": "example"
}

500

Section titled “500”

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