agents

Update calendar settings

Partial update of a calendar link — work hours, timezone, default duration, buffer minutes, active flag, double-booking permission. Use for seasonal schedule changes, timezone updates after relocation, or enabling/disabling booking temporarily.

patch/agents/{id}/calendars/{calendarId}

Request

  • Base URL: https://be.skipcalls.com (the document declares no server; this is the origin it was published from)
  • URL: https://be.skipcalls.com/agents/{id}/calendars/{calendarId}
  • Auth: HTTP bearer

Path parameters

idstring required
calendarIdstring required

Request body

calendarIdstring
descriptionstring
defaultDurationnumber
bufferMinutesnumber
timezonestring
workHoursByDayobject

Work hours by day in HHMM format (e.g., {"MONDAY": [900, 1730]})

workDaysstring[]
isActiveboolean

Allow event creation on this calendar

showEventNamesboolean

Share event names with callers instead of just busy/free times

allowDoubleBookingboolean

Allow booking overlapping appointments on the same time slot

Example request

{
  "workHoursByDay": {
    "MONDAY": [
      900,
      1730
    ],
    "TUESDAY": [
      900,
      1730
    ],
    "WEDNESDAY": [
      900,
      1730
    ],
    "THURSDAY": [
      900,
      1730
    ],
    "FRIDAY": [
      900,
      1730
    ]
  }
}

Changes

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