teams

Creates a team.

Changed on

Creates a team. It can then be assigned to users and projects.

<Note title="Subscription Level" icon="layer-group">This endpoint requires the Standard plan or higher.</Note>

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

post/teams

Request

  • Base URL: https://api.awork.com/api/v1
  • URL: https://api.awork.com/api/v1/teams
  • Auth: HTTP bearer

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.

Changes