GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

Approve a time off request

Approve a pending time off request. Optionally override the dates and hours.

Only requests with a pending status can be approved. Attempting to approve a request that has already been declined or consumed will fail with a 422 error.

scope: time_off_requests:manage

Path Params
string
required

The UUID of the time off request

Body Params
string

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

string

A note from the employer about the approval

days
object

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"}). Use this to override the requested hours.

Headers
string
enum
Defaults to 2026-02-01

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

Allowed:
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json