---
title: "Assign roster players to a server label, or Main with null"
method: PATCH
path: "/v2/server/{serverId}/rosters/{rosterId}/member-label"
tags: ["Roster Builder"]
---

# Assign roster players to a server label, or Main with null

`PATCH /v2/server/{serverId}/rosters/{rosterId}/member-label`

## Request

- Base URL: `https://api.clashk.ing`
- URL: `https://api.clashk.ing/v2/server/{serverId}/rosters/{rosterId}/member-label`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
- TypeScript: <https://skmtc.dev/clashk/apis/clashking-api/docs/v2/server/:serverId/rosters/:rosterId/member-label/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `serverId` string, required: Discord snowflake as an unsigned decimal string
- `rosterId` string, required

## Request body

- object
  - `playerTags` string[], required
  - `memberGroupId` string, nullable, required

## Response `200`

Success

- object
  - `updated` union, required
    - number
    - 'NaN'
    - 'Infinity'
    - '-Infinity'

## Other responses

- `400`: Expected error
- `401`: Expected error
- `403`: Expected error
- `404`: Expected error
- `409`: Expected error
- `413`: Expected error
- `429`: Expected error
- `503`: Expected error

## Changes

- **2026-11-05** `f1874003a53d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clashk/apis/clashking-api/changes/v2/server/:serverId/rosters/:rosterId/member-label/patch.md)

---

[API](https://skmtc.dev/clashk/apis/clashking-api.md) - [All operations](https://skmtc.dev/clashk/apis/clashking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clashk/apis/clashking-api/revisions/41ffee7f4263?raw)