# Create a role (/api/roles/create-role)

`POST https://api.comecero.com/api/v1/roles`

Creates a role in the mode of the token you call with. Give it to users and secret tokens through their `roles` list. Secret and trusted tokens may call this with the `roles` create permission.

Request body: the `role_request` schema.

Responses: 201, 400, 401, 403, 500.

Full schemas: operation `create_role` in /openapi.json.