---
title: "Claim or change the signed-in account's Entire username"
method: PUT
path: "/api/v1/me/username"
tags: ["Me"]
---

# Claim or change the signed-in account's Entire username

`PUT /api/v1/me/username`

## Request

- Base URL: `https://entire.io` (the document declares no server; this is the origin it was published from)
- URL: `https://entire.io/api/v1/me/username`
- Auth: none declared

Before 1 Jan 2027 the username must equal the caller's own GitHub handle (403 otherwise). 409 means taken or held after a rename; 422 means invalid or reserved.

## Request body

- object
  - `username` string, required

## Response `200`

The username as stored

- object
  - `username` string, required

## Other responses

- `400`: Invalid request
- `401`: Not authenticated
- `403`: Access denied
- `404`: Resource not found
- `409`: Resource conflict
- `412`: Precondition failed
- `422`: Validation failed
- `429`: Too many requests
- `502`: Entire Core request failed
- `503`: Entire Core is unavailable

## Changes

- **2026-10-14** `932485b2df18`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/me/username/put.md)

---

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