List executions
List executions with filtering and pagination
Request
- Base URLhttps://odyssey.asteroid.ai
- URLhttps://odyssey.asteroid.ai/agents/v2/executions
- AuthAPI key in header X-Api-Key
Query parameters
Optional organization ID filter (required for customer queries)
Search by execution ID (partial, case-insensitive match)
Deprecated: use workflowId. Filter by workflow ID
Deprecated: use profileIds. Filter by agent profile IDs
Filter by execution status (can specify multiple, there is an 'OR' condition applied to these)
Filter by human labels (can specify multiple label IDs, there is an 'OR' condition applied to these)
Filter by execution result outcome (partial, case-insensitive match)
Filter by metadata key - must be used together with metadataValue
Filter by metadata value - must be used together with metadataKey
Filter by input variable key - must be used together with inputsValue
Filter by input variable value (partial, case-insensitive match) - must be used together with inputsKey
Filter by how the execution was triggered (can specify multiple, there is an 'OR' condition applied to these)
Filter by lifecycle phase, derived from status (can specify multiple, OR across values). Composes with the status filter as AND. pending = queued; active = starting, running, awaiting_confirmation, paused, paused_by_agent; terminal = completed, cancelled, failed.
Fields that can be used for sorting executions
A span of time: number-unit pairs with units w, d, h, m, longest first, each at most once, e.g. 30m, 24h, 7d, 2w, 1d12h. A day is 24 hours
Filter executions created within this long before now: number-unit pairs with units w, d, h, m, longest first, e.g. 30m, 24h, 7d, 1d12h. Maximum 10 years. Cannot be combined with createdAfter
Filter by metadata key=value pairs. Repeat the parameter for several pairs; every pair must match
Sort shorthand as field:direction, e.g. created_at:desc. Fields: created_at, status, started_at. Cannot be combined with sortField or sortDirection
Filter by login profile IDs (can specify multiple, there is an 'OR' condition applied to these)
Only executions started by this batch, an ID from execution_batches_list. Rows not yet triggered have no execution yet: list them with scheduled_executions_list and batchId.
Response
The request has succeeded.
Changes
No recorded changes to this operation across all 1 revision of this API.