v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Time Off Requests

Decline a time off request

Decline a pending or approved time off request. Requires an employer_note.

scope: time_off_requests:manage

put/v1/time_off/requests/{time_off_request_uuid}/decline

Path parameters

time_off_request_uuidstring required

The UUID of the time off request

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Request body

employer_notestring required

Note explaining why the request was declined

approver_uuidstring

The UUID of the admin declining the request. Defaults to the company's primary payroll admin.

Response

successful

uuidstring required

The UUID of the time off request.

status'pending' | 'approved' | 'declined' | 'consumed' required

The status of the time off request.

employee_notestring nullable required

A note about the time off request, from the employee to the employer.

employer_notestring nullable required

A note about the time off request, from the employer to the employee.

policy_typestring nullable required

The type of the time off policy (e.g. vacation, sick).

policy_uuidstring nullable required

The UUID of the time off policy associated with this request.

daysobject required

An object where keys are dates in YYYY-MM-DD format and values are hours as string decimals (e.g. {"2025-01-20": "8.000"}).

Example response

{
  "uuid": "ad158cfb-99e4-4741-9db3-0bd3a267f222",
  "status": "pending",
  "employee_note": "Family vacation",
  "policy_type": "vacation",
  "policy_uuid": "c2d9b1bd-3f36-4c2d-a727-b2af057d6a7f",
  "days": {
    "2026-10-20": "8.000",
    "2026-10-21": "8.000"
  },
  "employee": {
    "uuid": "51924fa0-26c6-4d4c-8832-3ef0b422c67e",
    "full_name": "Alex Johnson"
  },
  "initiator": {
    "uuid": "51924fa0-26c6-4d4c-8832-3ef0b422c67e",
    "full_name": "Alex Johnson"
  },
  "approver": {
    "uuid": "21d8dff4-ce09-4120-a274-3a5628bf6769",
    "full_name": "Morgan Chen"
  }
}