Skip to content
Home/
REST API Reference
/
/
List all roles

List all roles

Request

You can fetch a list of all roles in the workspace.

Roles define what a teammate can do in a workspace. The teammates endpoint returns the role a teammate holds, but only the roles that are currently assigned, and only their id and name. This endpoint lists every role in the workspace, each with its description.

Security
bearerAuth
Headers
Intercom-Versionstring(intercom_version_preview)

Preview Intercom API version. Used for closed beta endpoints or other features under managed availability.

Default:"Preview"
Value:"Preview"
Example:Preview
curl -i -X GET \
  https://api.intercom.io/roles \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: Preview'

Responses

successful

Bodyapplication/json
typestring

The type of the object

Value:"list"
Example:"list"
dataArray of objects(Role)

A list of role objects

Example:
[
  {
    "type": "role",
    "id": "991267902",
    "name": "Support Lead",
    "description": "Can view and reply to conversations"
  }
]
Response
{
  "type": "list",
  "data": [
    { … }
  ]
}