---
title: "Merge starred teams snapshot"
method: POST
path: "/api/me/starred-teams"
tags: ["Teams"]
---

# Merge starred teams snapshot

`POST /api/me/starred-teams`

## Request

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

Additive bulk merge — the one-time MMKV migration path for engage-native. Existing ids refresh their stored snapshot; new ids are starred until the 50-club cap; entries past the cap are counted in `skipped` rather than failing, with per-entry detail in `rejected` ([{ id, reason }], reason 'invalid' | 'over_cap', input order; `skipped` semantics unchanged). Body: { teams: [{ id, slug?, name?, logo? }] }.

## Request body

- object
  - `teams` object[], required
    - `id` string, required
    - `slug` string, nullable
    - `name` string, nullable
    - `logo` string, nullable

## Response `200`

{ success, data: { teams, added, skipped, rejected: [{ id: string | null, reason: 'invalid' | 'over_cap' }] } }

## Other responses

- `400`: VALIDATION_ERROR — teams must be an array
- `401`: Authentication required

## 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/post.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)
