cURL
curl --request POST \ --url https://api.example.com/v1/agents/{name}/run
Execute an agent
POST /v1/agents/{name}/run Content-Type: application/json { "input": { "query": "Your input here" } }
Content-Type
application/json
X-Session-ID
Accept
text/event-stream
curl -X POST http://localhost:7777/v1/agents/my-agent/run \ -H "Content-Type: application/json" \ -d '{"input": {"query": "hello"}}'
curl -X POST http://localhost:7777/v1/agents/my-agent/run \ -H "Content-Type: application/json" \ -H "X-Session-ID: user-123" \ -d '{"input": {"query": "hello"}}'
{ "request_id": "abc-123-def", "result": { "response": "Hello!", "status": "success" }, "duration_ms": 45, "worker_id": "my-agent-worker-1" }
{ "request_id": "abc-123-def", "error": "Handler raised exception", "duration_ms": 12 }
orpheus run my-agent '{"query": "hello"}' # With session orpheus run my-agent '{"query": "hello"}' --session user-123