Skip to content
DELETE /connection/{id}

IRREVERSIBLE AND DESTRUCTIVE. The vaulted credential is deleted first: 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 it stop resolving, and every grant on it is discarded with it. To move a connection to someone else instead, use `POST /connection/{id}/transfer`. Allowed for the owner only, full stop — no `connection:manage` fallback any more (removed 2026-09-04). An `edit` share does not reach delete either (docs/access-model.md §6).

Path Parameters

idstring
required·

Connection id (conn_…).

Response Body

successboolean
curl -X DELETE 'https://api.elaichi.ai/connection/<id>' \
  -H 'Authorization: Bearer $ELAICHI_API_TOKEN' \
  -H 'Content-Type: application/json'
const response = await fetch('https://api.elaichi.ai/connection/<id>', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer ' + process.env.ELAICHI_API_TOKEN,
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
import os
import requests

url = "https://api.elaichi.ai/connection/<id>"
headers = {
    "Authorization": f"Bearer {os.environ['ELAICHI_API_TOKEN']}",
    "Content-Type": "application/json",
}

response = requests.delete(url, headers=headers)
print(response.json())