# Create or Update Reservation

**PUT /reservation/api/1/platform/{platform-code}/restaurant/{platform-restaurant-id}/reservation/{platform-reservation-id}/push**

Create a new reservation or provide updates about guests, deposits, status, etc.


## Servers
- Demo URL: https://api.trial.lsk.lightspeed.app (Demo URL)
- Production URL: https://api.lsk.lightspeed.app (Production URL)


## Authentication methods
- O auth2


## Parameters

#### Path parameters
- **platform-code** (string)
  The unique code assigned to the reservation platform.
- **platform-restaurant-id** (string)
  The external platform's unique identifier for the restaurant.
- **platform-reservation-id** (string)
  The external identifier of the reservation.


## Body parameters
Content-type: application/json

- **guest** (object)
  Guest information associated with the reservation.
- **liability** (object)
  The guest's obligation for the reservation.
- **notes** (string)
  Venue-entered notes specific to the reservation.
- **specialOffer** (string)
  Any special offer linked to the reservation.
- **tags** (array[string])
  Tags linked to this reservation. See [Reservation Tags](https://api-portal.lsk.lightspeed.app/guides/reference/reference-tables/reservation-tags) table for a list of tags with available translations. All others will be displayed as provided in the request body.
- **partySize** (integer(int32))
  The number of expected guests.
- **sequenceId** (integer(int64))
  An optional sequence number assigned by the external platform. If provided, it will be used to determine the order of updates of a reservation. It is the responsibility of the external platform to provide a monotonically increasing sequence number.
If omitted, the utcUpdatedAt field will be used to determine the order of updates. That can be imprecise when dealing with events that happen in short timeframes in a distributed system.
The value SHOULD NOT be set to null or zero or any special value, but instead omitted from the JSON object entirely if it is not used.

- **status** (string)
  External reservation statuses for platforms.
- **tableNumbers** (array[string])
  The list of table numbers associated with this reservation.
If no valid table is provided, POS order is not created.

- **utcScheduledAt** (string(date-time))
  The scheduled reservation time.
- **utcUpdatedAt** (string(date-time))
  The timestamp of the most recent change to the reservation.

- **guestRequest** (string)
  Notes added to the reservation by the guest.
- **expectedDuration** (string(duration))
  Expected duration of the meal. ISO-8601 format.

## Responses
### 202: Accepted

#### Body Parameters: application/json (object)
- **platformCode** (string)
  The unique code assigned to the reservation platform.
- **platformRestaurantId** (string)
  The external platform's unique identifier for the restaurant.
- **platformReservationId** (string)
  The external platform's unique identifier for the reservation.
- **accepted** (boolean)
  Whether the reservation request was accepted.

### 400: Non relevant request

### 403: Scope 'reservation-{platform-code}' not found in the token

### 404: Integration not found


[Powered by Bump.sh](https://bump.sh)