As of December 31st, 2023 ThreadFix 2.X has reached End of Life and is no longer supported. For any further information please contact the Success and Implementation team.
Remove Team Role from Group - API
/rest/{version}/groups/{groupId}/role/team/delete
Descriptor | Value |
---|---|
HTTP Method | POST |
Description | Removes the group permissions for the specified team. This only removes explicit Group/Team permissions, and does not affect any other permissions the group's users have from their global role, attached groups, and other team/app permissions. To obtain the groupId value in the endpoint, run the Get Groups - API call first. The group's id value in the response is the groupId 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 Groups |
Version Introduced | 2.5.1.13 |
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 remove permissions for. |
Sample Call:
curl -H 'Accept: application/json' -H "Authorization: APIKEY {apiKey}" --data "teamId=2" https://localhost:8443/threadfix/rest/latest/groups/1/role/team/delete
Sample Output:
{
"message": "Successfully removed role mapping for group: Staff (LOCAL) from team: Sample Team",
"success": true,
"responseCode": -1,
"object": {
"groupId": 1,
"teamId": 2
}
}
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.