Skip to main content
POST
X account connection API to retry failed accounts
Free. This endpoint does not consume credits.
Bulk retry clears only transient and automated login-failure states. It does not update passwords, TOTP secret keys, passkeys, email challenges, locked accounts, or suspended accounts. Use re-authentication or reconnect for credential and 2FA fixes. Resolve locks or suspensions on X first.
This route clears temporary login-failure state. Those accounts retry on the next read, write, monitor, or account action. Use it when the dashboard shows accounts with temporary issues.

What gets retried

Xquik clears temporary issues

Xquik clears accounts whose stored failure reason is transient or automated. These accounts become eligible to reconnect on their next use.

Xquik skips credential fixes

Accounts that need fresh credentials or a security challenge stay unchanged. Use Re-authenticate or reconnect the account instead.

X restrictions stay blocked

Locked and suspended accounts stay unchanged. Resolve the restriction on X first, then re-authenticate or reconnect if needed.

Response is an aggregate

The API returns only cleared, the number of accounts reset for retry. Call List X Accounts before and after if you need per-account status.
The dashboard button works the same way. It appears when accounts have temporary issues. After you confirm, it clears retryable failures and refreshes the account list. It does not reconnect the accounts immediately.

Headers

string
required
Your API key. Generate a key from the dashboard.

Response

200 OK

integer
Number of accounts cleared for retry.

401 Unauthenticated

Missing or invalid API key.

429 Rate limited

Wait for the Retry-After value before retrying account recovery again.
Related. List X Accounts to check account statuses, or Re-authenticate to fix one account.