Add time off
Add vacation, a public holiday, sick leave or other time off for people.
POST https://cotlet.dev/api/v1/resource-guru/time-offs
write Confirm
Returns the entry with its ID. Bookings that clash with the time off move to the waiting list unless block_on_clash is true. Time off counts in reports only where it overlaps working hours. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| resource_ids integer[] required | integer[] | IDs of the people, placeholders or other resources to book, from list_resources. |
| from string required | string | First day, YYYY-MM-DD. |
| to string required | string | Last day, YYYY-MM-DD. |
| type string required | string | Vacation/Holiday (personal), Public holiday, Sick leave, Maternity/paternity leave or Compassionate leave. |
| details string | string | Notes on the time off. |
| block_on_clash boolean | boolean | True to fail instead of moving clashing bookings to the waiting list. |
Request
curl -X POST https://cotlet.dev/api/v1/resource-guru/time-offs \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"resource_ids":[1],"from":"from","to":"to","type":"type"}'result = client.call("resource-guru", "add_time_off", {"resource_ids":[1],"from":"from","to":"to","type":"type"})const result = await cotlet.call('resource-guru', 'add_time_off', {"resource_ids":[1],"from":"from","to":"to","type":"type"});cotlet call resource-guru add_time_off --data '{"resource_ids":[1],"from":"from","to":"to","type":"type"}'Example response
{
"id": 902116,
"resource_ids": [
18215
],
"from": "2026-12-16",
"to": "2026-12-20",
"type": "Vacation/Holiday (personal)",
"moved_to_waiting_list": 0
}