List traces

List orchestration traces. Each trace wraps every span (node execution) across its run lineage; the summary is aggregated at query time directly from orchestration.spans (no separate traces table — spans carries trace_uuid with a bloom-filter skipping index).

POST /orchestration/traces/list

List traces

cURL

curl --request POST \
  --url https://api.getcargo.io/v1/orchestration/traces/list \
  --header 'Authorization: Bearer <token>'

200

{
  "traces": [
    {
      "uuid": "<string>",
      "workspaceUuid": "<string>",
      "workflowUuid": "<string>",
      "rootRunUuid": "<string>",
      "spansCount": 123,
      "failedSpansCount": 123,
      "pendingSpansCount": 123,
      "succeededSpansCount": 123,
      "creditsUsedCount": 123,
      "startedAt": "<string>",
      "finishedAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "count": 123
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200

application/json

Successful response

traces · Traces · object[] · required

Traces matching the filter.

Show child attributes

count · number · required

Total count of matching traces.