Disconnect a calendar
POST
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.
apiKeyheader
AuthorizationBearer <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.
application/json- body
connectionId?stringOnly needed when more than one calendar account is connected.
Length
1 <= length <= 64confirm*booleanSet to true only after the person said yes to disconnecting.
Disconnected
application/json- response
disconnected*stringsummary*stringcurl -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."}