POST collections/entries/curate
post-collections-entries-curate

POST collections/entries/curate

Curate a Collection by adding or removing Tweets in bulk. Updates must be limited to 100 cumulative additions or removals per request.

Use POST collections / entries / add and POST collections / entries / remove to add or remove a single Tweet.

Resource URL

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

Resource Information

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

Parameters

Name Required Description Default Value Example

Example Request

POST https://api.x.com/1.1/collections/entries/curate.json

Example Response

POST /1.1/collections/entries/curate.json
Content-Type: application/json
Content-Length: 226
{"id":"custom-388061495298244609","changes":[{"op":"add","tweet_id":"390897780949925889"},{"op":"add","tweet_id":"390853164611555329"},{"op":"add","tweet_id":"390892747810295808"},{"op":"add","tweet_id":"390898463090561024"}]}

Success:

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

Failure:

{"objects":{},"response":{"errors":[{"reason":"duplicate","change":{"op":"add","tweet_id":"390897780949925889"}},{"reason":"duplicate","change":{"op":"add","tweet_id":"390853164611555329"}},{"reason":"duplicate","change":{"op":"add","tweet_id":"390892747810295808"}},{"reason":"duplicate","change":{"op":"add","tweet_id":"390898463090561024"}}]}}