Requests & TicketsApprovals

initiateRequestApproval

View as Markdown

Initiate an inline approval on a request.

Starts a new inline (ad‑hoc) approval lifecycle on an existing REQUEST ticket. Approvers can be specified by numeric user_id and/or email — emails are resolved server‑side to user IDs, so callers do not need to pre‑resolve them.

Parameters

NameTypeRequiredDescription
requestIdstringYesThe request display ID to initiate approval on (e.g., REQ-123, INC-456).
criteriaApprovalCriteriaYes
approversMcpApproverRef[]YesApprovers for the lifecycle. Each entry must set user_id or email.
namestringNoOptional human-readable label for the lifecycle. If omitted the platform