post
https://api.ashbyhq.com/job.startApprovalProcess
Starts the approval process for a job. Creates an approval instance and
submits it to the configured approvers.
If an approval process instance is already pending for the job, returns
an error rather than creating a duplicate.
Error codes:
| Code | Description |
|---|---|
insufficient_permissions | The approvals API is not enabled for the organization. |
job_not_found | No job exists with the given ID, or the API key cannot access it. |
approval_process_instance_already_pending | An approval for this job is already pending. |
job_approval_definition_not_configured | No approval definition matches this job. |
job_cannot_be_opened_due_to_validation | The job failed approval validation. The errors array includes the validation detail. |
Requires the approvalsWrite permission.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…