The monday.com teams APIs enable you to create, read, update, and delete teams.

The types below are used by the teams queries and mutations, and are not independently queryable.

AssignTeamOwnersResult

An object containing the result of assigning team owners via the API.

Field	Type	Description
errors	`[AssignTeamOwnersError!]`	The errors that occurred while assigning owners to a team. Use this field to check for calls that failed.
team	`Team`	The team the owners were assigned to.

AssignTeamOwnersError

An object containing the error that occurred when an assign_team_owners mutation fails.

Field	Type	Description	Enum Values
code	`AssignTeamOwnersErrorCode`	The error code that occurred.	`CANNOT_UPDATE_SELF` `EXCEEDS_BATCH_LIMIT` `FAILED` `INVALID_INPUT` `USER_NOT_FOUND` `USER_NOT_MEMBER_OF_TEAM` `VIEWERS_OR_GUESTS`
message	`String`	The error message.
user_id	`ID`	The unique identifier of the user that caused the error.

An object containing the result of adding or removing users from a team via the API.

Field	Type	Description
failed_users	`[User!]`	The users for whom the team membership update failed.
successful_users	`[User!]`	The users for whom the team membership update succeeded.

An object containing the attributes of the team to create.

Field	Type	Description
is_guest_team	`Boolean`	Whether the new team contains guest users.
name	`String!`	The new team's name.
parent_team_id	`ID`	The parent team's unique identifier.
subscriber_ids	`[ID!]`	The team members' unique identifiers. Cannot be empty unless `allow_empty_team` is set.

An object containing the options for the team to create.

Field	Type	Description
allow_empty_team	`Boolean`	Whether or not the team can have no subscribers.

An object containing the result of removing team owners via the API.

Field	Type	Description
errors	`[RemoveTeamOwnersError!]`	The errors that occurred while removing owners from a team. Use this field to check for calls that failed.
team	`Team`	The team the owners were removed from.

An object containing the error that occurred when a remove_team_owners mutation fails.

Field	Type	Description	Enum values
code	`RemoveTeamOwnersErrorCode`	The error code that occurred.	`CANNOT_UPDATE_SELF` `EXCEEDS_BATCH_LIMIT` `FAILED` `INVALID_INPUT` `USER_NOT_FOUND` `USER_NOT_MEMBER_OF_TEAM` `VIEWERS_OR_GUESTS`
message	`String`	The error message.
user_id	`ID`	The unique identifier of the user that caused the error.