Trace an execution | Runtype Documentation

{
  "success": true,
  "data": {
    "executionId": "a3f1c9d2-7b4e-4f8a-9c3d-2e5f7a1b6c9d",
    "startTime": "2024-06-10T09:15:30Z",
    "endTime": "2024-06-10T09:17:45Z",
    "status": "completed",
    "traceTree": {
      "id": "root",
      "name": "MainExecution",
      "durationMs": 135000,
      "children": [
        {
          "id": "step-1",
          "name": "InitializeResources",
          "durationMs": 30000,
          "children": []
        },
        {
          "id": "step-2",
          "name": "ProcessData",
          "durationMs": 90000,
          "children": [
            {
              "id": "step-2-1",
              "name": "FetchInput",
              "durationMs": 20000,
              "children": []
            },
            {
              "id": "step-2-2",
              "name": "TransformData",
              "durationMs": 70000,
              "children": []
            }
          ]
        },
        {
          "id": "step-3",
          "name": "Cleanup",
          "durationMs": 15000,
          "children": []
        }
      ]
    }
  }
}

Returns a structured trace tree for a single execution.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

executionIdstringRequired

Execution ID to trace

Response

Trace tree returned

successboolean

dataany

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/logs/trace/execution/executionId \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"