Deny Time Off Request

post

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

Denies a time off request. A single denial is final: it completes the caller's step and discards any remaining steps in the approval chain, so the returned time off request is always in DENIED status.

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 denying 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

Changes who may deny, not what denying does. A denial always discards the remaining approval steps, so the request ends in DENIED either way. When false the caller must be a current approver on the chain; when true the caller is instead authorized by permission to bypass the remaining approvers. Denying while off the current step without this flag returns 409.

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 deny this time off request.

404The time off request does not exist.

409The request is not in REQUESTED status, or denying 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.