Create Role

Add a role to your company with the permissions it should carry.

POST

Body

Arguments

stringrequired

The role name, up to 255 characters.

string

What the role is for, up to 255 characters.

array of string

Permission keys to grant. Leave it out to create the role with no permissions.

Try this request

API Key

Request

curl --request POST \
  --url 'https://connect.mindcloud.co/v2/roles' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": ""
}'

{
  "success": true,
  "data": {
    "id": "string",
    "name": "Ava Chen",
    "description": "string",
    "isAdmin": true,
    "isGlobal": true,
    "createdOn": "2026-05-07T12:00:00.000Z",
    "permissions": [
      {}
    ]
  }
}