PATCH
Update room status

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

room_id
string<uuid>
required

Room ID

Body

application/json

JSON payload used to update room status.

Request payload for update room status.

status
enum<string>
required

Operational intent (see UpdateRoomRequest.status). OCCUPIED is rejected with room_occupancy_not_settable.

Available options:
VACANT,
OCCUPIED,
HIDDEN,
MAINTENANCE
reason
string | null

Operator-provided reason for a lifecycle action.

Maximum string length: 500

Response

Updated room status

data
object
required

Endpoint-specific response payload. See the referenced schema for the resource fields.

request_id
string
required

Request correlation identifier returned from X-Request-Id or generated by the API.

meta
object

Optional response metadata such as pagination limits, counts, or export context.