---
title: "Add club roster player"
method: POST
path: "/api/admin/teams/{teamId}/roster"
tags: ["Admin", "Teams"]
---

# Add club roster player

`POST /api/admin/teams/{teamId}/roster`

## Request

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

Same canManageTeam gate as GET. Creates a player with rosterProvenance and vendorProvider "club". status departed stores isActive false. Never deletes. 409 when the normalized name already exists on the team.

## Path parameters

- `teamId` string, required

## Request body

- object
  - `name` string, required
  - `jerseyNumber` integer, nullable, required
  - `position` 'G' | 'D' | 'C' | 'LW' | 'RW' | 'F', required
  - `status` 'signed' | 'tryout' | 'loan' | 'injured' | 'departed', required
  - `signedAt` string, nullable, required: YYYY-MM-DD or null
  - `departedAt` string, nullable, required: YYYY-MM-DD or null

## Response `201`

{ success, data: { id, isActive, status, signedAt, departedAt } }

## Other responses

- `400`: { success: false, error, code: VALIDATION_ERROR }
- `401`: { success: false, error, code: UNAUTHORIZED }
- `403`: { success: false, error, code: FORBIDDEN }
- `404`: { success: false, error, code: NOT_FOUND }
- `409`: { success: false, error, code: CONFLICT }

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

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