v1
latestOpenAPI 3.1.02026-07-2352630.4 KBapp-runs
List App Runs
List app execution runs with filtering options.
This endpoint returns a paginated list of app execution runs with their current status and basic metadata. Agent runs are listed separately via GET /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 app-run summaries with basic information
- has_more: Indicates if there are more results available
- next_cursor: Cursor for the next page of results
get/app-runs/
Query parameters
status'in_progress' | 'completed' | 'failed' | 'canceled'
Execution status of a workflow run.
external_idstring nullable
limitinteger
Maximum number of items to return
Maximum number of items to return
cursorstring nullable
Cursor for pagination (from next_cursor)
Cursor for pagination (from next_cursor)
Headers
X-Organization-Idstring nullable
Active organization ID for multi-org support
Active organization ID for multi-org support
Response
Successful Response