Skip to content

Create role

Request

Create a new role for this application.

Required permissions: organizations:create, roles:create, apps:create, [appId]:create.

Security
AdminAccessToken or ClientAccessToken
Path
app_idstringrequired

ID of the application to retrieve its roles

Bodyapplication/jsonrequired
role_namestringrequired

Role name

permissionsArray of strings

Role permissions

descriptionstring

Role description

display_namestring

Role display name

curl -i -X POST \
  'https://api.sbx.transmitsecurity.io/cis/v1/applications/{app_id}/roles' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "role_name": "string",
    "permissions": [
      "string"
    ],
    "description": "string",
    "display_name": "string"
  }'

Responses

Bodyapplication/json
resultobjectrequired
Response
{
  "result": {
    "result": {}
  }
}