Create or Edit Reservation
POST /reservation
POST /reservation/{reservation_id}
POST /reservables/{reservable_id}/reserve
POST /reservation/template/{template_id}/reserve
Creates a reservation when no reservation_id is supplied, and edits a reservation when reservation_id is supplied (in URL and/or body).
Request Body
See the Reservation Create/Edit Input Object for request fields, validation, and examples. These four routes share the same handler. The resource-scoped route supplies the resource ID in the path. The template route takes its resource list from the specified template and is intended for basic bookings.
Response
Success Response (200 OK)
Response shape depends on mode:
- Single non-conflict reservation: returns one reservation object in
data. - A single multi-resource reservation with no conflicts returns the child reservation array in
data. - Multiple reservations or reservations saved with conflicts return
data.reservationsanddata.conflicts. - Validation and price preview modes can return a different shape.
- Includes
extra_fields.script_outputsand possibly recurring timestamps in some paths.
Error Responses
400 Bad Request: Invalid request or validation error401 Unauthorized: Authentication failed403 Forbidden: Permission error404 Not Found: Referenced resource/user/reservation not found409 Conflict: Conflict or too many recurring reservations
See the Reservations API overview for related endpoints and shared data structures.