Skip to main content
PUT
Set X identity
Free - does not consume credits

Headers

x-api-key
string
required
Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.
Content-Type
string
required
Must be application/json.

Body

username
string
required
Your X username without the @ prefix. 1-15 characters, alphanumeric and underscores only. Stored as lowercase.

Response

success
boolean
Always true on successful update.
xUsername
string
The linked X username, lowercased.
Your X identity is used for own-account detection in tweet style analysis. You can update it at any time by calling this endpoint again.
Related: Get Account to view your current account details, or Analyze Style to cache tweets for style analysis.
Last modified on May 6, 2026