Skip to main content
AvailabilityVersion: v3

Update user availability schedule

PUT/calendars/schedules/{id}

Modify an existing schedule by updating its rules, timezone, and name All fields are optional - only provided fields will be updated.

Authorizations

Authorizationstringheaderrequired

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

Scope:calendars.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Path Parameters

idstringrequired

Unique identifier of the schedule to update

Example:sch123def456ghi789

Body

namestring

Human-readable name for the schedule

Example:Updated Business Hours
rulesobject[]

Updated schedule rules defining when the schedule is active

timezonestring

Updated timezone for the schedule (IANA timezone identifier)

Example:America/Los_Angeles

Response

Schedule updated successfully

scheduleobjectrequired

Schedule