---
title: "Delete connection"
method: DELETE
path: "/connection/{id}"
tags: ["Connections"]
---

# Delete connection

`DELETE /connection/{id}`

## Request

- Base URL: `https://api.elaichi.ai`
- URL: `https://api.elaichi.ai/connection/{id}`
- Auth: HTTP bearer

Permanently deletes the connection and its stored credential. The only way back is for the owner to authenticate with the provider again through a fresh connect flow. It also cascades: toolbox entries pinned to the connection stop resolving, and every grant on it is discarded. To hand the connection to someone else instead, use `POST /connection/{id}/transfer`. Owner only; an `edit` share does not reach delete.

## Path parameters

- `id` string, required

## Headers

- `X-Organization-Id` string

## Response `200`

Success

- Success
  - `success` boolean, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited

---

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