v1

latestOpenAPI 3.1.02026-07-2352630.4 KB
app-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

has_moreboolean required
next_cursorstring nullable