Client APIApprovals

Reject an approval step

Reject an approval step. Records a rejection 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. Rejecting a step transitions the parent approval flow to `REJECTED`, no further steps are sent, and the response indicates the approval flow has completed in a terminal state.

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 reject. This must match the current actionable approval step on the owning contract or spend requisition.

Request

This endpoint expects an object.
reasonstringRequired<=1000 characters
The reason for rejecting the step. Shown to the hirer who submitted the approval when they are notified of the rejection.

Response

dataobject
Result of actioning an approval step.