멤버십 제거
DELETE /v1/organizations/{org_id}/memberships/{membership_id} · 권한 organizations:write
멤버십을 제거합니다(사유 removed_by_admin). 조직의 마지막 활성 관리자는 제거할 수 없습니다. If-Match는 선택 사항입니다. 제거 작업은 organization_membership.deleted로 감사 기록됩니다.
요청
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
org_id |
path | 예 | 조직 ID(org_…)입니다. |
membership_id |
path | 예 | 멤버십 ID(mem_…)입니다. |
If-Match |
header | 아니요 | 현재 ETag입니다. 일치하지 않으면 412가 반환됩니다. |
요청 본문은 없습니다.
응답
204 No Content가 반환됩니다.
오류
| HTTP | code | 발생 조건 |
|---|---|---|
| 404 | not_found |
이 조직에 해당 멤버십이 없습니다. |
| 409 | last_org_admin |
해당 멤버십이 조직의 마지막 활성 관리자입니다. |
| 412 | precondition_failed |
If-Match가 현재 버전과 일치하지 않습니다. |
| 401 | unauthenticated |
자격 증명이 없거나, 잘못되었거나, 취소되었습니다. |
| 403 | insufficient_permissions |
자격 증명에 필요한 권한이 없습니다. |
| 429 | rate_limited |
요청 한도를 초과했습니다. Retry-After 기간 이후에 다시 시도하십시오. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 기간 이후에 다시 시도하십시오. |
예시
curl -i -X DELETE "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/memberships/mem_01j9xn5p9s0t4v6w8x0y2z4a6c" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
개인정보
이 엔드포인트는 개인정보를 다룹니다. 조직 멤버십과 초대가 해당합니다. KeenAuth API의 개인정보에서 저장되는 항목, 보관 기간, 삭제 방식을 설명합니다. 어떤 필드에도 특수 범주의 개인정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.