Create approval flow

Approvers: a user id from GET /users; a user group { type: 'userGroup', value, label }, manual or IdP, with its id as value, as an existing flow's approvers show it; or an item from GET /appCatalog/approvalFlows/config's approverOptions.

A special approver can resolve to nobody for a request (an app with no owner, an empty manager field); the step then waits as 'Needs attention' until an admin assigns it. Add a user or a group next to special approvers as a fallback.

A new flow runs only once an access request policy uses it, and that link is set in the App Catalog in Torii, not through the API.

  • Rate limit: 50 requests per minute

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≤ 255

Display name.

steps
array of objects
required
length between 1 and 15

The approval steps, in order: each step starts once the one before it is approved.

steps*
string
^[1-9]\d{0,14}$

Optional. The server assigns one when omitted; a sent id is kept.

approvers
array
required
length between 1 and 30

Who approves this step. Each item is a user id from GET /users; a user group { type: 'userGroup', value, label }, manual or IdP, with its id as value; or an item copied as is from GET /appCatalog/approvalFlows/config's approverOptions. A special approver can resolve to nobody for a given request (an app with no owner, an empty manager field); the step then becomes a "Needs attention" task until an admin assigns it. Add a user or a group next to special approvers as a fallback.

approvers*
customNotification
object | null

Optional. Leave it out, or send null, for the default notification; send { title, message } for a custom one. title ≤ 255 and message ≤ 1,000 characters; both can use the tokens in GET /appCatalog/approvalFlows/config's notificationTokens.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json