Skip to Content
WalidoDocs
Public APICalendars

Delete a calendar

DELETE
/calendars/{calendar_id}

Deletes a calendar. Fails with 409 conflict if the calendar is still assigned to one or more assistants or a website widget's availability uses it - unlink it from every assistant first (via the Assistants endpoint) and from the widget in the dashboard, then retry. Also returns 409 while the organization is busy with a conflicting change such as its deletion.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the Walido dashboard (Settings → API Keys).

Path Parameters

calendar_id*string
Match^[a-f0-9]{24}$

Response Body

Deleted.

application/json
  1. response
data?

Empty - present for envelope consistency.

Example Request
curl -X DELETE 'https://api.walido.it/api/v1/calendars/65f8fa6f1a9d8e0012ab34cd'
Example Response
{  "data": {}}