Sign in

v1

latestOpenAPI 3.1.02026-08-066984441.1 MB
teams

Updates the team with the specified id.

<Check title="Required Permissions" icon="key">The user must be an admin.</Check>

put/teams/{teamId}

Path parameters

teamIdstring uuid required

The id of the team to update.

Query parameters

includeUserIdsboolean

Whether to include the ids of users that are in the team.

includeProjectIdsboolean

Whether to include the ids of projects that are assigned to the team.

Headers

Authorizationstring required

Bearer authentication

Request body

namestring required

The team name.

iconstring nullable

The icon of the team. Optional. Possible values: 'attach_money', 'poll', 'golf_course', 'all_inclusive', 'portrait', 'timeline', 'transform', 'description', 'folder', 'computer', 'web', 'phone_iphone', 'cloud', 'local_movies', 'shopping_cart', 'brush', 'image', 'camera_alt', 'movie_creation', 'public', 'whatshot', 'extension', 'explore', 'lock', 'settings', 'stars', 'store', 'school', 'local_bar', 'question_answer', 'favorite', 'work', 'flight_takeoff', 'map', 'local_dining'.

colorstring nullable

The color of the team. Optional. Possible values: 'red', 'coral', 'yellow', 'green', 'teal', 'arctic', 'blue', 'azure', 'purple', 'violet'.

Response

OK

namestring required

The team name.

iconstring nullable

The icon of the team. Optional. Possible values: 'attach_money', 'poll', 'golf_course', 'all_inclusive', 'portrait', 'timeline', 'transform', 'description', 'folder', 'computer', 'web', 'phone_iphone', 'cloud', 'local_movies', 'shopping_cart', 'brush', 'image', 'camera_alt', 'movie_creation', 'public', 'whatshot', 'extension', 'explore', 'lock', 'settings', 'stars', 'store', 'school', 'local_bar', 'question_answer', 'favorite', 'work', 'flight_takeoff', 'map', 'local_dining'.

colorstring nullable

The color of the team. Optional. Possible values: 'red', 'coral', 'yellow', 'green', 'teal', 'arctic', 'blue', 'azure', 'purple', 'violet'.

idstring uuid

The id of the team.

createdOnstring date-time

The date this team was created.

createdBystring uuid nullable

The id of the user who created this team.

updatedOnstring date-time

The date this team was last modified.

updatedBystring uuid nullable

The id of the user who last updated this team.

userIdsstring[] nullable

The ids of the users in the team.

projectIdsstring[] nullable

The ids of the projects in the team.