--- title: "List executions" method: GET path: "/agents/v2/executions" tags: ["Execution"] --- # List executions `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` List executions with filtering and pagination ## Query parameters - `organizationId` string, uuid - `pageSize` integer - `page` integer - `executionId` string - `agentId` string, uuid - `agentProfileIds` CommonUuid[] - `status` AgentsExecutionStatus[] - `createdAfter` string, date-time - `createdBefore` string, date-time - `humanLabels` CommonUuid[] - `outcomeLabel` string - `metadataKey` string - `metadataValue` string - `inputsKey` string - `inputsValue` string - `workflowVersion` integer - `hasScriptFailures` boolean - `triggerSource` string[] - `phase` AgentsExecutionPhase[] - `sortField` 'created_at' | 'status' | 'started_at': Fields that can be used for sorting executions - `sortDirection` 'asc' | 'desc' - `workflowId` string, uuid - `createdWithin` string: 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 - `metadata` string[] - `sort` string - `profileIds` CommonUuid[] - `batchId` string, uuid ## Response `200` The request has succeeded. - object - `items` AgentsExecutionListItem[], required - `agentId` string, uuid, required - `agentName` string, required: Deprecated: use workflowName. The workflow display name - `agentProfileId` string, uuid - `agentProfileName` string: Deprecated: use profileName. The name of the agent profile used for this execution (if any) - `browserLiveViewUrl` string: Deprecated: Use 'liveViewUrl' instead. - `browserRecordingUrl` string: Deprecated: Use 'recordingUrl' instead. - `comments` AgentsExecutionComment[], required - `content` string, required - `createdAt` string, date-time, required - `executionId` string, uuid, required - `id` string, uuid, required - `public` boolean, required - `updatedAt` string, date-time - `userId` string, uuid, required - `createdAt` string, date-time, required - `customEnvironmentId` string, uuid - `duration` number, double: Execution duration in seconds (only present for terminal executions) - `executionOptions` AgentsAgentExecutionOptions: Per-execution runtime options. - `softTimeoutMins` integer: Soft timeout in minutes. When the execution has been running longer than this value, a message is injected on every subsequent step urging the agent to wrap up and produce output. Must be greater than 0 and less than the agent's hard timeout (max_timeout_mins). - `variantKey` string: Identifies which variant this execution is for, scoping its shared files and scripts to a per-variant subdirectory under each node's shared folder. It does not change which workflow or version runs. Normalised to a filesystem-safe slug by the server. Requires the workflow to have `variant_mode` enabled, and a variant-mode workflow requires it on every execution. - `executionResult` AgentsExecutionExecutionResult: Execution result containing outcome, reasoning, and result data - `createdAt` string, date-time, required - `executionId` string, uuid, required - `id` string, uuid, required - `outcome` string, required: Outcome of the execution (success or failure) - `reasoning` string, required - `result` unknown, required - `hasBeenRerun` boolean, required - `humanLabels` AgentsExecutionHumanLabel[], required - `color` string, required: Hex color code for the label (e.g., #FF5733) - `createdAt` string, date-time, required - `id` string, uuid, required - `name` string, required - `organizationId` string, uuid, required - `id` string, uuid, required - `inputs` object - `liveViewUrl` string: Live view URL for debugging (if an environment is active and execution is running) - `metadata` object - `organizationId` string, uuid, required - `parentExecutionId` string, uuid - `platformUrl` string: Deep link to this execution in the Asteroid platform UI - `profileId` string, uuid - `profileName` string - `purgedAt` string, date-time: When the retention purge removed this execution's data. Inputs, activities, files and recordings are gone; the row is a tombstone. - `recordingUrl` string: Recording URL for playback (if an environment was used and execution is terminal) - `scriptFailures` AgentsExecutionScriptFailure[]: Script failures recorded for this execution (omitted when none occurred) - `actionId` string: Identifier correlating this failure to its activity event - `error` string - `failedLine` integer: 1-based line number where the script failed, if known - `nodeId` string - `nodeName` string - `occurredAt` string, date-time, required - `scriptFilepath` string: Relative path of the script file that failed - `step` integer: Execution step (iteration) at which the failure occurred - `startedAt` string, date-time: When the execution actually started running; absent while queued. createdAt means "enqueued at" for executions that waited in the queue. - `status` 'queued' | 'starting' | 'running' | 'paused' | 'awaiting_confirmation' | 'completed' | 'cancelled' | 'failed' | 'paused_by_agent', required - `terminalAt` string, date-time - `triggerContext` union: Discriminated union of trigger contexts (discriminated by source) - object: API-triggered execution context - `actor` CommonActor: Who did something: a person, an API key or one of Asteroid's services. Absent on a record made before actors were stored, on one a system job made, and when the caller may not see who it was. - `client` 'web' | 'cli' | 'mcp' | 'astro' | 'sdk': The program a caller used - `id` string, required: The person's id, the key's id, or the service's name - `kind` 'person' | 'api_key' | 'service', required: The kind of caller that did something - `apiKey` AgentsExecutionAPIKeyRef: API key reference used for authentication - `id` string, uuid, required - `name` string, required - `runner` AgentsExecutionTriggerRunner, required: Runner information - who triggered the execution - `email` string, required - `isAdmin` boolean: Whether the user is an admin (may be hidden for privacy) - `userId` string, uuid, required - `source` 'api', required - object: UI-triggered execution context - `actor` CommonActor: Who did something: a person, an API key or one of Asteroid's services. Absent on a record made before actors were stored, on one a system job made, and when the caller may not see who it was. - `client` 'web' | 'cli' | 'mcp' | 'astro' | 'sdk': The program a caller used - `id` string, required: The person's id, the key's id, or the service's name - `kind` 'person' | 'api_key' | 'service', required: The kind of caller that did something - `runner` AgentsExecutionTriggerRunner, required: Runner information - who triggered the execution - `email` string, required - `isAdmin` boolean: Whether the user is an admin (may be hidden for privacy) - `userId` string, uuid, required - `source` 'ui', required - object: Schedule-triggered execution context - `schedule` AgentsExecutionScheduleRef, required: Schedule reference for schedule-triggered executions - `cronExpression` string, required: Cron expression of the schedule - `id` string, uuid, required - `source` 'schedule', required - object: Warmup-triggered execution context: launched by a warm pool's replenisher - `source` 'warmup', required - `warmPoolId` string, uuid, required - `workflowId` string, uuid, required - `workflowName` string, required - `workflowVersion` integer: Version number of workflowVersionId. Absent when the version no longer exists. - `workflowVersionId` string, uuid, required - `workflowVersionPublished` boolean: Whether workflowVersionId is currently published. Absent when the version no longer exists. - `page` integer, required - `pageSize` integer, required - `total` integer, required ## Other responses - `400`: The server could not understand the request due to invalid syntax. - `401`: Access is unauthorized. - `403`: Access is forbidden. - `404`: The server cannot find the requested resource. - `500`: Server error --- [API](https://skmtc.dev/asteroid/apis/agent-service.md) - [All operations](https://skmtc.dev/asteroid/apis/agent-service/llms.txt) - [OpenAPI document](https://skmtc.dev/asteroid/apis/agent-service/revisions/ccc134d1d510?raw)