Orchestration - Spans

List spans

List flattened execution spans for orchestration runs (one row per executed node within a run)

post/orchestration/spans/list

Request

  • Base URL
    https://api.getcargo.io/v1
  • URL
    https://api.getcargo.io/v1/orchestration/spans/list
  • Auth
    HTTP bearer

Request body

workflowUuidstring uuid

When set, restrict spans to this workflow. Omit to search across workflows in the workspace.

userUuidstring uuid

User identifier to filter by.

batchUuidstring uuid

Batch identifier to filter by.

runUuidstring uuid

Run identifier to filter by.

recordIdstring

Record ID to filter by.

recordTitlestring

Record title to filter by (SQL ilike).

recordTitleOrIdstring

Match record id or record title (each SQL ilike); same pattern as run list.

parentRunUuidstring uuid

Parent run identifier to filter by.

parentNodeUuidstring uuid

Filter by parent node UUID on the run.

parentAgentUuidstring uuid

When set, restrict spans to rows whose parent agent matches this UUID.

nodeUuidstring uuid

Node identifier to filter by.

nodeKind'native' | 'connector' | 'tool' | 'agent'

Filter by node kind (native, connector, tool, agent).

nodeSlugstring

Filter by workflow node slug (exact match).

nodeIntegrationSlugstring

Filter by connector integration slug (exact match).

nodeConnectorUuidstring uuid

Filter by connector UUID.

nodeActionSlugstring

Filter by node action slug (exact match).

nodeToolUuidstring uuid

Filter by tool node UUID.

nodeAgentUuidstring uuid

Filter by agent node UUID.

nodeReleaseUuidstring uuid

Filter by release UUID referenced on the node.

executionTitlestring

Filter by execution title (SQL ilike).

executionStatusesstring[]

Execution statuses to include.

executionStartedAfterstring required

Include spans whose execution started after this timestamp (ISO string). Required.

executionStartedBeforestring

Include spans whose execution started on or before this timestamp (ISO string).

limitnumber

Maximum number of spans to return.

offsetnumber

Number of spans to skip.

Response

Successful response

countnumber required

Total count of matching spans.

Changes

No recorded changes to this operation across all 1 revision of this API.