Skip to main content
PATCH
Change a listing's schedule

Authorizations

Authorization
string
header
required

Authorization: Bearer

Path Parameters

code
string
required

The listing's public code (8 characters, as in its URL on Housera).

Query Parameters

locale
enum<string>
default:en

The response language, ro or en. It changes error messages (title, detail), labels and, when the listing has an approved translation in that language, its title and description. Codes are the same in every language. It takes precedence over Accept-Language and over the account's language.

Available options:
ro,
en

Body

application/json
mode
enum<string>

Send mode.

Available options:
inherit,
own,
on_request
hours
object | null

Hours.

duration_min
enum<integer> | null

How long a viewing lasts, in minutes: 15, 30, 45, 60 or 90.

Available options:
15,
30,
45,
60,
90,
null
notice_min
enum<integer> | null

Booking notice.

Available options:
0,
60,
120,
240,
1440,
2880,
null
available_from
string<date> | null

Availability date.

confirmation
enum<string> | null

auto: a booking is confirmed at once. manual: the visitor sends a request, and you accept or decline it.

Available options:
auto,
manual,
null
runner
string<email> | null

Who runs the viewings.

Maximum string length: 254
occupant
object

The person living in the home: notify and phone. Kept with the listing's schedule.

confirm_pending
boolean

Confirming the waiting requests.

blocked_dates
object[] | null

The days off, as {from, to} date ranges (Y-m-d), at most 50.

Maximum array length: 50

Response

The request succeeded.

data
ListingViewingScheduleApiResource · object
required

The result of the request.