Create a blocked period

POST

/fleets/vehicles/{vehicle_id}/blocked-periods

Blocks the vehicle for rentals between the start and the end you send. Send the dates and times in the API user's time zone; they are stored in UTC.

The period is rejected with a business error when the start is after the end, or when the vehicle class has no free unit in that window, because blocking the vehicle would overbook reservations (message: "By creating this blocked period in this interval it will cause an overbooking").

The response returns the dates in UTC.

Request

Authorization

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "start_date_date": "2026-10-12",
    "start_date_time": "08:00",
    "end_date_date": "2026-10-14",
    "end_date_time": "18:00",
    "description": "Body shop",
    "color": "#cc4915"
}

Responses

🟢200OK

application/json

The saved blocked period in data.blocked_period, with its dates in UTC. HTTP 200 is also used for failures: always check success. When it is false, the body is an ErrorBusinessRule (status_code 410) or an ErrorUnauthorized (status_code 401 or 403).

Bodyapplication/json

Examples

savedoverbooking

Blocked period saved

{"success":true,"status_code":200,"errors":[],"data":{"blocked_period":{"id":318,"start_date":"2026-10-12 12:00:00","end_date":"2026-10-14 22:00:00","description":"Body shop","color":"#cc4915","created_at":"2026-10-07 15:02:11","updated_at":"2026-10-07 15:02:11","vehicle":{"id":57,"label":"Toyota Corolla - KLM 4821","plate":"KLM 4821","status":"available"}}}}

🟠404Record Not Found

🟠422Parameter Error

Modified at 2026-10-29 13:52:44

List the blocked periods of a vehicle

Update a blocked period