# Teams

Organize teammates and route conversations to the right group.

8 operations in the Teams resource group.

## Operations

- [List teams](/reference/teams/list-teams.md) - GET `/teams` - Returns teams that can own inboxes, conversations, and chatbot assignments.
- [Create team](/reference/teams/create-team.md) - POST `/teams` - Creates a team for routing conversations and organizing teammates.
- [Get team](/reference/teams/get-team.md) - GET `/teams/{id}` - Returns one team and its current agent assignments.
- [Update team](/reference/teams/update-team.md) - PUT `/teams/{id}` - Updates a team's display name or description.
- [Delete team](/reference/teams/delete-team.md) - DELETE `/teams/{id}` - Deletes a team that is no longer used for routing or assignments.
- [List team agents](/reference/teams/list-team-agents.md) - GET `/teams/{id}/agents` - Returns users assigned to the team.
- [Add agent to team](/reference/teams/add-agent-to-team.md) - POST `/teams/{id}/agents` - Assigns a user to the team so they can work conversations routed there.
- [Remove agent from team](/reference/teams/remove-agent-from-team.md) - DELETE `/teams/{id}/agents/{userId}` - Removes a user from the team.

## Schemas

- [ProblemDetails](/reference/schemas/problem-details.md) - object - RFC 9457 Problem Details response with a stable Flownally error code.
- [FieldViolation](/reference/schemas/field-violation.md) - object
- [Window](/reference/schemas/messaging-window.md) - object - Tells a client whether the current actor can send in this conversation right now.
- [ListTeamsResponse](/reference/schemas/list-teams-response.md) - object - Paginated teams in the workspace.
- [Team](/reference/schemas/team.md) - object - Group of teammates that can own inboxes and conversations.
- [CreateTeamRequest](/reference/schemas/create-team-request.md) - object - Team to create.
- [UpdateTeamRequest](/reference/schemas/update-team-request.md) - object
- [ListTeamAgentsResponse](/reference/schemas/list-team-agents-response.md) - object
- [UserAssignment](/reference/schemas/user-assignment.md) - object - Membership link between a user and a team.
- [AddAgentToTeamRequest](/reference/schemas/add-agent-to-team-request.md) - object - User to add to the team.