Time Off API
The Time Off API allows you to manage staff leave requests — creating, approving, rejecting, and deleting them programmatically.
What You Can Do
- List all time-off requests, with optional filters by staff member, status, and date range
- Create a time-off request on behalf of a staff member
- Approve or reject pending requests
- Delete a request
Statuses
| Status | Description |
|---|---|
pending | Awaiting review |
approved | Approved by a manager |
rejected | Rejected by a manager |
Requests from staff
Staff can ask for days off from their own availability link.
Those requests arrive with status pending. When you approve or reject one, through this API or
anywhere else, the staff member gets an email saying so.
Base Path
All time-off endpoints are prefixed with /v1/staff/time-off.
Authentication
All endpoints require a bearer API key. Read operations require staff:read; write operations require staff:write.