Requests & TicketsApprovals

initiateRequestApprovalByPolicy

View as Markdown

Initiate a policy‑reference approval on a request.

Starts a new approval lifecycle on an existing REQUEST ticket using a saved approval policy. Approvers and criteria come from the policy — you do not pass them in this call. When to Use:

  • The workspace has a curated approval policy you want to reuse (e.g.

Parameters

NameTypeRequiredDescription
requestIdstringYesThe request display ID to initiate approval on (e.g., REQ-123, INC-456).
policy_idintegerYesNumeric id of a saved REQUEST approval policy. Discover via
namestringNoOptional human-readable label for the lifecycle. Defaults to the