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.
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.