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

# Delete connection

`DELETE /api/v1/connections/{id}`

Archive a connection (move to trash). Archived connections can be restored from the trash in the connection settings UI.

A connection that is already archived returns 410.

## Path parameters

- `id` string, uuid, required — Connection ID

## Response `200`

Connection moved to trash

- object — Archive connection response
  - `message` string, required — Status message describing the result
  - `success` boolean, required — True when the connection was archived

## Other responses

- `401` — Authentication required
- `403` — Permission denied - connection admin role required
- `404` — Connection not found
- `410` — Connection has already been archived

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/de7cac8b5983/schema)