Org özel rol izin listesini değiştir

PUT /v1/org-custom-role-permissions · izin roles:write

Listeyi permission_ids ile değiştirir (tam küme, en çok 1000). İzin eklemek org_custom_roles plan hakkı (Business) ister; izin çıkarmak her zaman serbesttir ve çıkarılan izin aynı yazmada bütün org rollerinden de düşer. Bazı sistem izinleri org rollerine hiçbir zaman verilemez (permission_not_allowed). Değişiklik org_custom_role_permissions.updated olarak audit'e düşer; izin kaybeden her org rolü role.updated olarak yazılır.

İstek

Alan Tür Zorunlu Açıklama
permission_ids string[] evet İzin kimliklerinin tam kümesi (perm_…), en çok 1000.

Yanıt

200 OK; yeni liste.

{
  "permission_ids": [
    "perm_01j9xs0a2b4c6d8e0f2g4h6j8k",
    "perm_01j9xs0a2b4c6d8e0f2g4h6j8m"
  ]
}

Hatalar

HTTP code Ne zaman
403 plan_feature_unavailable Küme izin ekliyor ve plan org_custom_roles içermiyor.
422 permission_not_allowed Bir izin org rollerine hiçbir zaman verilemez.
422 validation_failed permission_ids yok, biçimsiz ya da bilinmeyen kimlik, tekrar ya da 1000'den fazla öğe içeriyor.
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 PUT "https://api.eu.keenauth.com/v1/org-custom-role-permissions" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"permission_ids":["perm_01j9xs0a2b4c6d8e0f2g4h6j8k","perm_01j9xs0a2b4c6d8e0f2g4h6j8m"]}'