List Approvals
GET /v2/policy-approvals
List Approval objects (created if a policy triggered requiring an Approval process action).
Required Permissions
Name
Conditions
Policies:Approvals:Read
Always Required
Query parameters
Query param
Required/Optional
Description
limit
Positive Integer -Optional
Maximum number of items to return. Default to 20.
paginationToken
String - Optional
Opaque token used to retrieve the next page. Returned as nextPageToken
from the previous request.
status
String - Optional
Either Pending
, Approved
, Denied, AutoApproved
or Expired
.
triggerStatus
String - Optional
Triggered
or Skipped
.
initiatorId
String - Optional
The user ID of the activity initiator.
approverId
String - Optional
The user ID of a potential approver.
Response
200 - List of Approval Objects
See Get Approval response for the details of a single approval object
{
"items":[
{
"id":"evl-...",
...
}
],
"nextPageToken":"ZxZ..."
}
Last updated