---
search:
  tags:
    - Twitter Profile Actions Endpoints
    - POST
seo:
  description: >-
    修改 cookie 对应账号的 @用户名（screen name）。TwexAPI 会先向 X 确认新用户名是否可用：已被占用返回
    409；X…TwexAPI X (Twitter) API 中 POST /twitter/profile/username
    接口的参考文档。包含请求参数、响应结构和代码示例。
  title: 修改用户名 - X (Twitter) API 接口
sidebar:
  badge: POST
  label: 修改用户名
title: 修改用户名
type: openapi-operation
---
修改 `cookie` 对应账号的 @用户名（screen name）。TwexAPI 会先向 X 确认新用户名是否可用：已被占用返回 409；X 不接受的用户名（太短、保留字、不允许等）返回 400 并附 X 给出的原因，这两种情况都不会做任何修改。成功时返回 X 实际保存的用户名。修改显示名称请使用 `POST /twitter/profile`。必须同时提供 TwexAPI Bearer API Key 和该账号的有效 X Cookie 或 auth_token。

<Operation source="zh-api-reference" id="change-username" />
