Users > Roles

The following endpoint retrieves the mapping of a userRoleId parameter and user role name.

User role definitions

get

Gets list of all existing user role names and IDs. Set the user roles in an organization with the POST /users/{userId}/user-organization-roles/{organizationId} API call. Use the POST /users/{userId}/user-team-roles/{teamId} API call to set user roles in a team.

Authorizations

Query parameters

colsstring[]optional

Specifies columns that are returned in the response. Use the cols[] parameter for every column that you want to return in the response. For example GET /endpoint?cols[]=key1&cols[]=key2 to get both key1 and key2 columns in the response.

Check the "Filtering" section for a full example.

Example: {"value":["id","name","subsidiary","category","permissions"]}

categorystring · enumoptional

Set this parameter to organization or team to get user roles in an organization or in a team.

Example: teamAvailable options:

Responses

application/json

get

cURLJavaScriptPythonHTTP

curl -L \
  --url 'https://eu1.make.com/api/v2/users/roles' \
  --header 'Authorization: YOUR_API_KEY'

200

200

List all user roles

List all columns

List all user roles

{
  "usersRoles": [
    {
      "id": 1,
      "name": "Team Admin"
    },
    {
      "id": 3,
      "name": "Team Member"
    },
    {
      "id": 4,
      "name": "Team Monitoring"
    },
    {
      "id": 6,
      "name": "Team Operator"
    },
    {
      "id": 11,
      "name": "Owner"
    },
    {
      "id": 12,
      "name": "Admin"
    },
    {
      "id": 13,
      "name": "Member"
    },
    {
      "id": 14,
      "name": "Accountant"
    }
  ]
}

Successful response