Create a time off request

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

userId*string

Requesting user ID.

timeOffTypeId*string

Time off type ID.

startDate*string

Start date.

endDate*string

End date.

availability*number

Daily available hours (0-24).

reason*string

Reason for request.

status?string

Optional initial status. Use pending for normal request flow.

Value in"pending" | "approved" | "rejected"

Response Body

`application/json`

curl -X POST "https://loading/api/v1/time-off" \  -H "Content-Type: application/json" \  -d '{    "userId": "019cb675-c4df-7f8b-8a83-5f28581f5e7e",    "timeOffTypeId": "019cb675-c4d6-7e90-8806-25e5145c3a06",    "startDate": "2026-02-03",    "endDate": "2026-02-05",    "availability": 0,    "reason": "Vacation",    "status": "pending"  }'

{
  "data": {
    "userId": "019cb675-c4df-7f8b-8a83-5f28581f5e7e",
    "timeOffTypeId": "019cb675-c4d6-7e90-8806-25e5145c3a06",
    "startDate": "2026-02-03",
    "endDate": "2026-02-05",
    "availability": 0,
    "reason": "Vacation",
    "status": "pending"
  }
}

Empty

Authorization

Request Body

Response Body

200application/json

400

401

403

404

`application/json`