# Create role

Create a new role for this application. Required permissions: organizations:create, roles:create, apps:create, [appId]:create.

Endpoint: POST /v1/applications/{app_id}/roles
Security: AdminAccessToken, ClientAccessToken

## Path parameters:

  - `app_id` (string, required)
    ID of the application to retrieve its roles

## Request fields (application/json):

  - `role_name` (string, required)
    Role name

  - `permissions` (array)
    Role permissions

  - `description` (string)
    Role description

  - `display_name` (string)
    Role display name

## Response 201 fields (application/json):

  - `result` (object, required)

  - `result.result` (object, required)

## Response 409 fields (application/json):

  - `message` (string, required)

  - `error_code` (number, required)

  - `ts_error_code` (string, required)