Skip to main content
GET
/
executions
/
{executionId}
Get execution
curl --request GET \
  --url https://odyssey.asteroid.ai/agents/v2/executions/{executionId} \
  --header 'X-Asteroid-Agents-Api-Key: <api-key>'
{
  "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agentName": "<string>",
  "comments": [
    {
      "content": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "executionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "public": true,
      "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "hasBeenRerun": true,
  "humanLabels": [
    {
      "color": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "workflowId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agentProfileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "agentProfileName": "<string>",
  "browserLiveViewUrl": "<string>",
  "browserRecordingUrl": "<string>",
  "duration": 123,
  "executionOptions": {
    "sharedStorageKey": "<string>",
    "softTimeoutMins": 2
  },
  "executionResult": {
    "createdAt": "2023-11-07T05:31:56Z",
    "executionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "outcome": "<string>",
    "reasoning": "<string>",
    "result": "<unknown>"
  },
  "inputs": {},
  "liveViewUrl": "<string>",
  "metadata": {},
  "parentExecutionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "recordingUrl": "<string>",
  "terminalAt": "2023-11-07T05:31:56Z",
  "triggerContext": {
    "runner": {
      "email": "<string>",
      "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "isAdmin": true
    },
    "apiKey": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    }
  }
}

Authorizations

​
X-Asteroid-Agents-Api-Key
string
header
required

Path Parameters

​
executionId
string<uuid>
required

The unique identifier of the execution

Response

The request has succeeded.

Represents a single execution in a list view

​
agentId
string<uuid>
required

The ID of the agent that was executed

​
agentName
string
required

The agent display name

​
comments
object[]
required

Comments on this execution

​
createdAt
string<date-time>
required

When the execution was created

​
hasBeenRerun
boolean
required

Whether this execution has been rerun at least once

​
humanLabels
object[]
required

Human-applied labels for this execution

​
id
string<uuid>
required

The unique identifier of the execution

​
organizationId
string<uuid>
required

The organization this execution belongs to

​
status
enum<string>
required

The current status of the execution

Available options:
starting,
running,
paused,
awaiting_confirmation,
completed,
cancelled,
failed,
paused_by_agent
​
workflowId
string<uuid>
required

The ID of the workflow that was executed

​
agentProfileId
string<uuid>

The ID of the agent profile used for this execution (if any)

​
agentProfileName
string

The name of the agent profile used for this execution (if any)

​
browserLiveViewUrl
string
deprecated

Deprecated: Use 'liveViewUrl' instead.

​
browserRecordingUrl
string
deprecated

Deprecated: Use 'recordingUrl' instead.

​
duration
number<double>

Execution duration in seconds (only present for terminal executions)

​
executionOptions
object

Per-execution runtime options (e.g. shared storage key)

​
executionResult
object

Execution result with outcome, reasoning, and result data

​
inputs
object

Input variables used for this execution

​
liveViewUrl
string

Live view URL for debugging (if an environment is active and execution is running)

​
metadata
object

Optional metadata key-value pairs attached to this execution

​
parentExecutionId
string<uuid>

ID of the execution this was rerun from, if applicable

​
recordingUrl
string

Recording URL for playback (if an environment was used and execution is terminal)

​
terminalAt
string<date-time>

When the execution reached a terminal state (if applicable)

​
triggerContext
object

Context about how and by whom this execution was triggered (discriminated by source)