As we reach the end of September 2024, ThreadFix version 3.x on-premises has officially reached its End-of-Life. Therefore, there is no longer support or updates for this version of the product. We have fully transitioned our product and development teams to focus ThreadFix SaaS and migrating all customers over from the on-premises versions. Our Customer Success and Support teams are here to help you in migrating to ThreadFix SaaS and maximizing the value you see from this improved offering from Coalfire. This is the next phase of ThreadFix and our team is looking forward to continuing to support you on this journey.
Add Team Role to User 3.0 - API
/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. To obtain the userId value in the endpoint, run the Get Users - API call first. The user's id value in the response is the userId value that you use in this endpoint. To obtain the roleId value in the endpoint, run the Get Roles - API call first. The role's id value in the response is the roleId value that you use in this endpoint. |
Required Permission | Manage Users |
Version Introduced | 2.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:
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:
{
"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
}
}
www.threadfix.it | www.coalfire.com
Copyright © 2024 Coalfire. All rights reserved.
This Information Security Policy is CoalFire - Public: Distribution of this material is not limited.