permissions
Create Role
Create a new role.
This endpoint creates a new role with the specified name in the caller’s current tenant. Roles are used to group permissions and can be assigned to users to manage access control more efficiently. The authenticated user must be able to manage users in the tenant; the tenant owner always can.
Request Parameters
- role_name (str): The name of the role to create
Response
Returns a success message indicating the role was created.
Error Codes
- 400 Bad Request: Invalid role name or role already exists
- 403 Forbidden: User cannot manage users in their current tenant
- 500 Internal Server Error: Error creating the role
POST
Create Role