Reject payroll approval step

POST/payroll/approvals/{id}/reject

Rejects an individual approval step, returning the payroll run to draft status for correction.

Request

Path parameters

Name	Type	Required	Description
id	integer	Yes	The numeric ID of the approval step.

Request body

Content type application/json.

Field	Type	Required	Description
reason	string	No	Max length: 500

Example

{
  "reason": "Overtime totals for branch 3 need to be verified before approval."
}

Responses

200 Approval step rejected; run returned to draft

404 Approval step not found

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/payroll/approvals/{id}/reject" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Overtime totals for branch 3 need to be verified before approval."}'