Delete a calendar
Deletes a calendar and the events in it.
DELETE
/v1/calendars/:calendar_id
Permission
The key must be granted calendar.events.write
A key without it gets 403 insufficient_scope, with the missing permission named in details.
Deletes the calendar and every event in it.
Path parameters
| Field | Type | Description |
|---|---|---|
calendar_id required |
string |
Request
curl https://api.veruapis.com/v1/calendars/:calendar_id \
-X DELETE \
-H "Authorization: Bearer vak_live_..." \
-H "Idempotency-Key: $(uuidgen)"Idempotency-Key is required on every write. Retrying with the same key returns the original response rather than repeating the operation, so a timeout is something you retry rather than something you investigate.
Response
Answers 204.
Returns 204 with no body.
Errors
Every failure uses the same shape, with a stable string code you can branch on. See the error reference.
Related
- POST Create a calendar
- POST Create an event
- DELETE Delete an event
- POST Find a time that works
- POST Query free/busy
- GET Get a calendar
- GET Get an event
- GET List events in a calendar
- GET List calendars
- GET List events
- POST Respond to an invitation
- PATCH Update a calendar
- PATCH Update an event