# Eliminar una conexión

`DELETE /v1/connections/{connection_id}` · permiso `connections:write`

Elimina una conexión. Los datos de usuario no se eliminan. `If-Match` es requerido. Si los usuarios tienen identidades de una conexión activa, la eliminación falla con `connection_in_use`; desactive la conexión primero. La conexión también se elimina de las listas de conexiones de aplicaciones. Una conexión eliminada puede restaurarse como `inactive` dentro de 30 días con [`:restore`](restore.md); después se elimina de forma permanente.

## Solicitud

| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| `connection_id` | string | sí | Identificador de conexión (`conn_…`). |
| `If-Match` | header | sí | El `ETag` de la conexión como se leyó por última vez. Falta: `428`; obsoleto: `412`. |

## Respuesta

`204 No Content`, sin cuerpo.

## Errores

| HTTP | código | Cuándo |
|---|---|---|
| 404 | `not_found` | La conexión no existe o pertenece a otro entorno. |
| 409 | `connection_in_use` | Los usuarios aún tienen identidades de esta conexión activa; desactívela primero. |
| 412 | `precondition_failed` | `If-Match` no coincide con la versión actual. |
| 428 | `precondition_required` | Falta el encabezado `If-Match`. |
| 401 | `unauthenticated` | La credencial falta, es inválida o ha sido revocada. |
| 403 | `insufficient_permissions` | La credencial carece del permiso requerido. |
| 429 | `rate_limited` | Se superó el límite de velocidad; reintente después del período `Retry-After`. |
| 503 | `service_unavailable` | Una dependencia no está disponible temporalmente; reintente después del período `Retry-After`. |

## Ejemplo

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/connections/conn_0k3v8m1q2x9dz4h7s5t6w0y1ab \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "2"'
```