The monday.com teams API lets you manage and retrieve team information, including their owners, members, and configuration.

The object types below provide additional data structures used across the teams API’s CRUD operations. They extend the core types documented in the main teams reference and are used to create and configure teams, update ownership, and retrieve detailed team information.

AssignTeamOwnersResult

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

Field	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	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.

ChangeTeamMembershipsResult

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

Field	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.

CreateTeamAttributesInput

An object containing the attributes of the team to create.

Field	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.

CreateTeamOptionsInput

An object containing the options for the team to create.

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

RemoveTeamOwnersResult

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

Field	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.

RemoveTeamOwnersError

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

Field	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.