---
title: "Add/Delete rules"
method: POST
path: "/2/tweets/search/stream/rules"
tags: ["Tweets"]
---

# Add/Delete rules

`POST /2/tweets/search/stream/rules`

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.

## Query parameters

- `dry_run` boolean

## Request body

- union
  - AddRulesRequest — A request to add a user-specified stream filtering rule.
    - `add` RuleNoId[], required
      - `tag` string — A tag meant for the labeling of user provided rules.
      - `value` string, required — The filterlang value of the rule.
  - DeleteRulesRequest — A response from deleting user-specified stream filtering rules.
    - `delete` object, required — IDs and values of all deleted user-specified stream filtering rules.
      - `ids` RuleId[] — IDs of all deleted user-specified stream filtering rules.
      - `values` RuleValue[] — Values of all deleted user-specified stream filtering rules.

## Response `200`

The request has succeeded.

- AddOrDeleteRulesResponse — A response from modifying user-specified stream filtering rules.
  - `data` Rule[] — All user-specified stream filtering rules that were created.
    - `id` string — Unique identifier of this rule.
    - `tag` string — A tag meant for the labeling of user provided rules.
    - `value` string, required — The filterlang value of the rule.
  - `errors` Problem[]
    - `detail` string
    - `status` integer
    - `title` string, required
    - `type` string, required
  - `meta` RulesResponseMetadata, required
    - `next_token` string — The next token.
    - `result_count` integer — Number of Rules in result set.
    - `sent` string, required
    - `summary` union
      - object — A summary of the results of the addition of user-specified stream filtering rules.
        - `created` integer, required — Number of user-specified stream filtering rules that were created.
        - `invalid` integer, required — Number of invalid user-specified stream filtering rules.
        - `not_created` integer, required — Number of user-specified stream filtering rules that were not created.
        - `valid` integer, required — Number of valid user-specified stream filtering rules.
      - object
        - `deleted` integer, required — Number of user-specified stream filtering rules that were deleted.
        - `not_deleted` integer, required — Number of user-specified stream filtering rules that were not deleted.

## Other responses

- `default` — The request has failed.

---

[API](https://skmtc.net/mfullbrook/apis/current.md) · [All operations](https://skmtc.net/mfullbrook/apis/current/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mfullbrook/current/versions/4b066912ce32/schema)