Execution

List executions

List executions with filtering and pagination

get/agents/v2/executions

Request

  • Base URL
    https://odyssey.asteroid.ai
  • URL
    https://odyssey.asteroid.ai/agents/v2/executions
  • Auth
    API key in header X-Api-Key

Query parameters

organizationIdstring uuid

Optional organization ID filter (required for customer queries)

pageSizeinteger
pageinteger
executionIdstring

Search by execution ID (partial, case-insensitive match)

agentIdstring uuid

Deprecated: use workflowId. Filter by workflow ID

agentProfileIdsCommonUuid[]

Deprecated: use profileIds. Filter by agent profile IDs

statusAgentsExecutionStatus[]

Filter by execution status (can specify multiple, there is an 'OR' condition applied to these)

createdAfterstring date-time
createdBeforestring date-time
humanLabelsCommonUuid[]

Filter by human labels (can specify multiple label IDs, there is an 'OR' condition applied to these)

outcomeLabelstring

Filter by execution result outcome (partial, case-insensitive match)

metadataKeystring

Filter by metadata key - must be used together with metadataValue

metadataValuestring

Filter by metadata value - must be used together with metadataKey

inputsKeystring

Filter by input variable key - must be used together with inputsValue

inputsValuestring

Filter by input variable value (partial, case-insensitive match) - must be used together with inputsKey

workflowVersioninteger
hasScriptFailuresboolean
triggerSourcestring[]

Filter by how the execution was triggered (can specify multiple, there is an 'OR' condition applied to these)

phaseAgentsExecutionPhase[]

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.

sortField'created_at' | 'status' | 'started_at'

Fields that can be used for sorting executions

sortDirection'asc' | 'desc'
workflowIdstring uuid
createdWithinstring

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

metadatastring[]

Filter by metadata key=value pairs. Repeat the parameter for several pairs; every pair must match

sortstring

Sort shorthand as field:direction, e.g. created_at:desc. Fields: created_at, status, started_at. Cannot be combined with sortField or sortDirection

profileIdsCommonUuid[]

Filter by login profile IDs (can specify multiple, there is an 'OR' condition applied to these)

batchIdstring uuid

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.

pageinteger required
pageSizeinteger required
totalinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.