Book time off
Request leave for yourself or, as a manager or admin, for someone else.
POST https://cotlet.dev/api/v1/timetastic/time-offs
write Confirm
Returns the request id, the days booked, the status and the approver. When a department limit blocks an employee booking for themselves, the call returns Timetastic's message and books nothing. The approver gets an email. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| who_for string required | string | Full name of the person the leave is for, as in the Who for field. |
| from_date string required | string | First day, YYYY-MM-DD. |
| to_date string required | string | Last day, YYYY-MM-DD. |
| leave_type string required | string | Leave type as the Type drop-down lists it, for example Holiday or Sick leave. |
| reason string | string | Optional reason the approver reads. |
| confirm_override boolean | boolean | Manager or admin only: book anyway when Timetastic shows a staffing warning. Defaults to false. |
Request
curl -X POST https://cotlet.dev/api/v1/timetastic/time-offs \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"who_for":"Ana Torres","from_date":"2026-12-21","to_date":"2026-12-24","leave_type":"Holiday","reason":"Christmas week"}'result = client.call("timetastic", "book_time_off", {"who_for":"Ana Torres","from_date":"2026-12-21","to_date":"2026-12-24","leave_type":"Holiday","reason":"Christmas week"})const result = await cotlet.call('timetastic', 'book_time_off', {"who_for":"Ana Torres","from_date":"2026-12-21","to_date":"2026-12-24","leave_type":"Holiday","reason":"Christmas week"});cotlet call timetastic book_time_off --data '{"who_for":"Ana Torres","from_date":"2026-12-21","to_date":"2026-12-24","leave_type":"Holiday","reason":"Christmas week"}'Example response
{
"request_id": "5129012",
"employee": "Ana Torres",
"leave_type": "Holiday",
"from": "2026-12-21",
"to": "2026-12-24",
"days": 4,
"status": "Pending",
"approver": "Priya Nair",
"warning": null
}