Get Execution by ID

Get a single workflow execution with its node-level detail.

GET /api/v2/public/execution/:execution_id

cURL (API key)

curl -X GET "https://app.refold.ai/api/v2/public/execution/{execution_id}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"

200

{
  "name": "Execution for workflow 6a106ba44480b80424a65289",
  "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
  "environment": "test",
  "status": "COMPLETED",
  "completion_percentage": 100,
  "config_id": "user_12345",
  "linked_account_id": "user_12345",
  "nodes": [
    {
      "node_id": "1",
      "node_name": "Start",
      "node_type": "start",
      "node_status": "Success",
      "is_batch": false,
      "attempts_made": 1,
      "execution_time": 403,
      "latest_output": {
        "message": "Workflow started successfully",
        "node_id": "1",
        "node_type": "start",
        "status": "initialized"
      }
    }
  ]
}

Retrieve a single execution by ID, including per-node status and output. Use it to debug a run or show progress.

Authentication

This endpoint is scoped to a linked account, so it accepts either authentication method.

Option 1 — API key

x-api-key · string

Your Refold API key.

linked_account_id · string

The linked account.

Option 2 — Session token

Authorization · string

Session token. Format: Bearer YOUR_SESSION_TOKEN

Path Parameters

execution_id · string · required

The execution ID.

Response

200 OK

name · string

Execution name.

status · string

Overall status.

completion_percentage · number

Progress, 0–100.

config_id · string

The config that ran.

linked_account_id · string

The linked account.

nodes · array

Per-node execution detail.

Show properties

node_id · string

Node ID within the workflow.

node_name · string

Node label.

node_type · string

Node type, e.g. start.

node_status · string

Node status, e.g. Success.

is_batch · boolean

Whether the node processed batches.

attempts_made · integer

Retry attempts.

execution_time · integer

Node duration (ms).

latest_output · object

The node’s most recent output.

404 Not Found

status_code · integer

HTTP status code.

http_error_type · string

Error category.

error_code · string

Internal error code.

message · string

Human-readable error description.

200

{
  "name": "Execution for workflow 6a106ba44480b80424a65289",
  "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
  "environment": "test",
  "status": "COMPLETED",
  "completion_percentage": 100,
  "config_id": "user_12345",
  "linked_account_id": "user_12345",
  "nodes": [
    {
      "node_id": "1",
      "node_name": "Start",
      "node_type": "start",
      "node_status": "Success",
      "is_batch": false,
      "attempts_made": 1,
      "execution_time": 403,
      "latest_output": {
        "message": "Workflow started successfully",
        "node_id": "1",
        "node_type": "start",
        "status": "initialized"
      }
    }
  ]
}

cURL (API key)

curl -X GET "https://app.refold.ai/api/v2/public/execution/{execution_id}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"