Skip to main content

Approvals Commands

See Approvals module docs for permissions and data model.

soat list-approvals​

List approval items

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

Usage​

soat list-approvals

Options​

--project-id​

Project ID (required if not using project key auth)

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

Filter by lifecycle status

  • Source: query
  • Required: no
  • Type: enum("pending", "approved", "rejected", "expired")
--origin​

Filter by producer origin

  • Source: query
  • Required: no
  • Type: enum("node", "tool_call", "task_transition")
--expires-before​

Return only items expiring at or before this timestamp

  • 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 list-approval-recurrences​

List recurring approval groups

  • Method: GET
  • Path: /api/v1/approvals/recurrences

Usage​

soat list-approval-recurrences

Options​

--project-id​

Project ID (required if not using project key auth)

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

Lifecycle status the groups are built from (default rejected)

  • Source: query
  • Required: no
  • Type: enum("pending", "approved", "rejected", "expired")
  • Default: rejected
--min-count​

Minimum items in a group for it to be returned

  • Source: query
  • Required: no
  • Type: integer
  • Default: 2
--limit​

Maximum number of groups to return

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

Number of groups to skip

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

soat get-approval​

Get an approval item

  • Method: GET
  • Path: /api/v1/approvals/{approval_id}

Usage​

soat get-approval

Options​

This command has no options.

soat approve-approval​

Approve an approval item

  • Method: POST
  • Path: /api/v1/approvals/{approval_id}/approve

Usage​

soat approve-approval

Options​

--arguments​

Edited arguments to execute instead of the proposed ones

  • Source: body
  • Required: no
  • Type: object

soat reject-approval​

Reject an approval item

  • Method: POST
  • Path: /api/v1/approvals/{approval_id}/reject

Usage​

soat reject-approval --reason <string>

Options​

--reason​

Why the item is being rejected (required)

  • Source: body
  • Required: yes
  • Type: string
  • Example: Amount exceeds the approved monthly budget.