Skip to main content
DELETE
/
roles
/
{role}
/
permissions
/
{permission}
Unset Role Permissions
curl --request DELETE \
  --url https://{appId}.api-{region}.cometchat.io/v3/roles/{role}/permissions/{permission} \
  --header 'apikey: <api-key>'
{
  "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"
      ]
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://www.cometchat.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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