---
title: "Disconnect a calendar"
method: DELETE
path: "/v1/calendars/{id}"
tags: ["Calendars"]
---

# Disconnect a calendar

`DELETE /v1/calendars/{id}`

## Request

- Base URL: `https://api.astrocal.dev`
- URL: `https://api.astrocal.dev/v1/calendars/{id}`
- Auth: HTTP bearer

Revokes the OAuth token at the provider and deletes the calendar connection. Dashboard users may only disconnect their own calendar unless they are an owner or admin. API keys carry organization-wide authority and may disconnect any connection.

## Path parameters

- `id` string, uuid, required

## Response `200`

Calendar disconnected

- object
  - `id` string, uuid, required
  - `deleted` boolean, required

## Other responses

- `401`: Unauthorized
- `403`: Caller does not own this connection and is not an admin
- `404`: Not found

---

[API](https://skmtc.dev/astrocal/apis/astrocal-api.md) · [All operations](https://skmtc.dev/astrocal/apis/astrocal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/astrocal/apis/astrocal-api/revisions/3b953e19a348?raw)