创建新的自定义角色或更新已有角色,更新时传入 role_id。
| 项目 | 说明 |
|---|---|
| 速率限制 | 每个账户 1,000 次/分钟;50 次/秒 |
| 权限要求 | 角色管理(organization) |
role_id(或置为 0)表示创建;传入已有 ID 表示更新。role_name 须为 1–39 个字符且在账户内唯一。permission_ids 会完整替换角色的权限集合。在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。