Leave Requests
Create, approve and track time off
GET
/api/v1/leave-requestsList leave requests
Returns leave requests for the authenticated user (or all if admin).
Parameters
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| status | string | query | |
| user_id | string(uuid) | query | Filter by user (admin only) |
curl https://api.offly.net/api/v1/leave-requests \
-H "Authorization: Bearer YOUR_API_KEY"Try it
Do not use production API keys on shared devices. Keys are stored in memory only.
POST
/api/v1/leave-requestsCreate a leave request
Creates a new leave request for the authenticated user.
Request body
| Field | Type | Description |
|---|---|---|
| leave_type_id* | string(uuid) | |
| start_date* | string(date) | |
| end_date* | string(date) | |
| start_half_day | string | |
| end_half_day | string | |
| note | string |
Response
| Field | Type | Description |
|---|---|---|
| id | string(uuid) | |
| user_id | string(uuid) | |
| leave_type_id | string(uuid) | |
| status | string | |
| start_date | string(date) | |
| end_date | string(date) | |
| start_half_day | string| null | |
| end_half_day | string| null | |
| total_days | number | |
| note | string| null | |
| created_at | string(date-time) |
curl -X POST https://api.offly.net/api/v1/leave-requests \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'Try it
Do not use production API keys on shared devices. Keys are stored in memory only.
GET
/api/v1/leave-requests/{id}Get a leave request
Parameters
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| id* | string(uuid) | path |
Response
| Field | Type | Description |
|---|---|---|
| id | string(uuid) | |
| user_id | string(uuid) | |
| leave_type_id | string(uuid) | |
| status | string | |
| start_date | string(date) | |
| end_date | string(date) | |
| start_half_day | string| null | |
| end_half_day | string| null | |
| total_days | number | |
| note | string| null | |
| created_at | string(date-time) |
curl https://api.offly.net/api/v1/leave-requests/{id} \
-H "Authorization: Bearer YOUR_API_KEY"Try it
Do not use production API keys on shared devices. Keys are stored in memory only.
PATCH
/api/v1/leave-requests/{id}Edit a leave request
Edits a pending leave request.
Parameters
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| id* | string(uuid) | path |
Request body
| Field | Type | Description |
|---|---|---|
| start_date | string(date) | |
| end_date | string(date) | |
| start_half_day | string| null | |
| end_half_day | string| null | |
| note | string |
Response
| Field | Type | Description |
|---|---|---|
| id | string(uuid) | |
| user_id | string(uuid) | |
| leave_type_id | string(uuid) | |
| status | string | |
| start_date | string(date) | |
| end_date | string(date) | |
| start_half_day | string| null | |
| end_half_day | string| null | |
| total_days | number | |
| note | string| null | |
| created_at | string(date-time) |
curl -X PATCH https://api.offly.net/api/v1/leave-requests/{id} \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'Try it
Do not use production API keys on shared devices. Keys are stored in memory only.
POST
/api/v1/leave-requests/{id}/cancelCancel a leave request
Cancels a pending or approved leave request.
Parameters
Parameters
| Name | Type | In | Description |
|---|---|---|---|
| id* | string(uuid) | path |
Response
| Field | Type | Description |
|---|---|---|
| id | string(uuid) | |
| user_id | string(uuid) | |
| leave_type_id | string(uuid) | |
| status | string | |
| start_date | string(date) | |
| end_date | string(date) | |
| start_half_day | string| null | |
| end_half_day | string| null | |
| total_days | number | |
| note | string| null | |
| created_at | string(date-time) |
curl -X POST https://api.offly.net/api/v1/leave-requests/{id}/cancel \
-H "Authorization: Bearer YOUR_API_KEY"Try it
Do not use production API keys on shared devices. Keys are stored in memory only.