POST collections/entries/move
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.twitter.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.twitter.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"
      }
    ]
  }
}