--- title: AI Search --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [AutoRAG](https://developers.cloudflare.com/api/resources/autorag) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # AI Search Deprecated: Use AI Search instead. POST/accounts/{account\_id}/autorag/rags/{id}/ai-search Runs an AI Search query against an AutoRAG. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

##### Accepted Permissions (at least one required) `Auto Rag Write` ##### P ath ParametersExpand Collapse account\_id: string [Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) id: string rag id maxLength32 minLength1 [Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(params)%20default%20%3E%20(param)%20id%20%3E%20(schema)>) ##### Body ParametersJSONExpand Collapse query: string [Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(params)%200%20%3E%20(param)%20query%20%3E%20(schema)>)

filters: optional object {key, type, value } or object {filters, type }

One of the following:

object {key, type, value }

key: string Link to this property

type: "eq"or "ne"or "gt"or 3 more

One of the following: "eq" Link to this property "ne" Link to this property "gt" Link to this property "gte" Link to this property "lt" Link to this property "lte" Link to this property

Link to this property

value: stringor numberor boolean

One of the following: string Link to this property number Link to this property boolean Link to this property

Link to this property

object {filters, type }

filters: array of object {key, type, value }

key: string Link to this property

type: "eq"or "ne"or "gt"or 3 more

One of the following: "eq" Link to this property "ne" Link to this property "gt" Link to this property "gte" Link to this property "lt" Link to this property "lte" Link to this property

Link to this property

value: stringor numberor boolean

One of the following: string Link to this property number Link to this property boolean Link to this property

Link to this property

type: "and"or "or"

One of the following: "and" Link to this property "or" Link to this property

Link to this property

[Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(params)%200%20%3E%20(param)%20filters%20%3E%20(schema)>) max\_num\_results: optional number maximum50 minimum1 [Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(params)%200%20%3E%20(param)%20max_num_results%20%3E%20(schema)>)

model: optional "@cf/meta/llama-3.3-70b-instruct-fp8-fast"or "@cf/meta/llama-3.1-8b-instruct-fast"or "@cf/meta/llama-3.1-8b-instruct-fp8"or 23 more

One of the following: "@cf/meta/llama-3.3-70b-instruct-fp8-fast" Link to this property "@cf/meta/llama-3.1-8b-instruct-fast" Link to this property "@cf/meta/llama-3.1-8b-instruct-fp8" Link to this property "@cf/meta/llama-4-scout-17b-16e-instruct" Link to this property "@cf/qwen/qwen3-30b-a3b-fp8" Link to this property "@cf/deepseek-ai/deepseek-r1-distill-qwen-32b" Link to this property "@cf/moonshotai/kimi-k2-instruct" Link to this property "anthropic/claude-3-7-sonnet" Link to this property "anthropic/claude-sonnet-4" Link to this property "anthropic/claude-opus-4" Link to this property "anthropic/claude-3-5-haiku" Link to this property "cerebras/qwen-3-235b-a22b-instruct" Link to this property "cerebras/qwen-3-235b-a22b-thinking" Link to this property "cerebras/llama-3.3-70b" Link to this property "cerebras/llama-4-maverick-17b-128e-instruct" Link to this property "cerebras/llama-4-scout-17b-16e-instruct" Link to this property "cerebras/gpt-oss-120b" Link to this property "google-ai-studio/gemini-2.5-flash" Link to this property "google-ai-studio/gemini-2.5-pro" Link to this property "grok/grok-4" Link to this property "groq/llama-3.3-70b-versatile" Link to this property "groq/llama-3.1-8b-instant" Link to this property "openai/gpt-5" Link to this property "openai/gpt-5-mini" Link to this property "openai/gpt-5-nano" Link to this property "" Link to this property

[Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(params)%200%20%3E%20(param)%20model%20%3E%20(schema)>)

ranking\_options: optional object {ranker, score\_threshold }

ranker: optional string Link to this property score\_threshold: optional number maximum1 minimum0 Link to this property

[Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(params)%200%20%3E%20(param)%20ranking_options%20%3E%20(schema)>)

reranking: optional object {enabled, model }

enabled: optional boolean Link to this property

model: optional "@cf/baai/bge-reranker-base"or ""

One of the following: "@cf/baai/bge-reranker-base" Link to this property "" Link to this property

Link to this property

[Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(params)%200%20%3E%20(param)%20reranking%20%3E%20(schema)>) rewrite\_query: optional boolean [Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(params)%200%20%3E%20(param)%20rewrite_query%20%3E%20(schema)>) stream: optional boolean [Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(params)%200%20%3E%20(param)%20stream%20%3E%20(schema)>) system\_prompt: optional string [Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(params)%200%20%3E%20(param)%20system_prompt%20%3E%20(schema)>) ##### ReturnsExpand Collapse

result: object {response, search\_query, data, 3 more }

response: string Link to this property search\_query: string Link to this property

data: optional array of object {score, attributes, content, 2 more }

score: number Link to this property attributes: optional unknown Link to this property

content: optional array of object {text, type }

text: optional string Link to this property type: optional string Link to this property

Link to this property file\_id: optional string Link to this property filename: optional string Link to this property

Link to this property has\_more: optional boolean Link to this property next\_page: optional string Link to this property object: optional string Link to this property

[Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: boolean [Link to this property](<#(resource)%20autorag%20%3E%20(method)%20ai_search%20%3E%20(network%20schema)%20%3E%20(property)%20success>) ### AI Search HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/autorag/rags/$ID/ai-search \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ -d '{ "query": "query" }' ``` 200 example ``` { "result": { "response": "response", "search_query": "search_query", "data": [ { "score": 0, "attributes": {}, "content": [ { "text": "text", "type": "type" } ], "file_id": "file_id", "filename": "filename" } ], "has_more": true, "next_page": "next_page", "object": "object" }, "success": true } ``` ##### Returns Examples 200 example ``` { "result": { "response": "response", "search_query": "search_query", "data": [ { "score": 0, "attributes": {}, "content": [ { "text": "text", "type": "type" } ], "file_id": "file_id", "filename": "filename" } ], "has_more": true, "next_page": "next_page", "object": "object" }, "success": true } ```