List Runs

List agent execution runs with filtering options.

This endpoint returns a paginated list of agent execution runs with their current status and basic metadata. App runs are listed separately via GET /app-runs.

Filtering Options:

• status: Filter by execution status (in_progress, completed, failed, canceled)
• external_id: Filter to runs you tagged with this reference id at creation. Use this to check whether you already started a run for a given item before starting another.

Pagination Parameters:

• limit: Maximum number of items to return (default: 20, max: 100)
• cursor: Cursor for pagination (optional)

Response:

• data: List of run summaries with basic information
• has_more: Indicates if there are more results available
• next_cursor: Cursor for the next page of results

Use Case: Monitor multiple executions and their status overview.