# Create a new role. Then optionally add scopes by using the Update Role Scopes API. No scopes are added by default.

Learn more about Creating Custom Roles.

Endpoint: POST /authz2/v1/roles/
Version: 1.0.0
Security: apiKey

## Request fields (application/json):

  - `name` (string)

  - `description` (string)

## Response 200 fields (application/json):

  - `id` (string)

  - `name` (string)

  - `description` (string)

  - `role_type` (integer)

## Response 400 fields (application/json):

  - `status` (integer)
    Either 'status' or 'code' will be present, but not both.

  - `code` (integer)
    Either 'status' or 'code' will be present, but not both.

  - `error` (string)
    Either 'error' or 'errors' will be present, but not both.

  - `errors` (array)
    Either 'error' or 'errors' will be present, but not both.

  - `message` (string)

## Response 401 fields (application/json):

  - `status` (integer)
    Either 'status' or 'code' will be present, but not both.

  - `code` (integer)
    Either 'status' or 'code' will be present, but not both.

  - `error` (string)
    Either 'error' or 'errors' will be present, but not both.

  - `errors` (array)
    Either 'error' or 'errors' will be present, but not both.

  - `message` (string)