Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Version published after converting to the new editor

/rest/{version}/users/{userId}/role/team


Descriptor

Value

HTTP Method

POST

Description

Gives the user permissions in the provided role for the specified team and all of its applications.

These permissions will add onto any other permissions the user has from their global role, attached groups, and other team/app permissions.

Required Permission

Manage Users

Version Introduced2.5.1.12


Request Header Parameters

Parameter

Value

Required

Description

Accept

String

Yes

A value of ‘application/json’ must be provided.


Request POST Data Parameters

Parameter

Value

Required

Description

teamId

Integer

Yes

The ID of the team to assign permissions for.

roleId

Integer

Yes

The ID of the role to give the user for that team.



Sample Call:

Code Block
themeEclipse
curl -H 'Accept: application/json' -H "Authorization: APIKEY {apiKey}" --data "teamId=1&roleId=3" https://localhost:8443/threadfix/rest/latest/users/2/role/team

Sample Output:


Code Block
themeEclipse
{
  "message": "",
  "success": true,
  "responseCode": -1,
  "object": {
    "id": 1,
    "user": {
      "id": 2,
      "name": "mfreeman",
      "displayName": "Morgan",
      "type": "LOCAL"
    },
    "organization": {
      "id": 1,
      "name": "Example Team"
    },
    "role": {
      "id": 3,
      "displayName": "Developer Role"
    },
    "accessControlApplicationMaps": null,
    "allApps": true
  }
}


Page Tree
rootUsers, Roles, and Groups API