Unset Role Permissions

Removes a specific permission from a role

DELETE /roles/{role}/permissions/{permission}

Unset Role Permissions

cURL

curl --request DELETE \
  --url https://{appId}.api-{region}.cometchat.io/v3/roles/{role}/permissions/{permission} \
  --header 'apikey: <api-key>'

200

{
  "data": {
    "permissions": {
      "listUsers": "allow",
      "listUsers.mode": "all",
      "listUsers.allowedRoles": [
        "new_role"
      ],
      "getUserDetails.mode": "friends",
      "getUserDetails.allowedRoles": [
        "default"
      ],
      "sendMessage": "allow",
      "sendMessage.mode": "all",
      "sendMessage.allowedReceiverTypes": [
        "group"
      ],
      "sendMessage.allowedReceiverRoles": [
        "new_role",
        "default"
      ],
      "sendMessage.allowedMessageTypes": [
        "file",
        "audio",
        "video",
        "image",
        "text"
      ],
      "sendMessage.allowedMessageCategories": [
        "message",
        "custom"
      ],
      "editMessage": "deny",
      "editMessage.denyForScopes": [],
      "deleteMessage": "deny",
      "deleteMessage.denyForScopes": [],
      "sendMessage.allowedCustomTypes": [],
      "sendMessage.allowedMimeTypes": [
        "image/png"
      ],
      "initiateCall": "allow",
      "initiateCall.mode": "all",
      "initiateCall.allowedReceiverRoles": [
        "new_role"
      ],
      "createGroup": "allow",
      "createGroup.allowedGroupTypes": [
        "private"
      ],
      "listGroups": "allow",
      "listGroups.allowedGroupTypes": [
        "password"
      ],
      "joinGroup": "allow",
      "joinGroup.allowedGroupTypes": [
        "public"
      ],
      "listMessages.allowedMessageCategories": [
        "message"
      ],
      "listMessages.allowedMessageTypes": [
        "audio"
      ]
    }
  }
}

For the complete error reference, see Error Guide.

Authorizations

apikey · string · header · required

API Key with fullAccess scope(i.e. Rest API Key from the Dashboard).

Path Parameters

role · string · required

The role identifier to remove permission from

Example:

"default"

permission · string · required

The permission key to unset (e.g., listUsers.mode, createGroup, etc.)

Example:

"listUsers.mode"

Response

200 - application/json

Role permission unset successfully

data · object