Skip to main content
PUT
cURL

Partial updates

Send only the fields you change. A field you leave out keeps its value.

The hours replace the whole week

hours is one value, not a list you add to. The week you send becomes the week that is stored, and every weekday you leave out becomes closed.
That schedule is now open on Monday morning and closed on every other day. To keep Tuesday open, send Tuesday as well. working_days follows the days that have hours, so you never send it.

Two effects to know

  • A new timezone moves the real times. The hours stay as written, so 09:00 becomes 09:00 in the new timezone. A person in the old timezone sees a different hour.
  • Booked events do not move. A schedule only decides which times are free from now on.

Access

You can only change schedules on your own account. Another account’s schedule returns 403 access_denied.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
integer
required

ID of the availability schedule to update

Body

application/json

Availability fields to update. Partial updates are supported.

Fields to update. Send only the fields you want to change. Fields you omit keep their current value.

name
string

The name of the schedule

Maximum string length: 255
Example:

"Mornings only"

timezone
string

IANA timezone the hours are expressed in

Example:

"Europe/Belgrade"

hours
object

Open hours per weekday, in the schedule timezone. This replaces the whole week, so a weekday you leave out becomes closed.

Example:

Response

200 - application/json

Availability updated

success
boolean
required

Indicates whether the request was successful

Example:

true

data
object
required