Ortam rolünü silme

DELETE /v1/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
`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/roles/rol_01j9xr7s1t2w6x8y0z2a4b6c8e?force=true" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"