Retweet
Reposts a tweet through a connected X account.
Path parameters
Tweet ID to retweet
Headers
Use one unique value per intended write. Reuse it only for an identical retry. Matching retries return the original action. Different input returns 409. Protection lasts at least 90 days.
Request body
Example request
{
"account": "@elonmusk"
}Response
Write reached a terminal state.
Example response
{
"id": "12345",
"writeActionId": "12345",
"action": "like",
"status": "success",
"terminal": true,
"statusUrl": "/api/v1/x/write-actions/12345",
"pollAfterMs": 1000,
"charged": true,
"chargedCredits": "10",
"billing": {
"status": "charged",
"charged": true,
"plannedCredits": "10",
"chargedCredits": "10"
},
"request": {
"hash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
"payload": {
"tweet_id": "9876543210"
}
},
"account": {
"id": "42",
"username": "example"
},
"target": {
"type": "tweet",
"id": "9876543210"
},
"targetId": "9876543210",
"result": {
"type": "state_change",
"id": "9876543210",
"state": "liked"
},
"nextAction": {
"type": "poll",
"url": "/api/v1/x/write-actions/12345",
"afterMs": 2000
},
"requestHash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
"requestId": "01JZ8R7QSC9QKT0V7JX4M2A6B8",
"error": "x_write_ambiguous",
"message": "Invalid input. Check request fields.",
"sendDispatched": true,
"sendDispatchedAt": "2026-07-21T05:00:00Z",
"createdAt": "2026-07-21T05:00:00Z",
"updatedAt": "2026-07-21T05:00:02Z",
"completedAt": "2026-07-21T05:00:02Z",
"expiresAt": "2026-07-22T05:00:00Z",
"confirmedAt": "2026-07-21T05:00:02Z",
"confirmationCheckedAt": "2026-07-21T05:00:02Z",
"confirmationAttempts": 1,
"tweetId": "9876543210",
"messageId": "1234567890",
"mediaId": "2345678901",
"mediaUrl": "https://media.xquik.com/example.jpg",
"communityId": "3456789012",
"communityName": "Builders",
"resultId": "9876543210",
"media": {
"count": 1,
"kind": "image"
},
"details": {
"suggestion": "Poll the action status URL."
},
"success": true
}Changes
Changed in 11 of the 32 revisions of this API.12506
- ●
added the new
draw_too_largeenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
draw_too_largeenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
retweeters_incompleteenum value to the///////response property for the response statusresponse-property-enum-value-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ●
- ●
added the new
bookmark_folders_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
bookmark_folders_unavailableenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
- ●
added the new
search_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
search_unavailableenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
- ●
added the new
idempotency_in_progressenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
idempotency_in_progressenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
- ○
added the non-success response with the status
response-non-success-status-added
- ○
- ●
added the new
likes_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
likes_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
likes_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
likes_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
likes_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
likes_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
likes_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
likes_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
likes_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
likes_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
likes_unavailableenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
likes_unavailableenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
- ●
added the new
pagination_stalledenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
pagination_stalledenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
pagination_stalledenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
pagination_stalledenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
pagination_stalledenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
pagination_stalledenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
pagination_stalledenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
pagination_stalledenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
pagination_stalledenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
pagination_stalledenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
pagination_stalledenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
pagination_stalledenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
- ●
added the new
x_reply_not_allowedenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
x_reply_not_allowedenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
x_reply_not_allowedenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
x_reply_not_allowedenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
x_reply_not_allowedenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
x_reply_not_allowedenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
x_reply_not_allowedenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
x_reply_not_allowedenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
x_reply_not_allowedenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
x_reply_not_allowedenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
x_reply_not_allowedenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
x_reply_not_allowedenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
- ▲
the
/response's property type changed from no type toobjectfor statusresponse-property-type-changed
- ○
added 'propertyNames' constraint to the
/response property for the statusresponse-property-property-names-added
- ▲
- ●
added the new
closedenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
closedenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
closedenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
closedenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
closedenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
closedenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
closedenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
closedenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
closedenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
closedenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
closedenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
closedenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
added the new
expiredenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
expiredenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
expiredenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
expiredenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
expiredenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
expiredenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
expiredenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
expiredenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
expiredenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
expiredenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
expiredenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
expiredenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_complete_replies_requestenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_complete_replies_requestenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_complete_replies_requestenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_complete_replies_requestenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_complete_replies_requestenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_complete_replies_requestenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_complete_replies_requestenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_complete_replies_requestenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_complete_replies_requestenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_complete_replies_requestenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_complete_replies_requestenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_complete_replies_requestenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_coverage_requestenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_coverage_requestenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_coverage_requestenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_coverage_requestenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_coverage_requestenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_coverage_requestenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_coverage_requestenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_coverage_requestenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_coverage_requestenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_coverage_requestenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_coverage_requestenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_coverage_requestenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_output_optionsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_output_optionsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_output_optionsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_output_optionsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_output_optionsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_output_optionsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_output_optionsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_output_optionsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_output_optionsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_output_optionsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_output_optionsenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_output_optionsenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_reply_optionsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_reply_optionsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_reply_optionsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_reply_optionsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_reply_optionsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_reply_optionsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_reply_optionsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_reply_optionsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_reply_optionsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_reply_optionsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_reply_optionsenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
invalid_reply_optionsenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
added the new
login_service_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
login_service_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
login_service_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
login_service_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
login_service_unavailableenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
login_service_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
login_service_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
login_service_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
login_service_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
login_service_unavailableenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
login_service_unavailableenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
login_service_unavailableenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
added the new
missing_urlenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
missing_urlenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
missing_urlenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
missing_urlenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
missing_urlenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
missing_urlenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
missing_urlenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
missing_urlenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
missing_urlenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
missing_urlenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
missing_urlenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
missing_urlenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●
added the new
too_many_tweetsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
too_many_tweetsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
too_many_tweetsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
too_many_tweetsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
too_many_tweetsenum value to the/response property for the response statusresponse-property-enum-value-added
- ●
added the new
too_many_tweetsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
too_many_tweetsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
too_many_tweetsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
too_many_tweetsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
too_many_tweetsenum value to the//response property for the response statusresponse-property-enum-value-added
- ●
added the new
too_many_tweetsenum value to the//////response property for the response statusresponse-property-enum-value-added
- ●
added the new
too_many_tweetsenum value to the///////response property for the response statusresponse-property-enum-value-added
- ●