Skip to main content

Generations Commands

See Generations module docs for permissions and data model.

soat list-generations​

List generations

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

Usage​

soat list-generations

Options​

--agent-id​

Filter by agent public ID

  • Source: query
  • Required: no
  • Type: string
--trace-id​

Filter by trace public ID

  • Source: query
  • Required: no
  • Type: string
--initiator-generation-id​

Filter by the public ID of the parent generation. Returns all generations triggered by that generation — sub-agent invocations. Null-initiated (top-level) generations are not returned.

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

Filter by lifecycle status

  • Source: query
  • Required: no
  • Type: enum("in_progress", "requires_action", "completed", "failed")
--limit​

—

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

—

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

soat get-generation​

Get a generation

  • Method: GET
  • Path: /api/v1/generations/{generation_id}

Usage​

soat get-generation --generation-id <string>

Options​

--generation-id​

Public ID of the generation

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