# Update player metadata

`POST https://api.nexus.gg/v1/manage/members/player/{playerId}/metadata`

Overwrites the `displayName` stored against a group member you already have a `playerId` for. A missing member returns `404` with `code: CodeNotInGroup`. The request body replaces `displayName` outright rather than merging it in: sending a body without `displayName` (for example `{}`) clears any previously stored value instead of leaving it untouched. Only `displayName` is read from the body; other properties are not stored. This method authenticates with a **secret** (`nexus_sk_...`) key.

## Authorizations

- `X-SHARED-SECRET` (string, header, required) - Send your **secret** API key (`nexus_sk_...`) in the `X-SHARED-SECRET` header. [Generate one](/authentication/api-keys/) in the Publisher Dashboard.

## Path parameters

- `playerId` (string, required) - Member player id. This is your internal unique identifier that was used to create this code or when linking to a Nexus.

## Query parameters

- `groupId` (string) - Creator group to use for this operation. If your key is scoped to a single program, that group is always used regardless of this value; otherwise falls back to your default group when omitted.

## Request body (`application/x-www-form-urlencoded`)

- `displayName` (string) - The players in game display name

## Responses

### 200

member object for given playerId

#### Body (`application/json`)

- `id` (string)
- `name` (string)
- `playerId` (string) - Your unique identifier for this user or player, provided when the code was created or when an existing nexus was linked to one of your user accounts
- `playerMetadata` (object) - Additional player information to be applied to this member (such as their in game display name)
- `logoImage` (string)
- `profileImage` (string)
- `codes` (array of object)

### 404

not found