Dizin token'ını iptal et

DELETE /v1/directories/{directory_id}/tokens/{token_id} · izin directories:write

Token'ı hemen iptal eder; onu taşıyan SCIM istekleri bundan sonra 401 alır. Zaten iptal edilmiş token'ı iptal etmek de 204 döner. İptal directory.token_revoked olarak denetlenir.

İstek

Alan Tür Zorunlu Açıklama
directory_id path evet SCIM dizini kimliği (dir_…).
token_id path evet Token kimliği (küçük harf UUID).

İstek gövdesi yoktur.

Yanıt

204 No Content.

Hatalar

HTTP code Ne zaman
404 not_found Dizin ya da token bu ortamda yok veya token başka bir dizine ait.
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 Dizin eşitleme geçici olarak kullanılamıyor ya da bu kurulumda yapılandırılmamış; Retry-After süresinden sonra yeniden deneyin.

Örnek

curl -i -X DELETE "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/tokens/0192a3b4-c5d6-7e8f-9a0b-1c2d3e4f5a6b" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"