---
title: "Occupations (push)"
method: POST
path: "/occupations-update"
tags: ["Termino endpoints"]
---

# Occupations (push)

`POST /occupations-update`

Synchronization of changed reservations on the hotel side.
Usage:

 - Partner changes Slevomat reservation in their system and this endpoint is called to update the reservation in Termino/Slevomat
 - Data with reservations that were not originated from Termino/Slevomat are ignored


Updates of occupations in multiple hotels has to be sent in multiple requests.

## Request body

- object
  - `accessToken` string, required — Access token to your API.
  - `hotelId` union, required — Hotel id.
    - string
    - integer
  - `occupations` Occupation[], required — List of updated occupations.
    - `id` union, required — Your occupation id.
      - string
      - integer
    - `type` 'reservation', required — Type of occupation. `reservation` is only supported value
    - `status` string — Reservation status; optional and ignored for blockages.
    - `roomId` union — Your room id.
      - string
      - integer
    - `roomTypeId` union, required — Room type id.
      - string
      - integer
    - `created` string, date-time, required — Creation date and time in ISO 8601 format.
    - `term` DateInterval, required — DateInterval is [start, end) – end date is exclusive.
      - `start` string, date, required — Start date in the format 'yyyy-mm-dd'.
      - `end` string, date, required — End date in the format 'yyyy-mm-dd'. Exclusive.

## Response `200`

Successful response

- SuccessResponse
  - `success` boolean, required — Always true.

## Other responses

- `400` — Expected error

## Changes

- **2023-10-31** `371c7c53f22d` — 1 breaking, 4 info
  - added the new required request property `occupations/items/roomTypeId`
  - api tag `Termino endpoints` added
  - api tag `Push endpoints` removed
  - the request property `occupations/items/roomId` became optional
  - …1 more
- **2023-10-30** `e19082e0fb0f` — 1 breaking, 1 warning, 3 info
  - the request property `occupations/items/roomId` became required
  - removed the request property `occupations/items/roomTypeId`
  - api tag `Push endpoints` added
  - api tag `Termino endpoints` removed
  - …1 more

[Change history](https://skmtc.dev/slevomat/apis/termino-hotel-api/changes/occupations-update/post.md)

---

[API](https://skmtc.dev/slevomat/apis/termino-hotel-api.md) · [All operations](https://skmtc.dev/slevomat/apis/termino-hotel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/slevomat/termino-hotel-api/revisions/776409ba477b/schema)