연결 삭제
DELETE /v1/connections/{connection_id} · 권한 connections:write
연결을 삭제합니다. 사용자 데이터는 삭제되지 않습니다. If-Match는 필수입니다. 사용자가 활성 연결의 식별자를 가지고 있으면 삭제가 connection_in_use로 실패합니다. 먼저 연결을 비활성화하세요. 연결은 애플리케이션 연결 목록에서도 제거됩니다. 삭제된 연결은 30일 이내에 :restore로 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 기간 후에 다시 시도하세요. |
예제
curl -X DELETE https://api.eu.keenauth.com/v1/connections/conn_0k3v8m1q2x9dz4h7s5t6w0y1ab \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H 'If-Match: "2"'