Skip to main content
GET
List approval policies
Approval policies are the platform’s catalog: your role grants must hold the three permissions at the platform scope or the deployment root org unit. See Row visibility. Trust Fabric gate policies are a different object: see List trust policies. With includeApproverLimits=true, each policy also carries its approver limits, approverMustDifferFromRequester and approverMustBePerson (an unset limit is false). Without the parameter the response is unchanged; any other value is 400.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Query Parameters

includeApproverLimits
enum<string>

true adds approverMustDifferFromRequester and approverMustBePerson to each policy. Any other value, or the parameter sent twice, is 400.

Available options:
true,
false
limit
integer
default:100

Items per page, 1 to 100 (default 100); a larger value is a 400 too_big. A page may hold fewer items than limit while meta.hasMore is true; continue with meta.nextCursor.

Required range: 1 <= x <= 100
cursor
string

The previous page's meta.nextCursor; any other value is 400.

Minimum string length: 1

Response

Policy list

data
object[]
required
meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.