Skip to main content

Traces Commands

See Traces module docs for permissions and data model.

soat list-traces​

List traces

  • Method: GET
  • Path: /api/v1/traces

Usage​

soat list-traces

Options​

--project-id​

Project public ID to filter by

  • Source: query
  • Required: no
  • Type: string
--limit​

Maximum number of results to return

  • Source: query
  • Required: no
  • Type: integer
  • Default: 50
--offset​

Number of results to skip

  • Source: query
  • Required: no
  • Type: integer
  • Default: 0

soat get-trace​

Get a trace

  • Method: GET
  • Path: /api/v1/traces/{trace_id}

Usage​

soat get-trace --trace-id <string>

Options​

--trace-id​

Public ID of the trace

  • Source: path
  • Required: yes
  • Type: string

soat get-trace-tree​

Get trace tree

  • Method: GET
  • Path: /api/v1/traces/{trace_id}/tree

Usage​

soat get-trace-tree --trace-id <string>

Options​

--trace-id​

Public ID of any trace in the tree (root or child)

  • Source: path
  • Required: yes
  • Type: string
--include​

Comma-separated list of related resources to embed on each node. Supported value: generations — attaches all generations that belong to each trace node (including sub-agent generations linked via initiator_generation_id).

  • Source: query
  • Required: no
  • Type: string
  • Example: generations