--- description: Migrate from the legacy AutoRAG REST API endpoints to the new AI Search API endpoints. title: REST API migration image: https://developers.cloudflare.com/og-docs.png --- [Skip to content](#main-content) > Documentation Index > Fetch the complete documentation index at: https://developers.cloudflare.com/ai-search/llms.txt > Use this file to discover all available pages before exploring further. # REST API migration Last updated Aug 25, 2026|Copy as Markdown|[View as Markdown](https://4f1c5cd2.previews.developers.cloudflare.com/ai-search/api/migration/rest-api/index.md)|[Agent setup](https://4f1c5cd2.previews.developers.cloudflare.com/agent-setup/) The [AutoRAG API endpoints](https://4f1c5cd2.previews.developers.cloudflare.com/api/resources/autorag/) are the legacy REST API for AI Search. They will continue to work, but all new features and improvements are only available through the new [AI Search API endpoints](https://4f1c5cd2.previews.developers.cloudflare.com/ai-search/api/search/rest-api/). ## Endpoint changes The legacy AutoRAG API endpoints under `/autorag/rags/` have been replaced by new endpoints under `/ai-search/instances/`. | Description | New endpoint | Reference | | ---------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | Chat completions | /ai-search/instances/{name}/chat/completions | [API reference](https://4f1c5cd2.previews.developers.cloudflare.com/api/resources/ai%5Fsearch/subresources/instances/methods/chat%5Fcompletions/) | | Search | /ai-search/instances/{name}/search | [API reference](https://4f1c5cd2.previews.developers.cloudflare.com/api/resources/ai%5Fsearch/subresources/instances/methods/search/) | The new API also includes endpoints for [instance management](https://4f1c5cd2.previews.developers.cloudflare.com/ai-search/api/instances/rest-api/), [items](https://4f1c5cd2.previews.developers.cloudflare.com/ai-search/api/items/rest-api/), and [namespace-level search](https://4f1c5cd2.previews.developers.cloudflare.com/ai-search/api/search/rest-api/#cross-instance-search-and-chat) that are not available in the legacy API. For the legacy endpoints, refer to the [AutoRAG API reference](https://4f1c5cd2.previews.developers.cloudflare.com/api/resources/autorag/). ## API token permissions The legacy AutoRAG endpoints used the **AutoRAG** API token permission. The new AI Search endpoints require the **AI Search** permission instead, so update the permissions on the token you use to call the API. We recommend using [account API tokens](https://4f1c5cd2.previews.developers.cloudflare.com/fundamentals/api/get-started/account-owned-tokens/), which are owned by the account rather than a single user, and adding the **AI Search** permission found under **AI & Machine Learning** \> **AI Search**. ### Create a new token 1. In the Cloudflare dashboard, go to **Manage Account** \> **API Tokens**. 2. Select **Create Token**, then start a custom token. 3. Enter a name for the token. 4. Add a permission policy and select **AI & Machine Learning** \> **AI Search**, then choose the access level you need. AI Search offers **Read**, **Run**, and **Edit** access. 5. (Optional) Set client IP address filtering and a token expiration. 6. Create the token and copy its value. ### Edit an existing token 1. In the Cloudflare dashboard, go to **Manage Account** \> **API Tokens**. 2. Select the token you want to update. 3. Add or update a permission policy to include **AI & Machine Learning** \> **AI Search** with the access level you need, then save. For the full token creation flow, refer to [Create API token](https://4f1c5cd2.previews.developers.cloudflare.com/fundamentals/api/get-started/create-token/). ## Chat completions How to migrate from the AutoRAG `/ai-search` endpoint to the new `/chat/completions` endpoint: **Before (AutoRAG API):** ```bash curl -X POST "https://api.cloudflare.com/client/v4/accounts//autorag/rags//ai-search" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer " \ -d '{ "query": "What is Cloudflare?" }' ``` **After (AI Search API):** The new API uses the `messages` array format. ```bash curl -X POST "https://api.cloudflare.com/client/v4/accounts//ai-search/instances//chat/completions" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer " \ -d '{ "messages": [ { "content": "What is Cloudflare?", "role": "user" } ] }' ``` ## Search How to migrate from the AutoRAG `/search` endpoint to the new `/search` endpoint: **Before (AutoRAG API):** ```bash curl -X POST "https://api.cloudflare.com/client/v4/accounts//autorag/rags//search" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer " \ -d '{ "query": "What is Cloudflare?" }' ``` **After (AI Search API):** The new API uses the `messages` array format. The `query` string format is also supported. ```bash curl -X POST "https://api.cloudflare.com/client/v4/accounts//ai-search/instances//search" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer " \ -d '{ "messages": [ { "content": "What is Cloudflare?", "role": "user" } ] }' ``` ## Streaming behavior changes In the old AutoRAG API, when `stream` was set to `true`, you would only receive the streamed response without the retrieved chunks. In the new AI Search API, streaming responses include the chunks. The retrieved chunks are sent first as a `chunks` event, followed by the streamed response data. This allows you to display the source chunks immediately while streaming the generated response to the user. ## Filter format The new AI Search REST API uses Vectorize-style metadata filtering, which differs from the AutoRAG API format. Filters are now nested under `ai_search_options.retrieval.filters` in the request body. For full documentation of the old format, refer to [Metadata filter format (legacy)](https://4f1c5cd2.previews.developers.cloudflare.com/ai-search/api/migration/autorag-filter-format/). ### Operator mapping The filter operators have been renamed to use a `$` prefix: | AutoRAG API | AI Search API | | ----------- | ----------------- | | eq | $eq (or implicit) | | ne | $ne | | gt | $gt | | gte | $gte | | lt | $lt | | lte | $lte | | | $in (new) | | | $nin (new) | ### Examples #### Simple filter Filter by a single metadata field using implicit equality: **Before (AutoRAG API):** ```json { "filters": { "type": "eq", "key": "folder", "value": "customer-a/" } } ``` **After (AI Search API):** ```json { "ai_search_options": { "retrieval": { "filters": { "folder": "customer-a/" } } } } ``` #### Compound filter (AND) Combine multiple conditions where all must match: **Before (AutoRAG API):** ```json { "filters": { "type": "and", "filters": [ { "type": "eq", "key": "folder", "value": "customer-a/" }, { "type": "gte", "key": "timestamp", "value": "1735689600000" } ] } } ``` **After (AI Search API):** ```json { "ai_search_options": { "retrieval": { "filters": { "folder": "customer-a/", "timestamp": { "$gte": 1735689600 } } } } } ``` ## API references * [REST API documentation](https://4f1c5cd2.previews.developers.cloudflare.com/ai-search/api/search/rest-api/) * [Chat Completions API reference](https://4f1c5cd2.previews.developers.cloudflare.com/api/resources/ai%5Fsearch/subresources/instances/methods/chat%5Fcompletions/) * [Search API reference](https://4f1c5cd2.previews.developers.cloudflare.com/api/resources/ai%5Fsearch/subresources/instances/methods/search/) * [Legacy AutoRAG API reference](https://4f1c5cd2.previews.developers.cloudflare.com/api/resources/autorag/) Was this helpful? YesNo ## On this page [![](https://4f1c5cd2.previews.developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://4f1c5cd2.previews.developers.cloudflare.com/) ```json {"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/ai-search/api/migration/rest-api/#page","headline":"REST API migration ยท Cloudflare AI Search docs","description":"Migrate from the legacy AutoRAG REST API endpoints to the new AI Search API endpoints.","url":"https://developers.cloudflare.com/ai-search/api/migration/rest-api/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","dateModified":"2026-08-25","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}} ```