Delete an agent calendar
POST
Permanently deletes a calendar that was made for an agent, with all its meetings. A calendar the person already had is never deleted from here. Without confirm: true it is refused with a sentence that names what would be lost.
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
calendarId*stringThe calendar to delete, one made for an agent (the list marks those).
Length
1 <= length <= 320confirm*booleanSet to true only after the person said yes to permanently deleting the calendar and its meetings.
connectionId?stringOnly needed when more than one calendar account is connected.
Length
1 <= length <= 64Deleted
application/json- response
removed*stringsummary*stringcurl -X POST https://api.vlayers.ai/v1/calendar/calendars/remove \ -H "Authorization: Bearer $VOICELAYER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "calendarId": "[email protected]", "confirm": true }'Example Response
{ "removed": "[email protected]", "summary": "Deleted the calendar \"Sales agent\" and its meetings."}