Other

Create an Approval Flow

Changed on

Creates an approval flow with the stages you list, in order.

Available only to Enterprise-plan workspaces and first-party clients.

post/approval-flows

Request

  • Base URL
    https://api.orshot.com/v1
  • URL
    https://api.orshot.com/v1/approval-flows
  • Auth
    HTTP bearer

Request body

namestring required

Display name. Up to 80 characters.

slugstring

Stable id for the API and MCP; generated from the name when omitted.

descriptionstring

Optional description. Up to 500 characters.

colorstring

Chip colour. One of subtle, blue, green, amber, rose, orange, purple. Can be null.

blocksRendersboolean

Templates in this flow render through the API only from stages that allow it. Default true.

settingsobject

Flow settings to change (partial).

Response

Successful response

object required

Changes