Approve payroll run

POST/payroll/runs/{id}/approve

Submits the payroll run for approval, triggering any configured multi-level approval workflow. Once all required approvals are granted, the run transitions to "approved" status and payment batches can be generated.

Request

Path parameters

Name	Type	Required	Description
id	integer	Yes	The numeric ID of the run to approve.

Request body

Content type application/json.

Field	Type	Required	Description
notes	string	No	Optional approval notes. Max length: 1000

Example

{
  "notes": "Verified all anomalies resolved. Approved for payment."
}

Responses

200 Run submitted for approval or directly approved if no workflow is configured

409 Run is not in a state that can be approved

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/payroll/runs/{id}/approve" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"notes": "Verified all anomalies resolved. Approved for payment."}'