# Bağlantıyı sil

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

Bağlantıyı siler; kullanıcı verisi silinmez. `If-Match` zorunludur. Etkin bağlantıdan kimliği olan kullanıcı varsa silme `connection_in_use` ile başarısız olur; önce bağlantıyı devre dışı bırakın. Bağlantı uygulama bağlantı listelerinden de düşer. Silinen bağlantı 30 gün içinde [`:restore`](restore.md) ile `inactive` olarak geri yüklenebilir; sonra kalıcı silinir.

## İstek

| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| `connection_id` | string | evet | Bağlantı kimliği (`conn_…`). |
| `If-Match` | başlık | evet | Bağlantının son okunan `ETag` değeri. Yoksa `428`, eskiyse `412`. |

## Yanıt

`204 No Content`, gövde yok.

## Hatalar

| HTTP | code | Ne zaman |
|---|---|---|
| 404 | `not_found` | Bağlantı yok ya da başka bir ortama ait. |
| 409 | `connection_in_use` | Kullanıcıların bu etkin bağlantıdan kimlikleri var; önce devre dışı bırakın. |
| 412 | `precondition_failed` | `If-Match` güncel sürümle eşleşmiyor. |
| 428 | `precondition_required` | `If-Match` başlığı yok. |
| 401 | `unauthenticated` | Kimlik bilgisi yok, geçersiz ya da iptal edilmiş. |
| 403 | `insufficient_permissions` | Kimlik bilgisinde gerekli izin yok. |
| 429 | `rate_limited` | Hız sınırı aşıldı; `Retry-After` süresinden sonra yeniden deneyin. |
| 503 | `service_unavailable` | Bir bağımlılık geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin. |

## Örnek

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