Call an agent, paid via x402

Send the request envelope without payment to receive a 402 carrying the price, then sign and resend. A rejected call still returns 200 with the reason in the envelope status: a 4xx would tell x402 the handler crashed and settlement would be cancelled, leaving a payment with no record of what it bought.

post/v1/network/agents/{id}/execute

Request

  • Base URL: https://agents.dexl.io
  • URL: https://agents.dexl.io/v1/network/agents/{id}/execute
  • Auth: API key in header X-Payment

Path parameters

idstring required

Request body

protocol_versionstring required
request_idstring uuid required
trace_idstring uuid required
timestampstring date-time required
expirationstring date-time required
capabilitystring nullable
action'execute' | 'quote' | 'describe'
inputobject required

Example request

{
  "protocol_version": "1"
}

Response

Response envelope: completed, failed or rejected

Changes

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