X Write
Unretweet
Remove a retweet of a tweet by ID from a connected X account
DELETE
Unretweet
10 credits per call · All plans from $0.00012/credit
Headers
string
required
Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.
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
The ID of the tweet to unretweet.
Body
string
required
X username or account ID identifying which connected X account will unretweet. The
@ prefix is automatically stripped if included.Response
Durable lifecycle responses
Store the
X-Request-Id response header with every action record.- Store
id,request.hash,account,target, andbilling. - Stop only when
terminalistrue. - Poll
statusUrlafterRetry-AfterorpollAfterMs. - Retry only when
safeToRetryistrue. - Use a new key only for a newly approved write.
- 200 Terminal
- 202 Active
- 400 Invalid Input
- 401 Unauthenticated
- 402 Billing Required
- 403 Account Blocked
- 409 Idempotency conflict
- 422 Write Rejected
- 429 Rate Limited
- 500 Write Failed
The action reached
success, failed, or expired. Trust terminal,
result, billing, and nextAction over the HTTP class.string
Always
x_write_action.string
Durable action ID.
string
Compatibility alias for
id.string
Exact write operation.
string
Current lifecycle status.
boolean
Whether polling can stop.
boolean
Whether a later attempt could succeed.
boolean
Whether a new attempt is safe.
string
Relative polling URL.
number | null
Recommended polling delay.
boolean
Whether billing settled as charged.
string
Settled credits charged.
object
Planned and settled billing state.
object
Stable hash and exact sanitized payload.
object
Exact connected account selected.
object | null
Exact target type and ID.
string | null
Compatibility target ID.
object | null
Confirmed result or desired state.
object | null
Required poll, retry, or verification step.
string
Stable request fingerprint.
string
Correlation ID.
boolean
Whether this response replayed an existing action.
string
Machine-readable error code.
string
Actionable status or error message.
boolean
Whether dispatch occurred.
string
ISO 8601 dispatch time.
string
ISO 8601 creation time.
string
ISO 8601 latest update time.
string
ISO 8601 terminal time.
string
Nonterminal resolution deadline.
string
ISO 8601 confirmation time.
string
ISO 8601 latest confirmation check.
number
Confirmation attempt count.
string
Confirmed tweet ID when available.
string
Confirmed direct message ID when available.
string
Confirmed media ID when available.
string
Public media URL when available.
string
Confirmed community ID when available.
string
Confirmed community name when available.
string
Compatibility result ID.
object
Media details when used.
object
Structured recovery context.
boolean
Whether status is
success.Last modified on July 21, 2026
Unretweet