---
title: "Join team leaderboard"
method: POST
path: "/api/teams/{id}/join"
tags: ["Teams"]
---

# Join team leaderboard

`POST /api/teams/{id}/join`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/teams/{id}/join`
- Auth: HTTP bearer

Idempotent leaderboard membership only. Does not write TeamFollow. Returns { joinedTeamIds, followedTeamIds }. Joining a platform / non-joinable team (D-Sports slug, joinable:false, isGlobal, dsports_official) returns 409 CONFLICT before any board or entry write.

## Path parameters

- `id` string, required

## Response `200`

{ success, data }

## Other responses

- `409`: CONFLICT — platform / non-joinable team cannot be joined. No board or entry write.

## Changes

- **2026-09-12** `a8df6fe04343`: 1 info
  - added the non-success response with the status `409`
- **2026-08-17** `6a5e2c1b8022`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/teams/:id/join/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)
