---
title: "Rename a user"
method: POST
path: "/admin/users/{username}/rename"
tags: ["admin"]
---

# Rename a user

`POST /admin/users/{username}/rename`

## Path parameters

- `username` string, required

## Request body

- RenameUserOption — RenameUserOption options when renaming a user
  - `new_username` string, required — New username for this user. This name cannot be in use yet by any other user.

## Response `204`

APIEmpty is an empty response

## Other responses

- `403` — APIForbiddenError is a forbidden error response
- `422` — APIValidationError is error format response related to input validation

---

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