# 연결 삭제

`DELETE /v1/connections/{connection_id}` · 권한 `connections:write`

연결을 삭제합니다. 사용자 데이터는 삭제되지 않습니다. `If-Match`는 필수입니다. 사용자가 활성 연결의 식별자를 가지고 있으면 삭제가 `connection_in_use`로 실패합니다. 먼저 연결을 비활성화하세요. 연결은 애플리케이션 연결 목록에서도 제거됩니다. 삭제된 연결은 30일 이내에 [`:restore`](restore.md)로 `inactive` 상태로 복원할 수 있습니다. 그 이후에는 영구적으로 삭제됩니다.

## 요청

| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
| `connection_id` | string | 예 | 연결 식별자 (`conn_…`). |
| `If-Match` | header | 예 | 마지막으로 읽은 연결의 `ETag`. 누락: `428`; 만료: `412`. |

## 응답

`204 No Content`, 본문 없음.

## 오류

| HTTP | code | 조건 |
|---|---|---|
| 404 | `not_found` | 연결이 없거나 다른 환경에 속합니다. |
| 409 | `connection_in_use` | 사용자가 여전히 이 활성 연결의 식별자를 가지고 있습니다. 먼저 비활성화하세요. |
| 412 | `precondition_failed` | `If-Match`가 현재 버전과 일치하지 않습니다. |
| 428 | `precondition_required` | `If-Match` 헤더가 누락되었습니다. |
| 401 | `unauthenticated` | 자격 증명이 누락되었거나, 잘못되었거나, 취소되었습니다. |
| 403 | `insufficient_permissions` | 자격 증명에 필요한 권한이 없습니다. |
| 429 | `rate_limited` | 속도 제한을 초과했습니다. `Retry-After` 기간 후에 다시 시도하세요. |
| 503 | `service_unavailable` | 종속성을 일시적으로 사용할 수 없습니다. `Retry-After` 기간 후에 다시 시도하세요. |

## 예제

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