PUT
/
employer
/
time-off-events
/
{time-off-event-id}
Update Time-Off Event
curl --request PUT \
  --url https://api.tryfinch.com/employer/time-off-events/{time-off-event-id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Finch-API-Version: <finch-api-version>' \
  --data '{
  "status": "requested",
  "policy_type": "pto",
  "event_type": "vacation",
  "start_date": "2023-11-07T05:31:56Z",
  "end_date": "2023-11-07T05:31:56Z"
}'
{
  "time_off_event_id": "e1f2a3b4-c5d6-7e8f-9a0b-1c2d3e4f5a6b",
  "job_id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d"
}

Authorizations

​
Authorization
string
header
required

Please use your Access Token

Headers

​
Finch-API-Version
string<date>
default:2020-09-17
required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Path Parameters

​
time-off-event-id
string<uuid>
required

The unique identifier for the time-off event

Body

application/json

Request body for updating an existing time-off event.

​
status
enum<string>
required

The status of the time-off request.

Available options:
requested,
approved,
declined,
cancelled,
deleted
​
event_type
enum<string>
required

The specific type of time-off event.

Available options:
vacation,
sick,
personal,
jury_duty,
volunteer,
bereavement,
other
​
start_date
string<date-time> | null
required

ISO 8601 datetime format (YYYY-MM-DDTHH:MM:SS). Default timestamps for start_date and end_date are 00:00:00 (beginning of day) and 23:59:59 (end of day), respectively. Note: Datetime values are represented in the timezone they are reflected in the provider.

​
end_date
string<date-time> | null
required

ISO 8601 datetime format (YYYY-MM-DDTHH:MM:SS). Default timestamps for start_date and end_date are 00:00:00 (beginning of day) and 23:59:59 (end of day), respectively. Note: Datetime values are represented in the timezone they are reflected in the provider.

​
policy_type
enum<string> | null

The type of time-off policy.

Available options:
pto,
sick,
parental,
unpaid,
other

Response

Time-off event update initiated

​
time_off_event_id
string<uuid>
required

The id of the time-off event.

​
job_id
string<uuid>
required