offer.approve

Approves an offer or a specific approval step within an offer's approval process.

This endpoint mimics the behavior of the "Force Approve" function in the Ashby app, where an admin can override approval for a specific step or entire approval process.

Requires the offersWrite permission.

This endpoint can be used in two ways:

  1. Approve entire offer: Call without approvalStepId and userId to approve the entire offer approval process
  2. Approve specific step: Provide both approvalStepId and userId to approve a specific step in the approval process

When approving a specific step, the step must be the current step in the approval process and the user must be an approver for that step.

Body Params
uuid
required

The id of the offer version that needs approval. This can be obtained as the entityId from the approval.list endpoint.

uuid

The id of the specific approval step to approve. If provided, userId must also be provided. If omitted, the entire offer approval process will be approved. This can be obtained from the approval.list endpoint.

uuid

The id of the user approving the step. Required if approvalStepId is provided. Must be an approver for the specified approval step.

Response

Language
Credentials
Basic
base64
:
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json