> ## Documentation Index
> Fetch the complete documentation index at: https://285e39fd5e337e58f16290.sightscreen.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams

> Team registry, SportMonks import, and display overrides.

## Endpoint reference

| Method  | Route                        | Auth  | Purpose                     |
| ------- | ---------------------------- | ----- | --------------------------- |
| `GET`   | `/admin/teams`               | Admin | List all teams              |
| `POST`  | `/admin/teams`               | Admin | Create a team               |
| `PATCH` | `/admin/teams/:id`           | Admin | Update a team               |
| `POST`  | `/admin/teams/import`        | Admin | Bulk import from SportMonks |
| `PATCH` | `/admin/teams/:id/overrides` | Admin | Set display overrides       |

***

### GET /admin/teams `Admin`

Returns all teams in the system, including SportMonks metadata and any display overrides.

### POST /admin/teams `Admin`

Create a new team manually.

<ParamField body="name" type="string" required>
  Team display name.
</ParamField>

<ParamField body="shortName" type="string" required>
  Abbreviated name (e.g., "SIX" for Sydney Sixers).
</ParamField>

<ParamField body="sportMonksId" type="number">
  SportMonks team ID for linking to external data.
</ParamField>

### PATCH /admin/teams/:id `Admin`

Update team properties.

### POST /admin/teams/import `Admin`

Bulk import teams from SportMonks for the configured season. Matches existing teams by `sportMonksId` and creates new records for any unrecognized teams.

<Note>
  This does not delete teams that are no longer in SportMonks. It only creates or updates.
</Note>

### PATCH /admin/teams/:id/overrides `Admin`

Set display overrides for a team. Overrides take precedence over SportMonks data.

<ParamField body="displayName" type="string">
  Custom display name to use instead of the SportMonks name.
</ParamField>

<ParamField body="logoUrl" type="string">
  Custom logo URL.
</ParamField>

<ParamField body="primaryColor" type="string">
  Hex color code for the team's primary color.
</ParamField>