組織カスタムロールの権限を置き換える

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

一覧を permission_ids で置き換えます（全体の集合。最大 1000 件）。権限を追加するには org_custom_roles のプラン機能（Business）が必要です。権限の削除は常に許可され、削除された権限は同じ書き込みで、すべての組織ロールからも取り除かれます。一部のシステム権限は組織ロールに付与できません（permission_not_allowed）。この変更は org_custom_role_permissions.updated として監査されます。権限を失った組織ロールごとに role.updated として監査されます。

リクエスト

フィールド	型	必須	説明
`permission_ids`	string[]	はい	権限 ID（`perm_…`）の全体の集合。最大 1000 件。

レスポンス

200 OK で、新しい一覧を返します。

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

エラー

HTTP	code	発生条件
403	`plan_feature_unavailable`	集合が権限を追加しており、プランに `org_custom_roles` が含まれていません。
422	`permission_not_allowed`	組織ロールには付与できない権限です。
422	`validation_failed`	`permission_ids` がない、形式が不正、または未知の ID がある、重複がある、1000 件を超えている。
401	`unauthenticated`	認証情報がない、無効、または失効している。
403	`insufficient_permissions`	認証情報に必要な権限がありません。
429	`rate_limited`	レート制限を超えました。`Retry-After` の期間を待ってから再試行してください。
503	`service_unavailable`	依存先が一時的に利用できません。`Retry-After` の期間を待ってから再試行してください。

例

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"]}'