> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lucidworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Rewrite API

export const LwTemplate = ({title = "Key questions to get you started", icon = "sparkles", cta = "Powered by Agent Studio", linkHref = "https://lucidworks.com/demo/?utm_source=docs&utm_medium=referral&utm_campaign=docs_cta_ai"}) => {
  const [isLoaded, setIsLoaded] = useState(false);
  useEffect(() => {
    const timer = setTimeout(() => {
      setIsLoaded(true);
    }, 500);
    return () => clearTimeout(timer);
  }, []);
  return <div className="lw-template-container">
      <Card title={title} icon={icon}>
        {isLoaded && <span dangerouslySetInnerHTML={{
    __html: `<lw-template id="a029c1a9-28be-427e-b0e1-5d918920246a"></lw-template
            >`
  }} />}
        <Link href={linkHref} className="agent-studio-link text-left text-gray-600 gap-2 dark:text-gray-400 text-sm font-medium flex flex-row items-center hover:text-primary dark:hover:text-primary-light group-hover:text-primary group-hover:dark:text-primary-light">Powered by Lucidworks Agent Studio</Link>
      </Card>
    </div>;
};

[localhost link]: http://localhost:3000/docs/4/fusion-ai/reference/api/query-rewrite-api

[mintlify link]: https://doc.lucidworks.com/docs/4/fusion-ai/reference/api/query-rewrite-api

[old doc.lw link]: https://doc.lucidworks.com/fusion/5.9/547

This API manages documents used for [query rewriting](/docs/4/fusion-ai/concepts/query-rewriting/overview).

<Note>
  This API requires a [Fusion AI license](/docs/4/fusion-ai/reference/licensing).
</Note>

<LwTemplate />

## Examples

### Create a blocklist rule

```bash wrap  theme={"dark"}
curl -u USERNAME:PASSWORD -XPOST -H "Content-type:application/json" https://FUSION_HOST:8764/api/apps/APP_NAME/query-rewrite/instances -d
'{
  "id": "block_list_rule_1",
  "name": "block_list_rule_1",
  "type": "block_list",
  "field_name": "id",
  "field_values": ["6","17"],
  "enabled": true,
  "priority":11,
  "search_terms":["life"],
  "matching": "keywords"
}'
```

### Update specific fields in an existing rule

```bash wrap  theme={"dark"}
curl -u USERNAME:PASSWORD -XPUT -H "Content-type:application/json" https://FUSION_HOST:8764/api/apps/APP_NAME/query-rewrite/instances -d
'{
  "id": "block_list_rule_1",
  "name": "block_list_rule_1",
  "type": "block_list",
  "field_name": "id",
  "field_values": ["6","17"],
  "enabled": false,
  "priority":9,
  "search_terms":["life"],
  "matching": "keywords"
}'
```

### Publish rules in the staging area

```bash wrap  theme={"dark"}
curl -u USERNAME:PASSWORD -XPUT -H 'Content-Type: application/json' https://FUSION_HOST:8764/api/apollo/apps/APP_NAME/query-rewrite/publish
```

### Delete a published rule

```bash wrap  theme={"dark"}
curl -u USERNAME:PASSWORD -XPUT -H "Content-type:application/json" https://FUSION_HOST:8764/api/apollo/apps/APP_NAME/query-rewrite/instances -d
'{
  "delete": [ “block_list_rule_1" ]
}'
```

### Publish an operation

```bash wrap  theme={"dark"}
curl -u USERNAME:PASSWORD -XPUT -H "Content-type:application/json" https://FUSION_HOST:8764/api/apollo/apps/APP_NAME/query-rewrite/publish
```