COconnecteam
Time Off:v1:TimeOffRequests

Update time off request

Changed on

Update an existing time-off request. The time-off request can be modified with new dates, times, status, or notes.

put/time-off/v1/requests/{requestId}

Request

  • Base URL
    https://api.connecteam.com
  • URL
    https://api.connecteam.com/time-off/v1/requests/{requestId}
  • Auth
    • API key in header X-API-KEY
    • or OAuth 2
      Client credentials
      Token URL: /oauth/v1/token scopes: time_off.write

Path parameters

requestIdstring required

The unique identifier of the time off request

Request body

timeClockIdinteger

The unique identifier of the time clock where the time off will be presented in the timesheet

isAllDayboolean

Specifies the type of the time period. If set to false, start and end time fields must be specified.

startDatestring

The start date of the time off in ISO format (YYYY-MM-DD)

endDatestring

The end time of the time off in ISO format (YYYY-MM-DD). End date must be similar to Start date if isAllDay set to false.

startTimestring

The start time of the time off in ISO format (HH:MM:SS). This field is required if isAllDay set to false.

endTimestring

The end time of the time off in ISO format (HH:MM:SS). This field is required if isAllDay set to false.

timezonestring

The timezone in Tz format (e.g. America/New_York)

status'approved' | 'pending' | 'denied'

The status of the time off request.

managerNotestring

Manager note providing additional details

isAdjustForDayLightSavingboolean

Specifies if the time given should offset the daylight savings time change if the time falls exactly on the daylight savings time change. Set to true only if the time coincides with the rollback hour, otherwise, it should remain false.

Response

Successful Response

requestIdstring

Changes