initiateRequestApprovalByPolicy
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
| Name | Type | Required | Description |
|---|---|---|---|
requestId | string | Yes | The request display ID to initiate approval on (e.g., REQ-123, INC-456). |
policy_id | integer | Yes | Numeric id of a saved REQUEST approval policy. Discover via |
name | string | No | Optional human-readable label for the lifecycle. Defaults to the |