post-collections-entries-move

POST collections/entries/move

Move a specified Tweet to a new position in a curation_reverse_chron ordered collection.

Resource URL¶

https://api.x.com/1.1/collections/entries/move.json

Resource Information¶

Response formats	JSON
Requires authentication?	Yes (user context only)
Rate limited?	Yes

Parameters¶

Name	Required	Description	Default Value	Example
id	required	The identifier of the Collection receiving the Tweet.		custom-388061495298244609
tweet_id	required	The identifier of the Tweet to add to the Collection.		390839888012382208
relative_to	required	The identifier of the Tweet used for relative positioning.		614929127313965056
above	optional	Set to false to insert the specified tweet_id below the relative_to Tweet in the collection. Default: true		false

Example Request¶

POST https://api.x.com/1.1/collections/entries/move.json?id=custom-388061495298244609&tweet_id=390839888012382208&relative_to=614929127313965056

Example Response¶

Success:¶

{
  "objects": {},
  "response": {
    "errors": []
  }
}

Failure:¶

{
  "objects": {},
  "response": {
    "errors": [
      {
        "change": {
          "op": "move",
          "tweet_id": "610990849493762050"
        },
        "reason": "not_found"
      }
    ]
  }
}