Skip to main content

Activity Commands

See Activity module docs for permissions and data model.

soat list-activity​

List activity feed entries

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

Usage​

soat list-activity

Options​

--project-id​

Project ID (required if not using project key auth)

  • Source: query
  • Required: no
  • Type: string
  • Example: proj_V1StGXR8Z5jdHi6B
--kind​

Filter by activity kind

  • Source: query
  • Required: no
  • Type: enum("action_executed", "approval_created", "approval_resolved", "exception_created", "schedule_fired", "share_cap_exceeded", "share_resumed", "share_revoked", "share_suspended", "tool_resolution_failed", "usage_quantity_invalid")
--severity​

Filter by severity

  • Source: query
  • Required: no
  • Type: enum("info", "warning", "critical")
--agent-id​

Filter to entries produced by one agent. Composable with every other filter — entries carry one agent, one generation and one run, so naming two narrows to the rows where both hold.

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

Filter to entries produced during one agent generation. This is what turns tool_resolution_failed from alertable into usable: the warning for a suspect turn is one query rather than a scan of the project's feed.

  • Source: query
  • Required: no
  • Type: string
  • Example: gen_V1StGXR8Z5jdHi6B
--orchestration-run-id​

Filter to entries produced during one orchestration run.

  • Source: query
  • Required: no
  • Type: string
  • Example: orch_run_V1StGXR8Z5jdHi
--cursor​

Opaque cursor from a previous page's next_cursor

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

soat export-activity​

Export the activity feed as NDJSON

  • Method: GET
  • Path: /api/v1/activity/export

Usage​

soat export-activity --project-id <string>

Options​

--project-id​

Project whose activity is exported

  • Source: query
  • Required: yes
  • Type: string
  • Example: proj_V1StGXR8Z5jdHi6B
--kind​

Only entries of this kind

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

Only entries of this severity

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

Only entries an agent produced

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

Only entries a generation produced

  • Source: query
  • Required: no
  • Type: string
  • Example: gen_V1StGXR8Z5jdHi6B
--orchestration-run-id​

Only entries an orchestration run produced

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