Docs
Sign in

List approvals, pending and decided.

GET/api/v1/approvals

Scoperead

No path parameters.

Query parameters.

crewIdstring

Only those of this crew. At least 5 characters.

statearray

One or more states, comma-separated. Any of pending, approved, denied, expired. At least 1 item.

kindarray

One or more values, comma-separated. For events: exact kinds or prefixes such as run.*. Any of merge, deploy, public_preview, budget, destructive, load_test, question, plan. At least 1 item.

limit1–200

How many items to return, 1 to 200. Default 50.

cursorstring

The nextCursor of the previous page. Only valid with the same filters and order. At least 1 character.

orderenum

desc is newest first; asc is oldest first. Collections sort by creation time, then id. One of asc, desc. Default desc.

Response.

One page of a list: data holds the items (each a Approval); nextCursor and hasMore lead to the next page. The example has placeholder values.