Skip to main content
GET
/
workflow-requests
/
{id}
/
execution-tree
Get Workflow Execution Tree
curl --request GET \
  --url https://app.splox.io/api/v1/workflow-requests/{id}/execution-tree \
  --header 'Authorization: Bearer <token>'
{
  "execution_tree": {
    "workflow_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z",
    "completed_at": "2023-11-07T05:31:56Z",
    "nodes": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "node_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "node_label": "<string>",
        "node_type": "<string>",
        "input_data": {},
        "output_data": {},
        "created_at": "2023-11-07T05:31:56Z",
        "completed_at": "2023-11-07T05:31:56Z",
        "failed_at": "2023-11-07T05:31:56Z",
        "attempt_count": 123,
        "child_executions": [
          {
            "index": 123,
            "workflow_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "status": "<string>",
            "label": "<string>",
            "target_node_label": "<string>",
            "created_at": "2023-11-07T05:31:56Z",
            "completed_at": "2023-11-07T05:31:56Z",
            "nodes": "<array>"
          }
        ],
        "total_children": 123,
        "has_more_children": true
      }
    ]
  }
}
Retrieves the complete execution tree showing all nodes, their status, and hierarchy.

​
Usage

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://app.splox.io/api/v1/workflow-requests/{workflow_request_id}/execution-tree

​
Response

{
  "execution_tree": {
    "workflow_request_id": "0199f123-d60e-7ffd-9131-4cc5ab040ee8",
    "status": "completed",
    "created_at": "2025-10-22T12:15:30Z",
    "completed_at": "2025-10-22T12:15:47Z",
    "nodes": [
      {
        "id": "0199f124-e70f-8gge-2242-5dd6bc151ff9",
        "node_id": "0199e002-b34c-8d9e-2345-678901bcdef0",
        "node_label": "Start",
        "node_type": "start",
        "status": "completed",
        "input_data": {},
        "output_data": { "user_id": "12345" },
        "created_at": "2025-10-22T12:15:32Z",
        "completed_at": "2025-10-22T12:15:33Z",
        "failed_at": null,
        "attempt_count": 1,
        "child_executions": [],
        "total_children": 0,
        "has_more_children": false
      },
      {
        "id": "0199f125-f81g-9hhf-3353-6ee7cd262gg0",
        "node_id": "0199e003-c45d-9e0f-3456-789012cdef01",
        "node_label": "Process Data",
        "node_type": "agent",
        "status": "completed",
        "input_data": { "user_id": "12345" },
        "output_data": { "result": "processed" },
        "created_at": "2025-10-22T12:15:34Z",
        "completed_at": "2025-10-22T12:15:45Z",
        "failed_at": null,
        "attempt_count": 1,
        "child_executions": [
          {
            "index": 0,
            "workflow_request_id": "0199f126-g92h-0iig-4464-7ff8de373hh1",
            "status": "completed",
            "label": "→ Agent B",
            "target_node_label": "Agent B",
            "created_at": "2025-10-22T12:15:35Z",
            "completed_at": "2025-10-22T12:15:44Z",
            "nodes": []
          }
        ],
        "total_children": 1,
        "has_more_children": false
      }
    ]
  }
}

​
Node Status Values

  • pending - Queued for execution
  • running - Currently executing
  • completed - Finished successfully
  • failed - Execution failed
  • blocked - Waiting for dependencies
  • stopped - Manually stopped

​
Use Cases

  • Debugging - Visualize complete execution flow
  • Analytics - Analyze workflow performance
  • Audit logs - Track what executed and when
  • Error analysis - Find where execution failed

​
Notes

Authentication required: Include Bearer token in Authorization header
Use this endpoint to build execution visualizations or debug complex multi-agent workflows.

Authorizations

​
Authorization
string
header
required

API token generated from your Splox account settings. Create tokens at https://app.splox.io/account?tab=settings

Path Parameters

​
id
string<uuid>
required

Workflow request ID

Response

200 - application/json

Execution tree retrieved successfully

​
execution_tree
object