---
title: "Change the user's username"
method: POST
path: "/v2/username"
tags: ["Accounts"]
---

# Change the user's username

`POST /v2/username`

## Request body

- RobloxAuthenticationApiModelsUsernameChangeRequest
  - `username` string
  - `password` string

## Response `200`

OK

- RobloxWebWebAPIApiEmptyResponseModel

## Other responses

- `400` — 5: You don't have enough Robux to change your username. 10: This username is already in use 11: Username not appropriate for Roblox 12: Usernames can be 3 to 20 characters long 13: Usernames can’t start or end with _ and can have at most one _ 14: Only a-z, A-Z, 0-9, and _ are allowed 15: Username is null 16: Username might contain private information 17: This username is not available 18: Username is same as current
- `401` — 0: Authorization has been denied for this request.
- `403` — 0: Token Validation Failed 1: PIN is locked. 2: A verified email is missing 3: Your password is incorrect. 100: Unknown birthday
- `500` — 0: An unknown error occured. 5: You don't have enough Robux to change your username.
- `503` — 4: The feature is currently not available. Please try again later.

## Changes

- **2026-09-03** `d9b4ae8b3380` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/roblox/apis/roblox-api/changes/v2/username/post.md)

---

[API](https://skmtc.dev/roblox/apis/roblox-api.md) · [All operations](https://skmtc.dev/roblox/apis/roblox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/roblox/roblox-api/revisions/d9b4ae8b3380/schema)