---
title: "Replace Overwatch Usernames"
method: PUT
path: "/api/v3/users/{user_id}/overwatch"
tags: ["Users"]
---

# Replace Overwatch Usernames

`PUT /api/v3/users/{user_id}/overwatch`

Replace the Overwatch usernames for a user. This clears all existing entries and inserts the provided list. Use `is_primary` on exactly one entry to mark it as primary.

## Path parameters

- `user_id` integer, required

## Request body

- OverwatchUsernamesUpdateRequest
  - `usernames` OverwatchUsernameItem[], required
    - `username` string, required
    - `is_primary` boolean

## Response `200`

Request fulfilled, document follows

- object

## Other responses

- `400` — Bad request syntax or unsupported method

---

[API](https://skmtc.net/genji/apis/genji-shimada-api.md) · [All operations](https://skmtc.net/genji/apis/genji-shimada-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/genji/genji-shimada-api/versions/6db12055b305/schema)