# Teams

## List teams

 - [GET /rest/v2/teams](https://apidocs.rhythms.ai/rest/v2/teams/get_rest_v2_teams.md): Retrieves all teams via REST API

This endpoint supports filtering and pagination through query parameters. Available ransackable attributes: uuid, display_name, parent_uuid, status, name, is_org, parent_uuid.

Available ransackable associations and their attributes:
- team_memberships: team_memberships_uuid, team_memberships_user_uuid

## Create a new team

 - [POST /rest/v2/teams](https://apidocs.rhythms.ai/rest/v2/teams/post_rest_v2_teams.md): Creates a new team with the specified attributes, owners, and members

## Get a specific team

 - [GET /rest/v2/teams/{id}](https://apidocs.rhythms.ai/rest/v2/teams/get_rest_v2_teams_id.md): Retrieves detailed information about a specific team by its UUID

## Update a team

 - [PUT /rest/v2/teams/{id}](https://apidocs.rhythms.ai/rest/v2/teams/put_rest_v2_teams_id.md): Updates an existing team with the specified attributes, owners, and members

## Delete a team

 - [DELETE /rest/v2/teams/{id}](https://apidocs.rhythms.ai/rest/v2/teams/delete_rest_v2_teams_id.md): Deletes a team if it has no active sub-teams or OKR relationships