디렉터리 삭제

DELETE /v1/directories/{directory_id} · 권한 directories:write

디렉터리를 즉시 그리고 영구적으로 삭제합니다. 디렉터리의 토큰(이후 ID 공급자의 SCIM 요청은 401을 받습니다), 대량 프로비저닝 해제 보류, 그룹, 그룹 구성원 관계, 디렉터리 사용자 레코드가 같은 트랜잭션에서 삭제됩니다. 삭제는 directory.deleted로 감사 기록됩니다. 이미 삭제된 디렉터리를 삭제하면 404를 반환합니다.

요청

필드 유형 필수 설명
directory_id path 예 SCIM 디렉터리 ID (dir_…).

요청 본문은 없습니다.

응답

204 No Content.

오류

HTTP code 발생 시점
404 not_found 이 환경에 디렉터리가 없습니다.
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/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"