Skip to content
POST /v1/agents/{id}/execute

Execute an agent

Runs the agent against an input and returns its output plus the sources it used.

Runs the agent against an input and returns its output plus the sources it used.

Headers
Authorization Bearer nx_live_…
Content-Type application/json
Idempotency-Key <uuid>
Request body
{
  "input": "Compare CAC across NA and EU for Q3",
  "context": { "dataSource": "warehouse://prod/sales" },
  "stream": false
}
Response
{
  "id": "run_2p91",
  "status": "succeeded",
  "output": "…",
  "citations": [
    { "source": "warehouse://prod/sales", "rows": 1420000 }
  ],
  "usage": { "input_tokens": 1180, "output_tokens": 640 }
}