---
title: "Remove Connection"
method: DELETE
path: "/api/connections/{connection_id}"
tags: ["connections"]
---

# Remove Connection

`DELETE /api/connections/{connection_id}`

## Request

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

Archive the connection and revoke the grant.

The row is kept — the audit trail refers to it, and "undo" has to remain
possible (plan §2.5). What is destroyed is the token, at Nango.

## Path parameters

- `connection_id` string, uuid, required

## Headers

- `authorization` string, nullable
- `x-workspace-id` string, nullable

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

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