Submit a requisition

POST 
/v1/requisitions/:id/submit

Required scoperequisitions:writeWhat are scopes?

Submits a draft requisition, for approval when approvals are on.

Request

Responses

200

Requisition submitted

401

Missing or invalid bearer token.

403

The public API is not enabled for this account (err_feature_not_enabled), the acting user is not allowed to manage this requisition, or the API key lacks the requisitions:write scope (err_insufficient_scope). Also returned when requisitions are not enabled for your account (err_requisition_feature_not_enabled).

404

Requisition not found (err_requisition_not_found).

409

The requisition can't be submitted. Error codes:

• err_invalid_state_transition — the requisition isn't a draft
• err_requisition_not_submitted — approvals are on and no approval flow matches the requisition, or the requisition couldn't be saved

422

Validation failed. Error codes:

• err_<field>_required — a field the requisition form marks Mandatory is missing or set to null, e.g. err_hiring_manager_required or err_job_required
• Field errors when the draft is missing a field needed to submit it
• err_on_behalf_of_not_allowed — a personal access token passed another user's ID
• err_user_not_found — on_behalf_of is not an active user in the account
• err_on_behalf_of_forbidden — that user is not allowed to perform this action