Add/Delete rules - Twitter API v2

Add or delete rules from a user's active rule set. Users can provide unique, optionally tagged rules to add. Users can delete their entire rule set or a subset specified by rule ids or values.

curl --location --request POST 'https://api.twitter.com/2/tweets/search/stream/rules' \ --header 'Content-Type: application/json' \ --data-raw '{ "add": [ { "tag": "Non-retweeted coffee tweets", "value": "coffee -is:retweet" } ] }'

{ "data": [ { "id": "120897978112909812", "tag": "Non-retweeted coffee tweets", "value": "coffee -is:retweet" } ], "meta": { "sent": "string", "summary": { "created": 1, "invalid": 1, "not_created": 1, "valid": 1 } } }

Request

Query Params

dry_run

string

optional

Dry Run can be used with both the add and delete action, with the expected result given, but without actually taking any action in the system (meaning the end state will always be as it was when the request was submitted). This is particularly useful to validate rule changes.

Body Params application/json

AddOrDeleteRulesRequest

optional

One of

AddRulesRequest

DeleteRulesRequest

A request to add a user-specified stream filtering rule.

add

array[object (RuleNoId) {2}]

required

Examples

Responses

🟢200The request was successful

application/json

Body

AddOrDeleteRulesResponse

optional

One of

AddRulesResponse

DeleteRulesResponse

A response from adding user-specified stream filtering rules.

data

array[object (Rule) {3}]

required

All user-specified stream filtering rules that were created.