PUT
Admin upsert room listing

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 admin upsert room listing.

Landlord admin: create or replace the listing overlay for one room.

headline
string
required

headline value for upsert listing request.

Required string length: 1 - 200
description
string | null

Human-readable description for the resource or line item.

Maximum string length: 4000
amenities
string[] | null

amenities value for upsert listing request.

contact_phone
string | null

contact phone value for upsert listing request.

Maximum string length: 40
zalo_url
string | null

zalo url value for upsert listing request.

Maximum string length: 500
available_date
string<date> | null

available date value for upsert listing request.

min_lease_months
integer<int32> | null

min lease months value for upsert listing request.

Required range: 0 <= x <= 60
images
object[] | null

images value for upsert listing request.

Response

Created or updated room listing

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.