permissions
Create Role
Create a new role.
This endpoint creates a new role with the specified name. Roles are used to group permissions and can be assigned to users to manage access control more efficiently. The authenticated user becomes the owner of the created role.
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
- 500 Internal Server Error: Error creating the role
POST
Create Role
Query Parameters
Response
200
application/json
Successful Response
The response is of type any.
Previous
Add User To RoleAdd a user to a role.
This endpoint assigns a user to a specific role, granting them all the
permissions associated with that role. The authenticated user must be
the owner of the role or have appropriate administrative permissions.
## Path Parameters
- **user_id** (UUID): The UUID of the user to add to the role
## Request Parameters
- **role_id** (UUID): The UUID of the role to assign the user to
## Response
Returns a success message indicating the user was added to the role.
## Error Codes
- **400 Bad Request**: Invalid user or role ID
- **403 Forbidden**: User doesn't have permission to assign roles
- **404 Not Found**: User or role doesn't exist
- **500 Internal Server Error**: Error adding user to role
Next
Create Role