---
title: "Disconnect Connection"
method: POST
path: "/api/integration-connections/{id}/disconnect"
tags: ["integration-connections", "integration-connections"]
---

# Disconnect Connection

`POST /api/integration-connections/{id}/disconnect`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/integration-connections/{id}/disconnect`
- Auth: none declared

Revoke an integration connection.

Best-effort provider revocation (SAVEPOINT-isolated) + local token scrub +
mark as revoked. Idempotent: disconnecting an already-revoked connection
returns success.

Returns 200 with {"status": "revoked"} on success (both newly revoked and
already-inactive cases). Returns 404 if the connection does not exist or
belongs to a different workspace (confused-deputy guard).

## Path parameters

- `id` integer, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)