initiateApprovalByPolicy | Atomicwork

Initiate an approval on a request (descriptor or policy).

Starts a new approval lifecycle on an existing REQUEST ticket. Pass EITHER approval_descriptor (from getIgaResolvedEntitlements) OR policy_id. Approvers and criteria come from the referenced policy — you do not pass them in this call.

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	No	Numeric id of a saved REQUEST or GLOBAL approval policy. Discover via
`approval_descriptor`	object	No
`name`	string	No	Optional human-readable label for the lifecycle. Defaults to the