API Reference
Start typing to search…

Create a leave time off

post
https://api.runn.io/time-offs/leave/

Create or Update

This endpoint may return an existing time off if the new time off is a subset of an existing one.

Automatic Merging

If one or more existing time offs overlap with the specified start/end date, they will be automatically merged.

Partial Time Offs

If the minutesPerDay field is provided, automatic merging will only occur if any overlapping time off has the same minutesPerDay value. If the minutesPerDay value differs, the request will fail.

Body Params
integer
required

The unique identifier for the person.

date
required

The start date of the time-off. Format: YYYY-MM-DD

date
required

The end date of the time-off. Format: YYYY-MM-DD

string

A note or comment related to the time-off, if any.

integer | null
≥ 15

The minutes per day taken as time off. Omit this property if time-off is for full day(s) as per person's contract.

Headers
enum
required
Defaults to 1.0.0
Allowed:
Responses

Updated 2 days ago

Language
Credentials
Bearer
URL
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 2 days ago