v1

latestOpenAPI 3.1.02026-07-26294215839.4 KB

Time Off

Public API

Update Time Off Request Status

Updates the status of an existing time off request. Valid statuses are approved, denied (or declined), and canceled. Owner/admins can approve out of turn by completing all workflow steps at once; other approvers complete only their current step.

OAuth Scopes: time_off.write

put/api/v1/time_off/requests/{requestId}/status

Path parameters

requestIdstring required

The ID of the time off request to update.

Request body

status'approved' | 'denied' | 'declined' | 'canceled' | 'cancelled' required

The new status for the time off request.

notestring

A note to attach to the change in status.

Example request

{
  "status": "approved",
  "note": "Looks good, approved!"
}

Response

The status has been updated successfully. The response body is an empty JSON object ({}) with Content-Type: application/json.

object required