Ortam rolü oluştur

POST /v1/roles · izin roles:write

Ortamın rol kataloğuna rol ekler. Yanıt ETag taşır; yazma role.created olarak audit'e düşer. Idempotency-Key isteğe bağlıdır.

İstek

Alan Tür Zorunlu Açıklama
key string evet Küçük harf, rakam, _ ve -; 1–64 karakter; kapsamında tekil ve değişmez.
name string evet Görünen ad, en çok 128 karakter.
description string hayır En çok 1024 karakter.
is_privileged boolean hayır Ayrıcalıklı rolü işaretler: self-serviste yalnız org yönetici rolünü (org_admin_role_id) taşıyan üye atayabilir; dış grubu bu role eşlemek roles:write ve onay ister.
assignable_in_self_service boolean hayır Varsayılan true; ayrıcalıklı rolde de.

Yanıt

Rolle 201 Created.

{
  "id": "rol_01j9xr7s1t2w6x8y0z2a4b6c8e",
  "organization_id": null,
  "key": "support",
  "name": "Support",
  "description": "",
  "is_privileged": false,
  "assignable_in_self_service": true,
  "permission_ids": [],
  "created_at": "2026-10-12T09:31:00.123456Z",
  "updated_at": "2026-10-12T09:31:00.123456Z",
  "version": 1
}

Hatalar

HTTP code Ne zaman
409 role_key_conflict Kapsamda bu key ile rol zaten var.
409 role_limit_reached 1.000 ortam rolü ya da org başına 50 rol sınırına ulaşıldı.
422 validation_failed Bir alan eksik ya da geçersiz.
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 Bir bağımlılık geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin.

Örnek

curl -i -X POST "https://api.eu.keenauth.com/v1/roles" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key":"support","name":"Support"}'