Disconnect a calendar

POST
/v1/calendar/disconnect

Disconnects a calendar account from VoiceLayer. The person's meetings stay in their calendar; booking pages that use the account stop working until it is connected again. Without confirm: true it is refused with a sentence that says what stops.

Requires an API key with the calendar:use scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Request Body

application/json
  1. body
connectionId?string

Only needed when more than one calendar account is connected.

Length1 <= length <= 64
confirm*boolean

Set to true only after the person said yes to disconnecting.

Response Body

Disconnected

application/json
  1. response
disconnected*string
summary*string
Example Request
curl -X POST https://api.vlayers.ai/v1/calendar/disconnect \  -H "Authorization: Bearer $VOICELAYER_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "confirm": true  }'
Example Response
{  "disconnected": "0192f5c0-1a2b-7c3d-8e4f-5a6b7c8d9e01",  "summary": "Disconnected Google Calendar. Your meetings are still in your calendar; ask for a connect link to connect again."}