Kuruluş rolünü silme
DELETE /fapi/v1/organizations/{org_id}/roles/{role_id} · ortamın giriş ana makinesinden çağrılır
Atanmamış bir kuruluş rolünü siler. Ortam rolleri burada silinemez. Bir __Host-idp_session çerezi gerekir; çerez yoksa, süresi dolmuşsa veya iptal edilmişse 401 unauthenticated döner. Farklı bir kökenteki birinci taraf bir uygulama bunun yerine Front API erişim belirtecini (DPoP kanıtıyla birlikte Authorization: DPoP <token>; bkz. Front API erişim belirteci) gönderebilir. Kullanıcının kuruluşun etkin bir üyesi olması ve idp_roles:manage iznine sahip olması gerekir. Üye olmayan bir kullanıcı 404 not_found alır, böylece kuruluşun varlığı açığa çıkmaz; izne sahip olmayan bir üye 403 insufficient_permissions alır. Kuruluş rolleri, ortam için etkinleştirilmiş ve planına dahil edilmiş olmalıdır.
İstek
Başlıklar:
| Başlık | Zorunlu | Açıklama |
|---|---|---|
Idp-Client |
evet | SDK tanımlayıcısı. |
Origin |
evet | Tam olarak https://<giriş ana makinesi> olmalıdır. |
If-Match |
hayır | Rolün son okunduğu "<sürüm>"; rol o zamandan beri değiştiyse 412 precondition_failed döner ve hiçbir şey değişmez. |
org_id: kuruluş tanımlayıcısı (org_…). role_id: rol tanımlayıcısı (rol_…).
Gövde yok.
Yanıt
204 No Content.
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 401 | unauthenticated |
Geçerli bir oturum çerezi yok. |
| 403 | origin_not_allowed |
Origin eksik veya hatalı. |
| 403 | insufficient_permissions |
Kullanıcının kuruluşta idp_roles:manage izni yok. |
| 403 | plan_feature_unavailable |
Ortamın planı kuruluş rollerini içermiyor (feature, required_plan). |
| 403 | org_custom_roles_disabled |
Ortam için kuruluş rolleri kapalı. |
| 403 | role_not_assignable |
Rol, kullanıcının sahip olmadığı bir izni veriyor veya kullanıcının kendi üyeliği bu izne sahip. |
| 404 | not_found |
Bu kullanıcı için böyle bir kuruluş veya kuruluş rolü yok; ortam rolü, bilinmeyen, hatalı biçimli veya başkasına ait bir tanımlayıcı aynı yanıtı verir. |
| 409 | role_in_use |
Rol hâlâ atanmış. |
| 409 | organization_pending_deletion |
Kuruluş silinmek üzere planlanmış. |
| 412 | precondition_failed |
If-Match mevcut sürümü göstermiyor veya istek işlenirken rol değişti. |
| 503 | service_unavailable |
Geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin. |
Örnek
curl -X DELETE https://example.keenauth.app/fapi/v1/organizations/org_01jbz6x8kq3m2n4p5r6s7t8v9a/roles/rol_01jbz6x8kq3m2n4p5r6s7t8v9w \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt