> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcollate.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams

> Create and manage teams for organizing users and controlling access

# Teams

A **Team** is an organizational unit used to group users and control access to data assets. Teams support a hierarchical structure that mirrors your organization.

<Info>
  Entity schema follows the [OpenMetadata Standard](https://openmetadatastandards.org/teams-users/team/).
</Info>

## Entity Hierarchy

Teams can be nested in a strict hierarchy:

<CodeGroup>
  ```txt Team Hierarchy theme={null}
  Organization
  └── BusinessUnit
      └── Division
          └── Department
              └── Group (this is the most common team type)
  ```
</CodeGroup>

## Team Types

| Type | Description |
| - | - |
| `Organization` | Top-level entity representing the entire organization |
| `BusinessUnit` | A major business unit within the organization |
| `Division` | A division within a business unit |
| `Department` | A department within a division |
| `Group` | The most granular team type, typically used for day-to-day access control |

## Fully Qualified Name

The FQN format for a team is simply:

```
teamName
```

For example: `Accounting`

***

## API Endpoints

| Method | Endpoint | Description |
| - | - | - |
| `POST` | `/v1/teams` | [Create a team](/api-reference/teams-and-users/teams/create) |
| `GET` | `/v1/teams` | [List teams](/api-reference/teams-and-users/teams/list) |
| `GET` | `/v1/teams/{id}` | [Get by ID](/api-reference/teams-and-users/teams/retrieve) |
| `GET` | `/v1/teams/name/{fqn}` | [Get by FQN](/api-reference/teams-and-users/teams/retrieve) |
| `PATCH` | `/v1/teams/{id}` | [Update by ID](/api-reference/teams-and-users/teams/update) |
| `DELETE` | `/v1/teams/{id}` | [Delete by ID](/api-reference/teams-and-users/teams/delete) |
| `PUT` | `/v1/teams/restore` | [Restore soft-deleted team](/api-reference/teams-and-users/teams/delete) |
| `GET` | `/v1/teams/{id}/versions` | [List versions](/api-reference/teams-and-users/teams/versions) |
| `GET` | `/v1/teams/{id}/versions/{version}` | [Get specific version](/api-reference/teams-and-users/teams/versions) |