Users > User team roles

The following endpoints update and retrieve data about user team roles of a user in a team. Check out the overview of user team roles and the associated permissions.

List user roles

get

Gets team roles of the user with the specified userId. The response contains user's team role ID for all teams the user is part of. Get the mapping of the userRoleId and the user role name with the API call GET /users/roles.

Authorizations

Path parameters

userIdstringrequired

The ID of the user.

Example: 111

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

200

{
  "userTeamRoles": [
    {
      "usersRoleId": 3,
      "userId": 13,
      "teamId": 1,
      "changeable": true
    },
    {
      "usersRoleId": 1,
      "userId": 13,
      "teamId": 21,
      "changeable": true
    }
  ]
}

Successful response

Get user team role detail

get

Gets user role detail in the team with the specified teamId. Get the mapping of the userRoleId and the user role name with the API call GET /users/roles.

Authorizations

Path parameters

userIdstringrequired

The ID of the user.

Example: 111

teamIdstringrequired

The ID of the team.

Example: 22

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://eu1.make.com/api/v2/users/{userId}/user-team-roles/{teamId}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "userTeamRole": {
    "usersRoleId": 3,
    "userId": 13,
    "teamId": 1,
    "changeable": true
  }
}

Successful response

Update user role

post

Updates the user role in the team with the specified teamId. Get the mapping of the userRoleId and the user role name with the API call GET /users/roles.

Authorizations

Path parameters

userIdintegerrequired

The ID of the user.

Example: 111

teamIdintegerrequired

The ID of the team.

Example: 22

Body

usersRoleIdintegeroptional

The ID of the user role. Check the GET /users/roles API call for the available usersRoleId values.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://eu1.make.com/api/v2/users/{userId}/user-team-roles/{teamId}' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "usersRoleId": 3
  }'

200

200

{
  "userTeamRole": {
    "usersRoleId": 3,
    "userId": 13,
    "teamId": 1,
    "changeable": true
  }
}

Successful response