Get support

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
/users/{userId}/user-team-roles

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.

Required scopes
This endpoint requires the following scopes:
Authorizations
AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters
userIdstringRequired

The ID of the user.

Example: 111
Responses
200

Successful response

application/json
get
/users/{userId}/user-team-roles
GET /api/v2/users/{userId}/user-team-roles HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

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

Get user team role detail

get
/users/{userId}/user-team-roles/{teamId}

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.

Required scopes
This endpoint requires the following scopes:
Authorizations
AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

Path parameters
userIdstringRequired

The ID of the user.

Example: 111
teamIdstringRequired

The ID of the team.

Example: 22
Responses
200

Successful response

application/json
get
/users/{userId}/user-team-roles/{teamId}
GET /api/v2/users/{userId}/user-team-roles/{teamId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*
200

Successful response

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

Update user role

post
/users/{userId}/user-team-roles/{teamId}

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.

Required scopes
This endpoint requires the following scopes:
Authorizations
AuthorizationstringRequired

Authorize the API call with your API token in the Authorization header with the value: Token your-api-token.

If you don't have an API token yet, please refer to the "Authentication" section to learn how to create one.

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
200

Successful response

application/json
post
/users/{userId}/user-team-roles/{teamId}
POST /api/v2/users/{userId}/user-team-roles/{teamId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "usersRoleId": 3
}
200

Successful response

{
  "userTeamRole": {
    "usersRoleId": 3,
    "userId": 13,
    "teamId": 1,
    "changeable": true
  }
}
PreviousUsers > API TokensNextUsers > User team notifications

Last updated