v11

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0112893437.0 KB
X Accounts

Re-authenticate X account

post/x/accounts/{id}/reauth

Path parameters

idstring required

Resource ID returned by the matching create or list endpoint.

Request body

passwordstring required

Updated account password

totp_secretstring

Replacement Authenticator App TOTP secret. Omit it to reuse the saved secret.

emailstring

Email for the X account (updates stored email)

Example request

{
  "password": "<ACCOUNT_PASSWORD>",
  "totp_secret": "<TOTP_SECRET>",
  "email": "account@example.invalid"
}

Response

Re-authenticated

idstring required
xUserIdstring required
xUsernamestring required
status'active' required
health'healthy' | 'locked' | 'needsReauth' | 'recovering' | 'suspended' | 'temporaryIssue' required
createdAtstring date-time required

Example response

{
  "id": "42",
  "xUserId": "9876543210",
  "xUsername": "elonmusk",
  "status": "active",
  "health": "healthy",
  "createdAt": "2025-01-15T12:00:00Z"
}