Skip to content

Update role

Request

Update an existing role for this application.

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

Security
AdminAccessToken or ClientAccessToken
Path
app_idstringrequired

ID of the application to retrieve it's roles

role_idstringrequired

ID of the role to update

Bodyapplication/jsonrequired
role_namestring

Role name

permissionsArray of strings

Role permissions

descriptionstring

Role description

display_namestring

Role display name

curl -i -X PUT \
  'https://api.sbx.transmitsecurity.io/cis/v1/applications/{app_id}/roles/{role_id}' \
  -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": {}
}