Approve an approval step

Approve an approval step. Records a positive decision on a specific approval step. The `approval_step_id` should come from `pre_offer_approval.current_approval_step.approval_step_id` on a contract payload, or from `approval.current_approval_step.approval_step_id` on a spend requisition payload. Approval authority is derived from the authenticated service account, not from a field in the request body. The authenticated service account must be linked to a hirer who is currently eligible to approve this step. If the approved step was the final step in the chain, the parent approval flow transitions to `APPROVED`. Otherwise the next step in the chain is sent automatically and returned as `approval_flow.next_approval_step` on the response.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

approval_step_idstringRequiredformat: "^aprvl_c[a-z0-9]{24}$"
The unique identifier of the approval step to approve. This must match the current actionable approval step on the owning contract or spend requisition.

Request

This endpoint expects an object.
notestringOptional<=1000 charactersDefaults to

Optional free-text note recorded with the approval for audit purposes.

Response

dataobject
Result of actioning an approval step.