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

# Edit club roster player

`PATCH /api/admin/teams/{teamId}/roster/{playerId}`

## Request

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

Same canManageTeam gate. Replaces name, jersey, position, status, and dates. Sets rosterProvenance to club and keeps an existing vendor id. status departed sets isActive false; any other status sets isActive true. Never deletes the row.

## Path parameters

- `teamId` string, required
- `playerId` 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
  - `departedAt` string, nullable, required

## Response `200`

{ 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`: Player or team 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/:playerId/patch.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)
