POST
/
roles
Create
curl --request POST \
  --url https://{appid}.api-{region}.cometchat.io/v3/roles \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '{
  "role": "",
  "name": "",
  "description": "",
  "metadata": {},
  "settings": {}
}'
{
  "data": {
    "role": "manager",
    "name": "manager",
    "description": "This role gives an update access",
    "metadata": {
      "email": "managers@gmail.com"
    },
    "settings": {
      "listUsers": "all",
      "sendMessagesTo": "friendsOnly"
    },
    "createdAt": 1638343994
  }
}

Authorizations

apikey
string
header
required

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

Body

application/json

Response

200 - application/json

Created a new Role

The response is of type object.