Skip to main content
GET
List Agent Runs
List all execution runs for a specific agent. Runs track the lifecycle of message processing including actions executed, evaluators run, and timing data.

Path Parameters

string
required
The UUID of the agent

Query Parameters

string
Filter by run status: started, completed, timeout, error, or all
string
Filter runs by room ID
number
default:"20"
Maximum number of runs to return (max: 100)
number
Return only runs started after this Unix timestamp
number
Return only runs started before this Unix timestamp

Headers

string
Optional entity ID for Row-Level Security (RLS) filtering

Response

array
Array of run summaries
number
Total number of runs matching the filter
boolean
Whether there are more runs available