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

# Change club roster membership status

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

## Request

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

Same canManageTeam gate. Changes status without resending the rest of the player. departed sets isActive false and, when departedAt is omitted and unset, fills departedAt with today (UTC). signed, tryout, loan, and injured set isActive true. Leaving departed clears departedAt unless the body sends one. Date keys are optional; omit a key to leave that date unchanged, or send null to clear it. Sets rosterProvenance to club. Never deletes the row.

## Path parameters

- `teamId` string, required
- `playerId` string, required

## Request body

- object
  - `status` 'signed' | 'tryout' | 'loan' | 'injured' | 'departed', required
  - `signedAt` string, nullable: YYYY-MM-DD. Omit to leave unchanged.
  - `departedAt` string, nullable: YYYY-MM-DD. Omit to leave unchanged, except the departed default above.

## 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

## 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/status/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)
