Update calendar settings

PATCH

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

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.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/agents//calendars/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "calendarId": "string",
    "description": "string",
    "defaultDuration": 30,
    "bufferMinutes": 15,
    "timezone": "UTC",
    "workHoursByDay": {
        "MONDAY": [
            900,
            1730
        ],
        "TUESDAY": [
            900,
            1730
        ],
        "WEDNESDAY": [
            900,
            1730
        ],
        "THURSDAY": [
            900,
            1730
        ],
        "FRIDAY": [
            900,
            1730
        ]
    },
    "workDays": [
        "MONDAY",
        "TUESDAY",
        "WEDNESDAY",
        "THURSDAY",
        "FRIDAY"
    ],
    "isActive": true,
    "showEventNames": false,
    "allowDoubleBooking": false
}'

Modified at 2026-07-23 18:02:16

Duplicate an agent-calendar link (virtual calendar)

Disconnect calendar from agent