Approve Time Off Request

post

https://{companyDomain}.bamboohr.com/api/v1/time-off/requests/{id}/approvals

Approves a time off request. Completes the caller's step in the approval chain, or every remaining step when bypass is true. Returns the updated time off request, which remains in REQUESTED status when further approvals are still outstanding.

OAuth Scopes: time_off:requests.write

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

integer

required

The time off request ID.

Query Params

returnActions

boolean

Defaults to false

Set to true to include the _links block naming the state transitions available to the caller for this time off request. Also accepts 1, yes and on. Omitted from the response by default.

Body Params

Data contract for approving a time off request. All fields are optional.

managerNote

length ≤ 1024

An optional note recorded on the request by the approver. Maximum 1024 characters.

bypass

boolean

Defaults to false

When true, completes every remaining approval step instead of only the caller's. Requires authority to bypass the remaining approvers.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200The updated time off request.

400Malformed request body.

401Unauthorized. Missing or invalid authentication.

403Forbidden. The caller cannot approve this time off request.

404The time off request does not exist.

409The request is not in REQUESTED status, or approving it would bypass remaining approvers.

422Invalid request data (e.g. an over-long manager note or a non-boolean bypass), or the employment provider rejected the change.