Skip to main content
GET
List approvals

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.

Query Parameters

status
enum<string>[] | null

The app's tabs, repeated or comma-separated: pending, approved, rejected, history (approved and rejected: the History tab) or all. Default: pending

Available options:
pending,
approved,
rejected,
history,
all
list
enum<string> | null

The app's list selector: my_approvals, those assigned to the key's person (the default for a person's key), or all_approvals, everyone's (the default for other keys; a person's key needs agent_studio:write for it, as the app's tracker does)

Available options:
my_approvals,
all_approvals
limit
integer
default:25
Required range: 1 <= x <= 100
cursor
string | null

next_cursor from the previous page

Response

200 - application/json

Successful Response

data
Approval · object[]
required
total
integer
required

How many approvals match the filters, across every page

has_more
boolean
default:false
next_cursor
string | null