Run an agent, paid per run via x402

The agent reasons, calls its tools when it needs them, and answers. Price is quoted against the worst case: every step it is allowed to take, at its full token ceiling. Send without payment to receive the exact amount in the 402.

post/v1/agents/{id}/run

Request

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

Path parameters

idstring uuid required

Agent id. The example is a live demo agent you can call as-is.

Request body

inputstring required

The task for the agent

Response

The run finished. Check status: a failed run still returns 200 because payment was taken and work was done.

idstring

Run id

objectstring
agent_idstring
request_idstring
status'succeeded' | 'failed' | 'max_steps'
outputstring nullable

Example response

{
  "object": "agent.run"
}

Changes

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