Documentation

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.reservations and data.conflicts.
  • Validation and price preview modes can return a different shape.
  • Includes extra_fields.script_outputs and possibly recurring timestamps in some paths.

Error Responses

  • 400 Bad Request: Invalid request or validation error
  • 401 Unauthorized: Authentication failed
  • 403 Forbidden: Permission error
  • 404 Not Found: Referenced resource/user/reservation not found
  • 409 Conflict: Conflict or too many recurring reservations

See the Reservations API overview for related endpoints and shared data structures.