---
title: "Connections Revoke"
method: DELETE
path: "/connections/{connection_id}"
---

# Connections Revoke

`DELETE /connections/{connection_id}`

## Request

- Base URL: `https://www.clipzyn.com/v1`
- URL: `https://www.clipzyn.com/v1/connections/{connection_id}`
- Auth: HTTP bearer

Revoke a connection: status revoked, encrypted token row deleted, audited.

Idempotent, so a client that lost the response may safely repeat it; the
ciphertext is never resurrected. An unknown or foreign connection is
not_found, identical to one that never existed. Do not retry a not_found. Requires the explicitly minted `bernayser:write` scope; bernayser:read permits safe projections and bernayser:write permits mutations. This BERNAYSER operation is quota-neutral. While dark it returns not_found, and a valid key without the required scope receives scope_missing. Fix a non-retryable request or credential before retrying; for rate_limited or service_unavailable, wait for retry_after_sec and retry once.

## Path parameters

- `connection_id` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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