ExecLog API

Query execution history

GET /v1/execlog

ExecLog API

cURL

curl --request GET \
  --url https://api.example.com/v1/execlog

Request

GET /v1/execlog?agent={name}&limit={n}&state={state}

Query Parameters

Parameter	Type	Description
agent	string	Filter by agent name
limit	int	Max results (default: 50)
state	string	Filter: completed, failed, crashed

cURL Example

# All executions for an agent
curl "http://localhost:7777/v1/execlog?agent=my-agent&limit=10"

# Only failed
curl "http://localhost:7777/v1/execlog?agent=my-agent&state=failed"

Response

{
  "executions": [
    {
      "request_id": "abc-123",
      "agent_name": "my-agent",
      "worker_id": "my-agent-worker-1",
      "session_id": "user-456",
      "state": "completed",
      "started_at": "2026-01-19T10:15:00Z",
      "completed_at": "2026-01-19T10:15:02Z",
      "duration_ms": 2000,
      "error": null
    }
  ],
  "total": 1
}

States

State	Description
queued	Waiting for worker
started	Currently executing
completed	Finished successfully
failed	Handler returned error
crashed	Daemon died mid-execution

CLI Equivalent

# List recent runs
orpheus runs my-agent -n 10

# Filter by state
orpheus runs my-agent --state failed

Back to API

← API Overview