Optionalparams: {Query parameters.
OptionalafterCursor?: stringOpaque cursor from a previous response's after_cursor field. Returns the page of runs newer than that cursor position.
Optionalagent?: string[]Filter by one or more agent IDs (agi_...) or lookup_key values. Repeat the parameter (e.g. ?agent[]=agi_a&agent[]=agi_b) to OR multiple agents. Omit to return runs for all agents.
OptionalbeforeCursor?: stringOpaque cursor from a previous response's before_cursor field. Returns the page of runs older than that cursor position.
Optionallimit?: numberMaximum number of runs to return. Defaults to 50; maximum is 100.
Optionalstatus?: stringFilter by run status. One of "pending", "running", "completed", "failed", "skipped", or "cancelled". Omit to return runs in any status.
Paginated list of agent routine runs.
Stream agent routine run status
Opens a long-lived Server-Sent Events connection that emits a run_update
event whenever the routine run's status changes, replaying the current status
immediately on connect. The stream closes when the run reaches a terminal
status (completed, failed, skipped, cancelled) or the maximum stream
duration elapses (a terminal error event with stream_timeout is sent).
Keepalive comments are emitted on an interval to hold the connection open.
ID of the agent routine run to stream status updates for.
Server-Sent Events stream
List agent routine runs Returns a paginated list of agent routine runs across all routines visible to the authenticated app scope. Results are ordered by creation time descending (most recent first). Use the
agentparameter to filter runs to one or more specific agents. Usestatusto narrow results to runs in a particular state. Pagination is bidirectional: supplyafter_cursorto page forward through newer runs orbefore_cursorto page backward through older runs. This endpoint requires an app scope. Requests without a valid app credential return 403.