Dependency-Track unofficial
PUT/v1/team

Create a team

Creates a new team with its name and any supplied users, permissions, API keys, service accounts, and identity-provider mappings. Send the team fields to include; name must be 1 to 255 characters and contain no control characters. The authenticated user must have ACCESS_MANAGEMENT or ACCESS_MANAGEMENT_CREATE permission.

10 body fields

Optional team details, including the team name, users, permissions, API keys, service accounts, and identity-provider group mappings.

apiKeysarray<object>optional
API keys associated with the team, including key values, public IDs, comments, and timestamps.
ldapUsersarray<object>optional
LDAP users associated with the team, including their distinguished names, email addresses, usernames, permissions, and team memberships.
managedUsersarray<object>optional
Managed users associated with the team, including usernames, profile details, password settings, permissions, suspension state, and team memberships.
mappedLdapGroupsarray<object>optional
LDAP groups mapped to the team, each with a distinguished name and UUID.
mappedOidcGroupsarray<object>optional
OIDC groups mapped to the team, each with a UUID and group details.
namestringrequired
The team name. Must be 1 to 255 characters and contain no control characters.
oidcUsersarray<object>optional
OIDC users associated with the team, including usernames, email addresses, subject identifiers, permissions, and team memberships.
permissionsarray<object>optional
Permissions associated with the team, including the permission name and its user associations.
serviceAccountsarray<object>optional
Service accounts associated with the team, including usernames, email addresses, permissions, suspension state, and team memberships.
uuidstringrequired
The team's UUID.

3 status codes
201Returns the created team object, including its UUID, name, API keys, users, permissions, service accounts, and mapped identity-provider groups.
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
401Returned when the request is unauthorized.
409Returned when a team with the submitted name already exists; the response identifies the existing team.
detailstringrequired
Human-readable explanation specific to this occurrence of the problem
instancestringoptional
Reference URI that identifies the specific occurrence of the problem
statusintegerrequired
HTTP status code generated by the origin server for this occurrence of the problem
teamNamestringoptional
Name of the existing team
teamUuidstringoptional
UUID of the existing team
titlestringrequired
Short, human-readable summary of the problem type
typestringoptional
A URI reference that identifies the problem type

Error handling

A 401 is returned when the request is unauthorized; the authenticated user must have ACCESS_MANAGEMENT or ACCESS_MANAGEMENT_CREATE permission. A 409 is returned when a team with the submitted name already exists. If supplied, name must be 1 to 255 characters and contain no control characters.