---
title: "Get execution details"
method: GET
path: "/api/graphs/{graph_id}/executions/{graph_exec_id}"
tags: ["v1", "graphs"]
---

# Get execution details

`GET /api/graphs/{graph_id}/executions/{graph_exec_id}`

## Path parameters

- `graph_id` string, required
- `graph_exec_id` string, required

## Response `200`

Successful Response

- union
  - GraphExecution
    - `id` string, required
    - `user_id` string, required
    - `graph_id` string, required
    - `graph_version` integer, required
    - `inputs` object, required
    - `credential_inputs` object, nullable, required
    - `nodes_input_masks` object, nullable, required
    - `preset_id` string, nullable, required
    - `status` 'INCOMPLETE' | 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'TERMINATED' | 'FAILED' | 'REVIEW', required
    - `started_at` string, date-time, nullable — When execution started running. Null if not yet started (QUEUED).
    - `ended_at` string, date-time, nullable — When execution finished. Null if not yet completed (QUEUED, RUNNING, INCOMPLETE, REVIEW).
    - `is_shared` boolean
    - `share_token` string, nullable
    - `is_dry_run` boolean
    - `organization_id` string, nullable
    - `team_id` string, nullable
    - `expert_id` string, nullable
    - `stats` Stats, required
      - `cost` integer — Execution cost (cents)
      - `duration` number — Seconds from start to end of run
      - `duration_cpu_only` number — CPU sec of duration
      - `node_exec_time` number — Seconds of total node runtime
      - `node_exec_time_cpu_only` number — CPU sec of node_exec_time
      - `node_exec_count` integer — Number of node executions
      - `node_error_count` integer — Number of node errors
      - `error` string, nullable — Error message if any
      - `failure_reason` 'insufficient_balance' | 'entitlement_required' — Structured reasons for terminal graph execution failures.
      - `activity_status` string, nullable — AI-generated summary of what the agent did
      - `correctness_score` number, nullable — AI-generated score (0.0-1.0) indicating how well the execution achieved its intended purpose
    - `outputs` object, required
  - GraphExecutionWithNodes
    - `id` string, required
    - `user_id` string, required
    - `graph_id` string, required
    - `graph_version` integer, required
    - `inputs` object, required
    - `credential_inputs` object, nullable, required
    - `nodes_input_masks` object, nullable, required
    - `preset_id` string, nullable, required
    - `status` 'INCOMPLETE' | 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'TERMINATED' | 'FAILED' | 'REVIEW', required
    - `started_at` string, date-time, nullable — When execution started running. Null if not yet started (QUEUED).
    - `ended_at` string, date-time, nullable — When execution finished. Null if not yet completed (QUEUED, RUNNING, INCOMPLETE, REVIEW).
    - `is_shared` boolean
    - `share_token` string, nullable
    - `is_dry_run` boolean
    - `organization_id` string, nullable
    - `team_id` string, nullable
    - `expert_id` string, nullable
    - `stats` Stats, required
      - `cost` integer — Execution cost (cents)
      - `duration` number — Seconds from start to end of run
      - `duration_cpu_only` number — CPU sec of duration
      - `node_exec_time` number — Seconds of total node runtime
      - `node_exec_time_cpu_only` number — CPU sec of node_exec_time
      - `node_exec_count` integer — Number of node executions
      - `node_error_count` integer — Number of node errors
      - `error` string, nullable — Error message if any
      - `failure_reason` 'insufficient_balance' | 'entitlement_required' — Structured reasons for terminal graph execution failures.
      - `activity_status` string, nullable — AI-generated summary of what the agent did
      - `correctness_score` number, nullable — AI-generated score (0.0-1.0) indicating how well the execution achieved its intended purpose
    - `outputs` object, required
    - `node_executions` NodeExecutionResult[], required
      - `user_id` string, required
      - `graph_id` string, required
      - `graph_version` integer, required
      - `graph_exec_id` string, required
      - `node_exec_id` string, required
      - `node_id` string, required
      - `block_id` string, required
      - `status` 'INCOMPLETE' | 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'TERMINATED' | 'FAILED' | 'REVIEW', required
      - `input_data` object, required
      - `output_data` object, required
      - `add_time` string, date-time, required
      - `queue_time` string, date-time, nullable, required
      - `start_time` string, date-time, nullable, required
      - `end_time` string, date-time, nullable, required

## Other responses

- `401` — Authentication required
- `422` — Validation Error

## Changes

- **2026-08-20** `2f82328f5184` — 2 warning
  - added the new `entitlement_required` enum value to the `anyOf[subschema #1: GraphExecution]/stats/anyOf[subschema #1: Stats]/failure_reason/anyOf[subschema #1: ExecutionFailureReason]/` response property for the response status `200`
  - added the new `entitlement_required` enum value to the `anyOf[subschema #2: GraphExecutionWithNodes]/stats/anyOf[subschema #1: Stats]/failure_reason/anyOf[subschema #1: ExecutionFailureReason]/` response property for the response status `200`
- **2026-08-20** `ae1be5efc67a` — 2 warning
  - added the new `device_code` enum value to the `anyOf[subschema #1: GraphExecution]/credential_inputs/anyOf[subschema #1]/additionalProperties/type` response property for the response status `200`
  - added the new `device_code` enum value to the `anyOf[subschema #2: GraphExecutionWithNodes]/credential_inputs/anyOf[subschema #1]/additionalProperties/type` response property for the response status `200`
- **2026-08-18** `48316e19b6fd` — 2 info
  - added the optional property `anyOf[subschema #1: GraphExecution]/stats/anyOf[subschema #1: Stats]/failure_reason` to the response with the `200` status
  - added the optional property `anyOf[subschema #2: GraphExecutionWithNodes]/stats/anyOf[subschema #1: Stats]/failure_reason` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/graphs/:graph_id/executions/:graph_exec_id/get.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/revisions/5dc375899754/schema)