Create Role
POST
/api/v1/permissions/roles
const url = 'https://example.com/api/v1/permissions/roles';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"name":"example","comment":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/v1/permissions/roles \ --header 'Content-Type: application/json' \ --data '{ "name": "example", "comment": "example" }'Create a new role.
Args: request: Role creation details
Returns: PermissionOperationResponse with operation result
Raises: HTTPException: If role creation fails
Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”Responses
Section titled “Responses”Successful Response
Media typeapplication/json
PermissionOperationResponse
Response for permission operations.
object
Examplegenerated
{ "success": true, "message": "example", "details": {}}Validation Error
Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationErrorobject
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{ "detail": [ { "loc": [ "example" ], "msg": "example", "type": "example" } ]}