Dependency-Track unofficial
POST/v1/permission/{permission}/team/{uuid}

Add a permission to a team

Adds a permission to a team. Supply the team UUID in uuid and a valid permission in permission. The authenticated user must have ACCESS_MANAGEMENT or ACCESS_MANAGEMENT_UPDATE permission.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 parameters
uuidstringrequired
The team's UUID, in UUID format.
permissionstringrequired
The valid permission to add to the team.

4 status codes
200Returns the updated team object, including its team details and permissions.
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 permission assigned.
401Returned when the authenticated user is unauthorized to add the permission.
404Returned when the team could not be found.

Error handling

A 401 is returned when the authenticated user lacks ACCESS_MANAGEMENT or ACCESS_MANAGEMENT_UPDATE. A 404 is returned when the uuid path parameter does not identify an existing team. The permission path parameter must name a valid permission.