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