# Create a new custom role **POST** `/v1/roles` **Operation ID**: `createRole` **Summary**: Create a new custom role Creates a new custom role with specified permissions ## Tags - Roles ## Request Body **Content-Type**: `application/json` **Schema**: `CreateRole` ## Responses ### 201 Role created successfully - **Content-Type**: `application/json` / `Role` ### 400 Invalid request data ### 403 Insufficient permissions ### 409 Role name already exists