Kuruluş rolünü silme

DELETE /v1/organizations/{org_id}/roles/{role_id} · izin roles:write

Rolü siler. force=true ile atanmış bir rol de silinir ve üyelik atamaları aynı işlemde kaldırılır; aksi halde atanmış bir rol 409 role_in_use yanıtı döndürür. Bir kuruluşun yönetici veya varsayılan üye rolü olarak kullanılan bir rol hiçbir zaman silinmez. If-Match isteğe bağlıdır. Silme işlemi role.deleted olarak denetim kaydına geçirilir.

İstek

Alan Tür Zorunlu Açıklama
org_id path evet Kuruluş kimliği (org_…).
role_id path evet Rol kimliği (rol_…).
force query hayır true ise rolün atamalarını da kaldırır; false (varsayılan) atanmış bir rolü reddeder.
If-Match header hayır Mevcut ETag; uyuşmazlık durumunda 412.

İstek gövdesi yoktur.

Yanıt

204 No Content.

Hatalar

HTTP code Ne zaman
404 not_found Rol bu kapsamda mevcut değil.
409 role_in_use Rol atanmış ve force true değil ya da rol bir kuruluşun yönetici veya varsayılan üye rolü.
412 precondition_failed If-Match mevcut sürümle eşleşmiyor.
422 validation_failed force true veya false değil ya da tekrarlanmış.
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Kimlik bilgisi gerekli izne sahip değil.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin.

Örnek

curl -i -X DELETE "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/roles/rol_01j9xr7s1t2w6x8y0z2a4b6c8e?force=true" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"