Native booking staff members api

Update staff member's availability

Partially updates the staff member's working hours: timezone, weekly availability and date overrides are each updated only when present in the request, and keep their current value when omitted. Note the difference between omitting availability or overrides and sending an empty array - an empty array clears the existing entries, which for availability leaves the staff member bookable at no time at all. When availability is present it replaces the whole weekly schedule rather than being merged into the existing slots, so send the complete set of slots you want.

put/api/sites/multiscreen/{site_name}/booking/staff-members/{id}/availability

Request

  • Base URL
    https://api.duda.co
  • URL
    https://api.duda.co/api/sites/multiscreen/{site_name}/booking/staff-members/{id}/availability
  • Auth
    HTTP basic

Path parameters

site_namestring required

The site's unique name (its ID), returned when the site is created.

idstring required

Request body

time_zonestring nullable

Timezone for the schedule (e.g., 'America/New_York', 'Europe/London', 'UTC'). If omitted, the timezone remains unchanged.

Example request

{
  "availability": [
    {
      "days": [
        "Monday",
        "Tuesday",
        "Wednesday",
        "Thursday",
        "Friday"
      ],
      "end_time": "17:00",
      "start_time": "09:00"
    }
  ],
  "overrides": [
    {
      "date": "2024-12-25",
      "end_time": "14:00",
      "start_time": "10:00"
    }
  ],
  "time_zone": "America/New_York"
}

Response

OK

time_zonestring nullable

Timezone for the schedule (e.g., 'America/New_York', 'Europe/London', 'UTC')

Example response

{
  "availability": [
    {
      "days": [
        "Monday",
        "Tuesday",
        "Wednesday",
        "Thursday",
        "Friday"
      ],
      "end_time": "17:00",
      "start_time": "09:00"
    }
  ],
  "overrides": [
    {
      "date": "2024-12-25",
      "end_time": "14:00",
      "start_time": "10:00"
    }
  ],
  "time_zone": "America/New_York"
}

Changes

No recorded changes to this operation across all 1 revision of this API.