---
title: "Retrieve execution activities"
method: GET
path: "/agents/v2/executions/{executionId}/activities"
tags: ["Execution"]
---

# Retrieve execution activities

`GET /agents/v2/executions/{executionId}/activities`

## Request

- Base URL: `https://odyssey.asteroid.ai`
- URL: `https://odyssey.asteroid.ai/agents/v2/executions/{executionId}/activities`
- Auth: API key in header `X-Api-Key`

Get activities for an execution

## Path parameters

- `executionId` string, uuid, required

## Query parameters

- `order` 'asc' | 'desc'
- `limit` integer

## Response `200`

The request has succeeded.

- AgentsExecutionActivity[]
  - `executionId` string, uuid, required
  - `id` string, uuid, required
  - `payload` union, required
    - object
      - `activityType` 'terminal', required
      - `message` string
      - `reason` 'unsubscribe' | 'complete' | 'error', required
    - object
      - `activityType` 'generic', required
      - `display` AgentsExecutionActivityDisplay
        - `groupId` string
        - `presentationLevel` 'primary' | 'secondary' | 'system'
        - `summaryText` string
        - `turnId` string
      - `message` string, required
    - object
      - `activityType` 'reasoning', required
      - `display` AgentsExecutionActivityDisplay
        - `groupId` string
        - `presentationLevel` 'primary' | 'secondary' | 'system'
        - `summaryText` string
        - `turnId` string
      - `reasoning` string, required
    - object
      - `activityType` 'compaction_started', required
      - `display` AgentsExecutionActivityDisplay
        - `groupId` string
        - `presentationLevel` 'primary' | 'secondary' | 'system'
        - `summaryText` string
        - `turnId` string
    - object
      - `activityType` 'compaction_performed', required
      - `display` AgentsExecutionActivityDisplay
        - `groupId` string
        - `presentationLevel` 'primary' | 'secondary' | 'system'
        - `summaryText` string
        - `turnId` string
      - `durationMs` integer, required
      - `summaryTokens` integer, required
    - object
      - `activityType` 'step_started', required
      - `stepNumber` integer, required
    - object
      - `activityType` 'step_completed', required
      - `stepNumber` integer, required
    - object
      - `activityType` 'transitioned_node', required
      - `fromNodeDuration` integer
      - `fromNodeOutput` AgentsExecutionNodeOutputItem[]: Output variables provided by the from node
        - `name` string, required
        - `value` string, required
      - `fromNodeSummary` string: A summary of the work done in the previous node
      - `newNodeExecutionMode` 'scripted' | 'default': How an iris node runs: scripted when it has a script, else default
      - `newNodeName` string, required
      - `newNodeType` string, required
      - `newNodeUUID` string, uuid, required
      - `transitionType` 'iris' | 'selector' | 'outcome_success'
    - object
      - `activityType` 'status_changed', required
      - `awaitingConfirmationPayload` AgentsExecutionAwaitingConfirmationPayload
        - `reason` string, required
      - `cancelledPayload` AgentsExecutionCancelledPayload
        - `reason` 'timeout' | 'max_steps' | 'user_requested' | 'script_failed' | 'no_activity' | 'budget_exceeded' | 'no_warm_environment' | 'worker_lost', required
      - `completedPayload` AgentsExecutionCompletedPayload
        - `outcome` string, required
        - `reasoning` string, required
        - `result` unknown, required
      - `failedPayload` AgentsExecutionFailedPayload
        - `os_error` CommonOSError
          - `message` string, required
        - `reason` string, required
      - `pausedPayload` AgentsExecutionPausedPayload
        - `question` AgentsExecutionAskUserQuestion
          - `questions` AgentsExecutionQuestionItem[], required
            - `header` string, required
            - `multiSelect` boolean
            - `options` AgentsExecutionQuestionOption[], required
              - …
            - `question` string, required
        - `reason` string, required
      - `status` 'queued' | 'starting' | 'running' | 'paused' | 'awaiting_confirmation' | 'completed' | 'cancelled' | 'failed' | 'paused_by_agent', required
    - object
      - `actionId` string, required
      - `actionName` 'element_click' | 'element_type' | 'element_select' | 'element_hover' | 'element_drag' | 'element_wait' | 'element_fill_form' | 'element_get_text' | 'element_file_upload' | 'coord_move' | 'coord_click' | 'coord_double_click' | 'coord_triple_click' | 'coord_drag' | 'coord_scroll' | 'nav_to' | 'nav_back' | 'nav_refresh' | 'nav_tabs' | 'nav_close_browser' | 'nav_resize_browser' | 'nav_install_browser' | 'nav_zoom_in' | 'nav_zoom_out' | 'obs_snapshot' | 'obs_snapshot_with_selectors' | 'obs_screenshot' | 'obs_console_messages' | 'obs_network_requests' | 'obs_extract_html' | 'script_eval' | 'script_playwright' | 'script_playwright_llm_vars' | 'script_hybrid_playwright' | 'browser_run_code' | 'browser_press_key' | 'browser_handle_dialog' | 'browser_read_clipboard' | 'browser_solve_captcha' | 'file_list' | 'file_read' | 'file_stage' | 'file_download' | 'file_pdf_save' | 'scratchpad_read' | 'scratchpad_write' | 'scriptpad_run_function' | 'scriptpad_search_replace' | 'scriptpad_read' | 'scriptpad_write' | 'ext_google_sheets_get_data' | 'ext_google_sheets_set_data' | 'ext_get_mail' | 'ext_send_mail' | 'ext_api_call' | 'util_wait_time' | 'util_get_datetime' | 'util_generate_totp_secret' | 'util_send_user_message' | 'agent_query_context' | 'agent_compile_workflow' | 'llm_call' | 'sdk_bash' | 'sdk_read' | 'sdk_write' | 'sdk_edit' | 'sdk_glob' | 'sdk_grep' | 'sdk_skill' | 'handoff_prepare' | 'read_file', required
      - `activityType` 'action_started', required
      - `display` AgentsExecutionActivityDisplay
        - `groupId` string
        - `presentationLevel` 'primary' | 'secondary' | 'system'
        - `summaryText` string
        - `turnId` string
      - `info` union
        - object
          - `actionName` 'nav_to', required
          - `url` string, required
        - object
          - `actionName` 'scratchpad_read', required
          - `operation` 'read', required
        - object
          - `actionName` 'scratchpad_write', required
          - `operation` 'write', required
        - object
          - `actionName` 'scriptpad_run_function', required
          - `arguments` unknown, required
          - `functionName` string, required
        - object
          - `actionName` 'script_playwright', required
          - `llmVars` string[]
        - object
          - `actionName` 'script_hybrid_playwright', required
          - `llmVars` string[]
        - object
          - `actionName` 'browser_run_code', required
          - `code` string, required
        - object
          - `actionName` 'script_eval', required
          - `element` string
          - `function` string, required
          - `ref` string
        - object
          - `actionName` 'scriptpad_search_replace', required
          - `replace` string, required
          - `replaceAll` boolean, required
          - `search` string, required
        - object
          - `actionName` 'util_get_datetime', required
          - `tzTimezoneIdentifier` string, required
        - object
          - `actionName` 'scriptpad_read', required
          - `limit` integer, required
          - `offset` integer, required
        - object
          - `actionName` 'llm_call', required
          - `purpose` 'iris_pick_next_action' | 'transition_pick_next_node' | 'output_populate_result' | 'generate_hybrid_playwright_code' | 'generate_playwright_variables', required
        - object
          - `actionName` 'agent_query_context', required
          - `query` string, required
        - object
          - `actionName` 'sdk_bash', required
          - `command` string, required
          - `description` string
        - object
          - `actionName` 'sdk_read', required
          - `filePath` string, required
          - `limit` integer
          - `offset` integer
        - object
          - `actionName` 'sdk_write', required
          - `filePath` string, required
        - object
          - `actionName` 'sdk_edit', required
          - `filePath` string, required
          - `newString` string, required
          - `oldString` string, required
          - `replaceAll` boolean
        - object
          - `actionName` 'sdk_glob', required
          - `path` string
          - `pattern` string, required
        - object
          - `actionName` 'sdk_grep', required
          - `glob` string
          - `outputMode` string
          - `path` string
          - `pattern` string, required
        - object
          - `actionName` 'sdk_skill', required
          - `args` string
          - `skill` string, required
        - object
          - `actionName` 'read_file', required
          - `filePath` string, required
        - object
          - `actionName` 'handoff_prepare', required
          - `summary` string
          - `target` string
          - `variables` AgentsExecutionHandoffPrepareVariable[]
            - `name` string, required
            - `value` string, required
        - object
          - `actionName` 'ext_send_mail', required
          - `bcc` string[]
          - `bodyPreview` string
          - `cc` string[]
          - `subject` string, required
          - `to` string[], required
      - `message` string, required
    - object
      - `actionId` string, required
      - `actionName` 'element_click' | 'element_type' | 'element_select' | 'element_hover' | 'element_drag' | 'element_wait' | 'element_fill_form' | 'element_get_text' | 'element_file_upload' | 'coord_move' | 'coord_click' | 'coord_double_click' | 'coord_triple_click' | 'coord_drag' | 'coord_scroll' | 'nav_to' | 'nav_back' | 'nav_refresh' | 'nav_tabs' | 'nav_close_browser' | 'nav_resize_browser' | 'nav_install_browser' | 'nav_zoom_in' | 'nav_zoom_out' | 'obs_snapshot' | 'obs_snapshot_with_selectors' | 'obs_screenshot' | 'obs_console_messages' | 'obs_network_requests' | 'obs_extract_html' | 'script_eval' | 'script_playwright' | 'script_playwright_llm_vars' | 'script_hybrid_playwright' | 'browser_run_code' | 'browser_press_key' | 'browser_handle_dialog' | 'browser_read_clipboard' | 'browser_solve_captcha' | 'file_list' | 'file_read' | 'file_stage' | 'file_download' | 'file_pdf_save' | 'scratchpad_read' | 'scratchpad_write' | 'scriptpad_run_function' | 'scriptpad_search_replace' | 'scriptpad_read' | 'scriptpad_write' | 'ext_google_sheets_get_data' | 'ext_google_sheets_set_data' | 'ext_get_mail' | 'ext_send_mail' | 'ext_api_call' | 'util_wait_time' | 'util_get_datetime' | 'util_generate_totp_secret' | 'util_send_user_message' | 'agent_query_context' | 'agent_compile_workflow' | 'llm_call' | 'sdk_bash' | 'sdk_read' | 'sdk_write' | 'sdk_edit' | 'sdk_glob' | 'sdk_grep' | 'sdk_skill' | 'handoff_prepare' | 'read_file', required
      - `activityType` 'action_completed', required
      - `display` AgentsExecutionActivityDisplay
        - `groupId` string
        - `presentationLevel` 'primary' | 'secondary' | 'system'
        - `summaryText` string
        - `turnId` string
      - `duration` integer
      - `info` union
        - object
          - `actionName` 'ext_api_call', required
          - `requestMethod` string
          - `requestUrl` string
          - `responseBody` string, required
          - `statusCode` string, required
        - object
          - `actionName` 'scratchpad_read', required
          - `content` string
          - `contentTruncated` boolean
        - object
          - `actionName` 'scratchpad_write', required
          - `content` string
          - `contentTruncated` boolean
          - `linesChanged` integer, required
          - `patchesApplied` integer, required
          - `totalLines` integer, required
        - object
          - `actionName` 'script_playwright', required
          - `consoleLogs` string[], required
          - `failedLine` integer
          - `result` string, required
          - `success` boolean, required
        - object
          - `actionName` 'script_hybrid_playwright', required
          - `consoleLogs` string[], required
          - `failedLine` integer
          - `result` string, required
          - `success` boolean, required
        - object
          - `actionName` 'browser_run_code', required
          - `consoleLogs` string[], required
          - `failedLine` integer
          - `result` string, required
          - `success` boolean, required
        - object
          - `actionName` 'script_eval', required
          - `result` unknown, required
        - object
          - `actionName` 'file_read', required
          - `errorCount` integer
          - `fileNames` string[], required
          - `totalSizeBytes` integer
        - object
          - `actionName` 'file_list', required
          - `fileNames` string[], required
        - object
          - `actionName` 'file_stage', required
          - `fileNames` string[], required
        - object
          - `actionName` 'element_file_upload', required
          - `fileNames` string[], required
        - object
          - `actionName` 'ext_get_mail', required
          - `emailCount` integer, required
          - `emails` unknown[], required
            - unknown
        - object
          - `actionName` 'scriptpad_run_function', required
          - `consoleLogs` string[], required
          - `failedLine` integer
          - `result` string, required
          - `success` boolean, required
        - object
          - `actionName` 'scriptpad_read', required
          - `content` string, required
        - object
          - `actionName` 'scriptpad_write', required
          - `linesChanged` integer, required
          - `patchesApplied` integer, required
          - `scriptpad` string
          - `totalLines` integer, required
        - object
          - `actionName` 'scriptpad_search_replace', required
          - `linesReplaced` integer, required
          - `linesReplacedWith` integer, required
          - `newScriptpad` string
          - `newTotalLines` integer, required
          - `oldScriptpad` string
          - `oldTotalLines` integer, required
        - object
          - `actionName` 'obs_snapshot_with_selectors', required
          - `title` string, required
          - `url` string, required
        - object
          - `actionName` 'util_get_datetime', required
          - `datetime` string, date-time, required
          - `tzTimezoneIdentifier` string, required
          - `usedBrowserTimezone` boolean, required
        - object
          - `actionName` 'nav_to', required
          - `pageTitle` string
        - object
          - `actionName` 'agent_query_context', required
          - `answer` string, required
          - `query` string, required
        - object
          - `actionName` 'sdk_bash', required
          - `exitCode` integer
          - `output` string, required
        - object
          - `actionName` 'sdk_read', required
          - `content` string, required
        - object
          - `actionName` 'sdk_write', required
          - `success` boolean, required
        - object
          - `actionName` 'sdk_edit', required
          - `success` boolean, required
        - object
          - `actionName` 'sdk_glob', required
          - `files` string[], required
        - object
          - `actionName` 'sdk_grep', required
          - `output` string, required
          - `outputMode` string
        - object
          - `actionName` 'sdk_skill', required
          - `output` string
        - object
          - `actionName` 'read_file', required
          - `content` string
          - `contentType` 'image' | 'document' | 'text' | 'unknown', required
          - `mimeType` string
        - object
          - `actionName` 'handoff_prepare', required
          - `success` boolean, required
        - object
          - `actionName` 'ext_send_mail', required
          - `emailId` string
          - `success` boolean, required
      - `message` string, required
    - object
      - `actionId` string, required
      - `actionName` 'element_click' | 'element_type' | 'element_select' | 'element_hover' | 'element_drag' | 'element_wait' | 'element_fill_form' | 'element_get_text' | 'element_file_upload' | 'coord_move' | 'coord_click' | 'coord_double_click' | 'coord_triple_click' | 'coord_drag' | 'coord_scroll' | 'nav_to' | 'nav_back' | 'nav_refresh' | 'nav_tabs' | 'nav_close_browser' | 'nav_resize_browser' | 'nav_install_browser' | 'nav_zoom_in' | 'nav_zoom_out' | 'obs_snapshot' | 'obs_snapshot_with_selectors' | 'obs_screenshot' | 'obs_console_messages' | 'obs_network_requests' | 'obs_extract_html' | 'script_eval' | 'script_playwright' | 'script_playwright_llm_vars' | 'script_hybrid_playwright' | 'browser_run_code' | 'browser_press_key' | 'browser_handle_dialog' | 'browser_read_clipboard' | 'browser_solve_captcha' | 'file_list' | 'file_read' | 'file_stage' | 'file_download' | 'file_pdf_save' | 'scratchpad_read' | 'scratchpad_write' | 'scriptpad_run_function' | 'scriptpad_search_replace' | 'scriptpad_read' | 'scriptpad_write' | 'ext_google_sheets_get_data' | 'ext_google_sheets_set_data' | 'ext_get_mail' | 'ext_send_mail' | 'ext_api_call' | 'util_wait_time' | 'util_get_datetime' | 'util_generate_totp_secret' | 'util_send_user_message' | 'agent_query_context' | 'agent_compile_workflow' | 'llm_call' | 'sdk_bash' | 'sdk_read' | 'sdk_write' | 'sdk_edit' | 'sdk_glob' | 'sdk_grep' | 'sdk_skill' | 'handoff_prepare' | 'read_file', required
      - `activityType` 'action_failed', required
      - `display` AgentsExecutionActivityDisplay
        - `groupId` string
        - `presentationLevel` 'primary' | 'secondary' | 'system'
        - `summaryText` string
        - `turnId` string
      - `duration` integer
      - `message` string, required
    - object
      - `activityType` 'user_message_received', required
      - `message` string, required
      - `userUUID` string, uuid, required
    - object
      - `activityType` 'file_added', required
      - `fileId` string, uuid, required
      - `fileName` string, required
      - `fileSize` integer, required
      - `mimeType` string, required
      - `presignedUrl` string, required
      - `source` 'upload' | 'download' | 'agent', required
    - object
      - `activityType` 'playwright_script_generated', required
      - `context` string, required
      - `llmVars` AgentsGraphModelsNodesPropertiesPlaywrightScriptLLMVar[]
        - `description` string, required
        - `name` string, required
        - `type` 'string' | 'number' | 'boolean', required
      - `nodeId` string, uuid, required
      - `nodeName` string, required
      - `oldScript` string
      - `script` string, required
    - object
      - `activityType` 'script_variables_substituted', required
      - `display` AgentsExecutionActivityDisplay
        - `groupId` string
        - `presentationLevel` 'primary' | 'secondary' | 'system'
        - `summaryText` string
        - `turnId` string
      - `nodeId` string, uuid, required
      - `nodeName` string, required
      - `placeholders` string[], required
      - `scriptFileName` string, required
      - `substituted` boolean, required
      - `variables` object, required
    - object
      - `activityType` 'input_schema_resolved', required
      - `display` AgentsExecutionActivityDisplay
        - `groupId` string
        - `presentationLevel` 'primary' | 'secondary' | 'system'
        - `summaryText` string
        - `turnId` string
      - `nodeId` string, uuid, required
      - `nodeName` string, required
      - `properties` string[], required
      - `resolved` object, required
      - `resolvedBy` object
    - object
      - `activityType` 'output_schema_resolved', required
      - `display` AgentsExecutionActivityDisplay
        - `groupId` string
        - `presentationLevel` 'primary' | 'secondary' | 'system'
        - `summaryText` string
        - `turnId` string
      - `nodeId` string, uuid, required
      - `nodeName` string, required
      - `properties` string[], required
      - `resolved` object, required
      - `resolvedBy` object
    - object
      - `activityType` 'todos_updated', required
      - `display` AgentsExecutionActivityDisplay
        - `groupId` string
        - `presentationLevel` 'primary' | 'secondary' | 'system'
        - `summaryText` string
        - `turnId` string
      - `todos` AgentsExecutionTodo[], required
        - `content` string, required
        - `id` string, required
        - `outcome` string
        - `status` 'pending' | 'in_progress' | 'completed' | 'blocked' | 'failed' | 'canceled', required
  - `timestamp` string, date-time, 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)