---
title: "Star a team"
method: PUT
path: "/api/me/starred-teams/{teamId}"
tags: ["Teams"]
---

# Star a team

`PUT /api/me/starred-teams/{teamId}`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/me/starred-teams/{teamId}`
- Auth: HTTP bearer

Idempotent bookmark — a star is not a follow and grants no social surface, so provider clubs are allowed. teamId need not resolve to a Team row yet. Optional body { slug?, name?, logo? } stores the client display snapshot; re-starring refreshes only the keys sent, and an explicit null clears a stored value. New stars past the 50-club cap return 409 STARRED_TEAMS_LIMIT.

## Path parameters

- `teamId` string, required

## Request body

- object
  - `slug` string, nullable
  - `name` string, nullable
  - `logo` string, nullable

## Response `200`

{ success, data: { starred: true, team } }

## Other responses

- `400`: VALIDATION_ERROR — teamId is required
- `401`: Authentication required
- `409`: STARRED_TEAMS_LIMIT — 50-club cap reached for a new id

## Changes

- **2026-09-24** `01971acf764b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/me/starred-teams/:teamId/put.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
