v3

latestSwagger 2.02026-08-067506752.0 MB
timeoff

Update an existing time off request

patch/v1/org/{orgId}/timeoff/{timeOffId}

Path parameters

orgIdstring required

Org identifier (either id or slug)

timeOffIdstring required

TimeOff id

Request body

externalIdstring

external identifier, if time off synced from external system

startDatestring date

start date of time off, inclusive

startDatePartialDaynumber

portion of the start date to take

startDatePartialDayPeriod'AM' | 'PM'

Portion of the start day requested (e.g. AM or PM)

endDatestring date

end date of time off, inclusive

endDatePartialDaynumber

portion of the end date to take

endDatePartialDayPeriod'AM' | 'PM'

Portion of the end day requested (e.g. AM or PM)

daysnumber

number of days used

hoursnumber

number of hours used

typeDescriptionstring

type of time off

timeOffPolicyIdstring

policy id to pull the balance from

notestring

notes on the time off

approval'APPROVED' | 'PENDING' | 'CANCELLED' | 'REJECTED' | 'SUPERSEDED'

approval status of the time off

requestAtstring

requested at timestamp -- often the same as createAt

Example request

{
  "timeOffPolicyId": "588f7ee98f138b19220041a7",
  "requestAt": "2017-01-24T13:57:52Z"
}

Response

time off updated