Read a trace slice | Runtype Documentation

{
  "data": {
    "content": {
      "cut": [
        {
          "bytes": 1.1,
          "field": "string",
          "returnedBytes": 1.1,
          "spanId": "string"
        }
      ],
      "limitBytes": 1.1,
      "loaded": true,
      "unavailable": [
        "string"
      ],
      "usedBytes": 1.1
    },
    "executionId": "string",
    "matchedSpans": 1.1,
    "selection": {
      "firstFailedIndex": 1.1,
      "from": 1.1,
      "mode": "range",
      "to": 1.1
    },
    "source": "string",
    "spans": [
      {
        "cost": 1.1,
        "durationMs": 1.1,
        "error": "string",
        "index": 1.1,
        "inputPreview": "string",
        "inputTokens": 1.1,
        "kind": "string",
        "model": "string",
        "name": "string",
        "outputPreview": "string",
        "outputTokens": 1.1,
        "parentSpanId": "string",
        "spanId": "string",
        "startedAt": "string",
        "status": "string",
        "stopReason": "string",
        "toolName": "string",
        "content": {}
      }
    ],
    "totalSpans": 1.1,
    "traceId": "string",
    "traceTruncated": true,
    "truncated": true
  },
  "success": true
}

A bounded window of one trace: by span index range, span kind, tool name, or around the first failed span. Content stays previews-only unless includeContent is set, which loads it for the selected spans under a byte budget and lists every cut.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

executionIdstringRequired

Query parameters

startstringOptional

First span index (trace start order) to include.

endstringOptional

Span index to stop before.

kindenumOptional

Allowed values:

toolNamestringOptional

aroundFirstFailurestringOptional

Return the first failed span plus this many spans either side (0-50). Not combinable with start/end.

limitstringOptional

Spans to return, 1-100 (default 25).

includeContentenumOptional

Load full content for the selected spans only, under maxContentBytes.

Allowed values:

maxContentBytesstringOptional

Content byte budget, 1-262144 (default 65536).

Response

Trace slice

dataobject

successboolean

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

503

Service Unavailable Error