Dependency-Track unofficial
PUT/v1/permission/team

Replace a team's permissions

Replaces a team's permissions with the supplied list. Provide team and permissions, using supported permission names without duplicates. The authenticated user must have ACCESS_MANAGEMENT or ACCESS_MANAGEMENT_UPDATE permission.

2 body fields

Team UUID and the replacement permission list. Both team and permissions are required.

permissionsarray<string>required
The permissions to assign to the team. Values must be supported permission names, with no duplicates.
teamstringrequired
The team identifier. Must contain at least one character.

5 status codes
200Returns the updated team, including its UUID, name, and associated access-management data.
apiKeysarray<object>optional
ldapUsersarray<object>optional
managedUsersarray<object>optional
mappedLdapGroupsarray<object>optional
mappedOidcGroupsarray<object>optional
namestringrequired
oidcUsersarray<object>optional
permissionsarray<object>optional
serviceAccountsarray<object>optional
uuidstringrequired
304Returned when the team already has the specified permissions.
400Returned when the request is invalid, including when required fields are missing or permission values are invalid.
401Returned when the authenticated user is not authorized to replace team permissions.
404Returned when the specified team cannot be found.

Error handling

A 400 is returned when the request is invalid, a 401 when the authenticated user lacks ACCESS_MANAGEMENT or ACCESS_MANAGEMENT_UPDATE permission, and a 404 when the team cannot be found. team and permissions are required; team must not be empty, and permissions must contain unique supported permission values.