Create role
Create a new custom role with a defined set of permissions. Custom roles allow fine-grained access control beyond system roles.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Role name |
description | string | No | Role description |
permissionIds | string[] | Yes | Permission IDs to assign |
Use Cases
- Create operator role with specific permissions
- Define custom role for integration
- Tailor access for team structure
Required Permission
roles:create
Create role
Create a new custom role with a defined set of permissions. Custom roles allow fine-grained access control beyond system roles.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Role name |
description | string | No | Role description |
permissionIds | string[] | Yes | Permission IDs to assign |
Use Cases
- Create operator role with specific permissions
- Define custom role for integration
- Tailor access for team structure
Required Permission
roles:create