Skip to main content
DELETE
Twitter unmute API to unmute an X user by user ID
10 credits per call · All plans from $0.00012/credit
Each request unmutes 1 user by ID. Each request uses 1 connected X account. The user’s posts can show in that account’s timelines again.

Unmute one user by ID

Put the exact user ID in the request path. Put the connected account username or ID in the body. That account unmutes the user.

Save a receipt

Save the action first. Then update your local record.

Handle errors

Never infer failure from a client timeout. Poll a returned action before sending another request.
  • For 400, correct the user ID or account value.
  • For 401, replace invalid Xquik authentication.
  • For 402, add credits before another request.
  • For 403, reconnect the selected X account.
  • For 409, keep the original action and payload.
  • For 422, review the X rejection before retrying.
  • For 429, wait for Retry-After.
  • For 500 or 503, follow safeToRetry and terminal.

Headers

string
Send your Xquik API key in this header. Alternatively, send an OAuth 2.1 bearer token.
string
Send Bearer <token> instead of x-api-key when using OAuth 2.1.
string
required
Unique key for this intended write. Reuse it only for an exact network replay.
string
required
Must be application/json.

Path parameters

string
required
User to unmute. Send a user ID or a username with or without @. A URL-encoded profile URL such as x.com/nasa also works. An unknown username returns 422 x_target_not_found. See path IDs.

Body

string
required
X username or account ID identifying which connected X account acts. Xquik strips the @ prefix if included.

Response

Durable write recovery

Send one unique Idempotency-Key per intended write. Replay the same account, target, payload, and media after a lost response. Keep the original key for that replay.
  1. Store id, the nested hash in request, billing, and statusUrl.
  2. Poll after Retry-After or pollAfterMs when terminal is false.
  3. Retry only when safeToRetry is true.
  4. Use a new key when nextAction.requiresNewIdempotencyKey is true.

200 terminal or 202 active

  • After HTTP 200, store the result and settled billing.
  • After HTTP 202, poll the same action. Never submit another write.
  • After HTTP 400, fix the named field. Use a new idempotency key.
  • After HTTP 401, fix authentication. Do not retry unchanged.
  • After HTTP 402, fund the account before another write.
  • After HTTP 403, reconnect the account.
  • After HTTP 409, keep the original action. Use a new key for new input.
  • After HTTP 422, fix the rejected request before retrying.
  • After HTTP 429, wait for Retry-After. Follow nextAction.
See Get Write Action Status for every lifecycle field and terminal state. That page also lists every billing field and retry rule.