published on Wednesday, Oct 21, 2026 by Pulumi
published on Wednesday, Oct 21, 2026 by Pulumi
Import
$ pulumi import cloudflare:index/aiSearchInstance:AiSearchInstance example '<account_id>/<id>'
Create AiSearchInstance Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new AiSearchInstance(name: string, args: AiSearchInstanceArgs, opts?: CustomResourceOptions);@overload
def AiSearchInstance(resource_name: str,
args: AiSearchInstanceArgs,
opts: Optional[ResourceOptions] = None)
@overload
def AiSearchInstance(resource_name: str,
opts: Optional[ResourceOptions] = None,
ai_search_instance_id: Optional[str] = None,
account_id: Optional[str] = None,
paused: Optional[bool] = None,
public_endpoint_params: Optional[AiSearchInstancePublicEndpointParamsArgs] = None,
cache: Optional[bool] = None,
cache_threshold: Optional[str] = None,
cache_ttl: Optional[float] = None,
chunk: Optional[bool] = None,
chunk_overlap: Optional[int] = None,
chunk_size: Optional[int] = None,
custom_metadatas: Optional[Sequence[AiSearchInstanceCustomMetadataArgs]] = None,
embedding_model: Optional[str] = None,
reranking: Optional[bool] = None,
hybrid_search_enabled: Optional[bool] = None,
index_method: Optional[AiSearchInstanceIndexMethodArgs] = None,
indexing_options: Optional[AiSearchInstanceIndexingOptionsArgs] = None,
max_num_results: Optional[int] = None,
metadata: Optional[AiSearchInstanceMetadataArgs] = None,
aisearch_model: Optional[str] = None,
ai_gateway_id: Optional[str] = None,
fusion_method: Optional[str] = None,
reranking_model: Optional[str] = None,
retrieval_options: Optional[AiSearchInstanceRetrievalOptionsArgs] = None,
rewrite_model: Optional[str] = None,
rewrite_query: Optional[bool] = None,
score_threshold: Optional[float] = None,
source: Optional[str] = None,
source_params: Optional[AiSearchInstanceSourceParamsArgs] = None,
summarization: Optional[bool] = None,
summarization_model: Optional[str] = None,
sync_interval: Optional[float] = None,
system_prompt_aisearch: Optional[str] = None,
system_prompt_index_summarization: Optional[str] = None,
system_prompt_rewrite_query: Optional[str] = None,
token_id: Optional[str] = None,
type: Optional[str] = None)func NewAiSearchInstance(ctx *Context, name string, args AiSearchInstanceArgs, opts ...ResourceOption) (*AiSearchInstance, error)public AiSearchInstance(string name, AiSearchInstanceArgs args, CustomResourceOptions? opts = null)
public AiSearchInstance(String name, AiSearchInstanceArgs args)
public AiSearchInstance(String name, AiSearchInstanceArgs args, CustomResourceOptions options)
type: cloudflare:AiSearchInstance
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "cloudflare_ai_search_instance" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args AiSearchInstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args AiSearchInstanceArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args AiSearchInstanceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args AiSearchInstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args AiSearchInstanceArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var aiSearchInstanceResource = new Cloudflare.AiSearchInstance("aiSearchInstanceResource", new()
{
AiSearchInstanceId = "string",
AccountId = "string",
Paused = false,
PublicEndpointParams = new Cloudflare.Inputs.AiSearchInstancePublicEndpointParamsArgs
{
AuthorizedHosts = new[]
{
"string",
},
ChatCompletionsEndpoint = new Cloudflare.Inputs.AiSearchInstancePublicEndpointParamsChatCompletionsEndpointArgs
{
Disabled = false,
},
CustomDomains = new[]
{
"string",
},
DefaultDomainEnabled = false,
Enabled = false,
Mcp = new Cloudflare.Inputs.AiSearchInstancePublicEndpointParamsMcpArgs
{
Description = "string",
Disabled = false,
},
RateLimit = new Cloudflare.Inputs.AiSearchInstancePublicEndpointParamsRateLimitArgs
{
PeriodMs = 0,
Requests = 0,
Technique = "string",
},
SearchEndpoint = new Cloudflare.Inputs.AiSearchInstancePublicEndpointParamsSearchEndpointArgs
{
Disabled = false,
},
},
Cache = false,
CacheThreshold = "string",
CacheTtl = 0.0,
Chunk = false,
ChunkOverlap = 0,
ChunkSize = 0,
CustomMetadatas = new[]
{
new Cloudflare.Inputs.AiSearchInstanceCustomMetadataArgs
{
DataType = "string",
FieldName = "string",
},
},
EmbeddingModel = "string",
Reranking = false,
IndexMethod = new Cloudflare.Inputs.AiSearchInstanceIndexMethodArgs
{
Keyword = false,
Vector = false,
},
IndexingOptions = new Cloudflare.Inputs.AiSearchInstanceIndexingOptionsArgs
{
KeywordTokenizer = "string",
UseOcr = false,
},
MaxNumResults = 0,
Metadata = new Cloudflare.Inputs.AiSearchInstanceMetadataArgs
{
CreatedFromAisearchWizard = false,
CreatedFromEmdashPlugin = new Cloudflare.Inputs.AiSearchInstanceMetadataCreatedFromEmdashPluginArgs
{
Type = "string",
Version = "string",
},
WorkerDomain = "string",
},
AisearchModel = "string",
AiGatewayId = "string",
FusionMethod = "string",
RerankingModel = "string",
RetrievalOptions = new Cloudflare.Inputs.AiSearchInstanceRetrievalOptionsArgs
{
BoostBies = new[]
{
new Cloudflare.Inputs.AiSearchInstanceRetrievalOptionsBoostByArgs
{
Field = "string",
Direction = "string",
},
},
KeywordMatchMode = "string",
},
RewriteModel = "string",
RewriteQuery = false,
ScoreThreshold = 0.0,
Source = "string",
SourceParams = new Cloudflare.Inputs.AiSearchInstanceSourceParamsArgs
{
ExcludeItems = new[]
{
"string",
},
IncludeItems = new[]
{
"string",
},
Prefix = "string",
R2Jurisdiction = "string",
WebCrawler = new Cloudflare.Inputs.AiSearchInstanceSourceParamsWebCrawlerArgs
{
StoreOptions = new Cloudflare.Inputs.AiSearchInstanceSourceParamsWebCrawlerStoreOptionsArgs
{
R2Jurisdiction = "string",
StorageId = "string",
StorageType = "string",
},
DiscoverOptions = new Cloudflare.Inputs.AiSearchInstanceSourceParamsWebCrawlerDiscoverOptionsArgs
{
Depth = 0.0,
IncludeExternalLinks = false,
IncludeSubdomains = false,
Limit = 0.0,
MaxAge = 0.0,
Source = "string",
},
ParseOptions = new Cloudflare.Inputs.AiSearchInstanceSourceParamsWebCrawlerParseOptionsArgs
{
ContentSelectors = new[]
{
new Cloudflare.Inputs.AiSearchInstanceSourceParamsWebCrawlerParseOptionsContentSelectorArgs
{
Path = "string",
Selector = "string",
},
},
IncludeHeaders =
{
{ "string", "string" },
},
IncludeImages = false,
SpecificSitemaps = new[]
{
"string",
},
UseBrowserRendering = false,
},
ParseType = "string",
},
},
Summarization = false,
SummarizationModel = "string",
SyncInterval = 0.0,
SystemPromptAisearch = "string",
SystemPromptIndexSummarization = "string",
SystemPromptRewriteQuery = "string",
TokenId = "string",
Type = "string",
});
example, err := cloudflare.NewAiSearchInstance(ctx, "aiSearchInstanceResource", &cloudflare.AiSearchInstanceArgs{
AiSearchInstanceId: pulumi.String("string"),
AccountId: pulumi.String("string"),
Paused: pulumi.Bool(false),
PublicEndpointParams: &cloudflare.AiSearchInstancePublicEndpointParamsArgs{
AuthorizedHosts: pulumi.StringArray{
pulumi.String("string"),
},
ChatCompletionsEndpoint: &cloudflare.AiSearchInstancePublicEndpointParamsChatCompletionsEndpointArgs{
Disabled: pulumi.Bool(false),
},
CustomDomains: pulumi.StringArray{
pulumi.String("string"),
},
DefaultDomainEnabled: pulumi.Bool(false),
Enabled: pulumi.Bool(false),
Mcp: &cloudflare.AiSearchInstancePublicEndpointParamsMcpArgs{
Description: pulumi.String("string"),
Disabled: pulumi.Bool(false),
},
RateLimit: &cloudflare.AiSearchInstancePublicEndpointParamsRateLimitArgs{
PeriodMs: pulumi.Int(0),
Requests: pulumi.Int(0),
Technique: pulumi.String("string"),
},
SearchEndpoint: &cloudflare.AiSearchInstancePublicEndpointParamsSearchEndpointArgs{
Disabled: pulumi.Bool(false),
},
},
Cache: pulumi.Bool(false),
CacheThreshold: pulumi.String("string"),
CacheTtl: pulumi.Float64(0),
Chunk: pulumi.Bool(false),
ChunkOverlap: pulumi.Int(0),
ChunkSize: pulumi.Int(0),
CustomMetadatas: cloudflare.AiSearchInstanceCustomMetadataArray{
&cloudflare.AiSearchInstanceCustomMetadataArgs{
DataType: pulumi.String("string"),
FieldName: pulumi.String("string"),
},
},
EmbeddingModel: pulumi.String("string"),
Reranking: pulumi.Bool(false),
IndexMethod: &cloudflare.AiSearchInstanceIndexMethodArgs{
Keyword: pulumi.Bool(false),
Vector: pulumi.Bool(false),
},
IndexingOptions: &cloudflare.AiSearchInstanceIndexingOptionsArgs{
KeywordTokenizer: pulumi.String("string"),
UseOcr: pulumi.Bool(false),
},
MaxNumResults: pulumi.Int(0),
Metadata: &cloudflare.AiSearchInstanceMetadataArgs{
CreatedFromAisearchWizard: pulumi.Bool(false),
CreatedFromEmdashPlugin: &cloudflare.AiSearchInstanceMetadataCreatedFromEmdashPluginArgs{
Type: pulumi.String("string"),
Version: pulumi.String("string"),
},
WorkerDomain: pulumi.String("string"),
},
AisearchModel: pulumi.String("string"),
AiGatewayId: pulumi.String("string"),
FusionMethod: pulumi.String("string"),
RerankingModel: pulumi.String("string"),
RetrievalOptions: &cloudflare.AiSearchInstanceRetrievalOptionsArgs{
BoostBies: cloudflare.AiSearchInstanceRetrievalOptionsBoostByArray{
&cloudflare.AiSearchInstanceRetrievalOptionsBoostByArgs{
Field: pulumi.String("string"),
Direction: pulumi.String("string"),
},
},
KeywordMatchMode: pulumi.String("string"),
},
RewriteModel: pulumi.String("string"),
RewriteQuery: pulumi.Bool(false),
ScoreThreshold: pulumi.Float64(0),
Source: pulumi.String("string"),
SourceParams: &cloudflare.AiSearchInstanceSourceParamsArgs{
ExcludeItems: pulumi.StringArray{
pulumi.String("string"),
},
IncludeItems: pulumi.StringArray{
pulumi.String("string"),
},
Prefix: pulumi.String("string"),
R2Jurisdiction: pulumi.String("string"),
WebCrawler: &cloudflare.AiSearchInstanceSourceParamsWebCrawlerArgs{
StoreOptions: &cloudflare.AiSearchInstanceSourceParamsWebCrawlerStoreOptionsArgs{
R2Jurisdiction: pulumi.String("string"),
StorageId: pulumi.String("string"),
StorageType: pulumi.String("string"),
},
DiscoverOptions: &cloudflare.AiSearchInstanceSourceParamsWebCrawlerDiscoverOptionsArgs{
Depth: pulumi.Float64(0),
IncludeExternalLinks: pulumi.Bool(false),
IncludeSubdomains: pulumi.Bool(false),
Limit: pulumi.Float64(0),
MaxAge: pulumi.Float64(0),
Source: pulumi.String("string"),
},
ParseOptions: &cloudflare.AiSearchInstanceSourceParamsWebCrawlerParseOptionsArgs{
ContentSelectors: cloudflare.AiSearchInstanceSourceParamsWebCrawlerParseOptionsContentSelectorArray{
&cloudflare.AiSearchInstanceSourceParamsWebCrawlerParseOptionsContentSelectorArgs{
Path: pulumi.String("string"),
Selector: pulumi.String("string"),
},
},
IncludeHeaders: pulumi.StringMap{
"string": pulumi.String("string"),
},
IncludeImages: pulumi.Bool(false),
SpecificSitemaps: pulumi.StringArray{
pulumi.String("string"),
},
UseBrowserRendering: pulumi.Bool(false),
},
ParseType: pulumi.String("string"),
},
},
Summarization: pulumi.Bool(false),
SummarizationModel: pulumi.String("string"),
SyncInterval: pulumi.Float64(0),
SystemPromptAisearch: pulumi.String("string"),
SystemPromptIndexSummarization: pulumi.String("string"),
SystemPromptRewriteQuery: pulumi.String("string"),
TokenId: pulumi.String("string"),
Type: pulumi.String("string"),
})
resource "cloudflare_ai_search_instance" "aiSearchInstanceResource" {
lifecycle {
create_before_destroy = true
}
ai_search_instance_id = "string"
account_id = "string"
paused = false
public_endpoint_params = {
authorized_hosts = ["string"]
chat_completions_endpoint = {
disabled = false
}
custom_domains = ["string"]
default_domain_enabled = false
enabled = false
mcp = {
description = "string"
disabled = false
}
rate_limit = {
period_ms = 0
requests = 0
technique = "string"
}
search_endpoint = {
disabled = false
}
}
cache = false
cache_threshold = "string"
cache_ttl = 0
chunk = false
chunk_overlap = 0
chunk_size = 0
custom_metadatas {
data_type = "string"
field_name = "string"
}
embedding_model = "string"
reranking = false
index_method = {
keyword = false
vector = false
}
indexing_options = {
keyword_tokenizer = "string"
use_ocr = false
}
max_num_results = 0
metadata = {
created_from_aisearch_wizard = false
created_from_emdash_plugin = {
type = "string"
version = "string"
}
worker_domain = "string"
}
aisearch_model = "string"
ai_gateway_id = "string"
fusion_method = "string"
reranking_model = "string"
retrieval_options = {
boost_bies = [{
field = "string"
direction = "string"
}]
keyword_match_mode = "string"
}
rewrite_model = "string"
rewrite_query = false
score_threshold = 0
source = "string"
source_params = {
exclude_items = ["string"]
include_items = ["string"]
prefix = "string"
r2_jurisdiction = "string"
web_crawler = {
store_options = {
r2_jurisdiction = "string"
storage_id = "string"
storage_type = "string"
}
discover_options = {
depth = 0
include_external_links = false
include_subdomains = false
limit = 0
max_age = 0
source = "string"
}
parse_options = {
content_selectors = [{
path = "string"
selector = "string"
}]
include_headers = {
"string" = "string"
}
include_images = false
specific_sitemaps = ["string"]
use_browser_rendering = false
}
parse_type = "string"
}
}
summarization = false
summarization_model = "string"
sync_interval = 0
system_prompt_aisearch = "string"
system_prompt_index_summarization = "string"
system_prompt_rewrite_query = "string"
token_id = "string"
type = "string"
}
var aiSearchInstanceResource = new AiSearchInstance("aiSearchInstanceResource", AiSearchInstanceArgs.builder()
.aiSearchInstanceId("string")
.accountId("string")
.paused(false)
.publicEndpointParams(AiSearchInstancePublicEndpointParamsArgs.builder()
.authorizedHosts("string")
.chatCompletionsEndpoint(AiSearchInstancePublicEndpointParamsChatCompletionsEndpointArgs.builder()
.disabled(false)
.build())
.customDomains("string")
.defaultDomainEnabled(false)
.enabled(false)
.mcp(AiSearchInstancePublicEndpointParamsMcpArgs.builder()
.description("string")
.disabled(false)
.build())
.rateLimit(AiSearchInstancePublicEndpointParamsRateLimitArgs.builder()
.periodMs(0)
.requests(0)
.technique("string")
.build())
.searchEndpoint(AiSearchInstancePublicEndpointParamsSearchEndpointArgs.builder()
.disabled(false)
.build())
.build())
.cache(false)
.cacheThreshold("string")
.cacheTtl(0.0)
.chunk(false)
.chunkOverlap(0)
.chunkSize(0)
.customMetadatas(AiSearchInstanceCustomMetadataArgs.builder()
.dataType("string")
.fieldName("string")
.build())
.embeddingModel("string")
.reranking(false)
.indexMethod(AiSearchInstanceIndexMethodArgs.builder()
.keyword(false)
.vector(false)
.build())
.indexingOptions(AiSearchInstanceIndexingOptionsArgs.builder()
.keywordTokenizer("string")
.useOcr(false)
.build())
.maxNumResults(0)
.metadata(AiSearchInstanceMetadataArgs.builder()
.createdFromAisearchWizard(false)
.createdFromEmdashPlugin(AiSearchInstanceMetadataCreatedFromEmdashPluginArgs.builder()
.type("string")
.version("string")
.build())
.workerDomain("string")
.build())
.aisearchModel("string")
.aiGatewayId("string")
.fusionMethod("string")
.rerankingModel("string")
.retrievalOptions(AiSearchInstanceRetrievalOptionsArgs.builder()
.boostBies(AiSearchInstanceRetrievalOptionsBoostByArgs.builder()
.field("string")
.direction("string")
.build())
.keywordMatchMode("string")
.build())
.rewriteModel("string")
.rewriteQuery(false)
.scoreThreshold(0.0)
.source("string")
.sourceParams(AiSearchInstanceSourceParamsArgs.builder()
.excludeItems("string")
.includeItems("string")
.prefix("string")
.r2Jurisdiction("string")
.webCrawler(AiSearchInstanceSourceParamsWebCrawlerArgs.builder()
.storeOptions(AiSearchInstanceSourceParamsWebCrawlerStoreOptionsArgs.builder()
.r2Jurisdiction("string")
.storageId("string")
.storageType("string")
.build())
.discoverOptions(AiSearchInstanceSourceParamsWebCrawlerDiscoverOptionsArgs.builder()
.depth(0.0)
.includeExternalLinks(false)
.includeSubdomains(false)
.limit(0.0)
.maxAge(0.0)
.source("string")
.build())
.parseOptions(AiSearchInstanceSourceParamsWebCrawlerParseOptionsArgs.builder()
.contentSelectors(AiSearchInstanceSourceParamsWebCrawlerParseOptionsContentSelectorArgs.builder()
.path("string")
.selector("string")
.build())
.includeHeaders(Map.of("string", "string"))
.includeImages(false)
.specificSitemaps("string")
.useBrowserRendering(false)
.build())
.parseType("string")
.build())
.build())
.summarization(false)
.summarizationModel("string")
.syncInterval(0.0)
.systemPromptAisearch("string")
.systemPromptIndexSummarization("string")
.systemPromptRewriteQuery("string")
.tokenId("string")
.type("string")
.build());
ai_search_instance_resource = cloudflare.AiSearchInstance("aiSearchInstanceResource",
ai_search_instance_id="string",
account_id="string",
paused=False,
public_endpoint_params={
"authorized_hosts": ["string"],
"chat_completions_endpoint": {
"disabled": False,
},
"custom_domains": ["string"],
"default_domain_enabled": False,
"enabled": False,
"mcp": {
"description": "string",
"disabled": False,
},
"rate_limit": {
"period_ms": 0,
"requests": 0,
"technique": "string",
},
"search_endpoint": {
"disabled": False,
},
},
cache=False,
cache_threshold="string",
cache_ttl=float(0),
chunk=False,
chunk_overlap=0,
chunk_size=0,
custom_metadatas=[{
"data_type": "string",
"field_name": "string",
}],
embedding_model="string",
reranking=False,
index_method={
"keyword": False,
"vector": False,
},
indexing_options={
"keyword_tokenizer": "string",
"use_ocr": False,
},
max_num_results=0,
metadata={
"created_from_aisearch_wizard": False,
"created_from_emdash_plugin": {
"type": "string",
"version": "string",
},
"worker_domain": "string",
},
aisearch_model="string",
ai_gateway_id="string",
fusion_method="string",
reranking_model="string",
retrieval_options={
"boost_bies": [{
"field": "string",
"direction": "string",
}],
"keyword_match_mode": "string",
},
rewrite_model="string",
rewrite_query=False,
score_threshold=float(0),
source="string",
source_params={
"exclude_items": ["string"],
"include_items": ["string"],
"prefix": "string",
"r2_jurisdiction": "string",
"web_crawler": {
"store_options": {
"r2_jurisdiction": "string",
"storage_id": "string",
"storage_type": "string",
},
"discover_options": {
"depth": float(0),
"include_external_links": False,
"include_subdomains": False,
"limit": float(0),
"max_age": float(0),
"source": "string",
},
"parse_options": {
"content_selectors": [{
"path": "string",
"selector": "string",
}],
"include_headers": {
"string": "string",
},
"include_images": False,
"specific_sitemaps": ["string"],
"use_browser_rendering": False,
},
"parse_type": "string",
},
},
summarization=False,
summarization_model="string",
sync_interval=float(0),
system_prompt_aisearch="string",
system_prompt_index_summarization="string",
system_prompt_rewrite_query="string",
token_id="string",
type="string")
const aiSearchInstanceResource = new cloudflare.AiSearchInstance("aiSearchInstanceResource", {
aiSearchInstanceId: "string",
accountId: "string",
paused: false,
publicEndpointParams: {
authorizedHosts: ["string"],
chatCompletionsEndpoint: {
disabled: false,
},
customDomains: ["string"],
defaultDomainEnabled: false,
enabled: false,
mcp: {
description: "string",
disabled: false,
},
rateLimit: {
periodMs: 0,
requests: 0,
technique: "string",
},
searchEndpoint: {
disabled: false,
},
},
cache: false,
cacheThreshold: "string",
cacheTtl: 0,
chunk: false,
chunkOverlap: 0,
chunkSize: 0,
customMetadatas: [{
dataType: "string",
fieldName: "string",
}],
embeddingModel: "string",
reranking: false,
indexMethod: {
keyword: false,
vector: false,
},
indexingOptions: {
keywordTokenizer: "string",
useOcr: false,
},
maxNumResults: 0,
metadata: {
createdFromAisearchWizard: false,
createdFromEmdashPlugin: {
type: "string",
version: "string",
},
workerDomain: "string",
},
aisearchModel: "string",
aiGatewayId: "string",
fusionMethod: "string",
rerankingModel: "string",
retrievalOptions: {
boostBies: [{
field: "string",
direction: "string",
}],
keywordMatchMode: "string",
},
rewriteModel: "string",
rewriteQuery: false,
scoreThreshold: 0,
source: "string",
sourceParams: {
excludeItems: ["string"],
includeItems: ["string"],
prefix: "string",
r2Jurisdiction: "string",
webCrawler: {
storeOptions: {
r2Jurisdiction: "string",
storageId: "string",
storageType: "string",
},
discoverOptions: {
depth: 0,
includeExternalLinks: false,
includeSubdomains: false,
limit: 0,
maxAge: 0,
source: "string",
},
parseOptions: {
contentSelectors: [{
path: "string",
selector: "string",
}],
includeHeaders: {
string: "string",
},
includeImages: false,
specificSitemaps: ["string"],
useBrowserRendering: false,
},
parseType: "string",
},
},
summarization: false,
summarizationModel: "string",
syncInterval: 0,
systemPromptAisearch: "string",
systemPromptIndexSummarization: "string",
systemPromptRewriteQuery: "string",
tokenId: "string",
type: "string",
});
type: cloudflare:AiSearchInstance
properties:
accountId: string
aiGatewayId: string
aiSearchInstanceId: string
aisearchModel: string
cache: false
cacheThreshold: string
cacheTtl: 0
chunk: false
chunkOverlap: 0
chunkSize: 0
customMetadatas:
- dataType: string
fieldName: string
embeddingModel: string
fusionMethod: string
indexMethod:
keyword: false
vector: false
indexingOptions:
keywordTokenizer: string
useOcr: false
maxNumResults: 0
metadata:
createdFromAisearchWizard: false
createdFromEmdashPlugin:
type: string
version: string
workerDomain: string
paused: false
publicEndpointParams:
authorizedHosts:
- string
chatCompletionsEndpoint:
disabled: false
customDomains:
- string
defaultDomainEnabled: false
enabled: false
mcp:
description: string
disabled: false
rateLimit:
periodMs: 0
requests: 0
technique: string
searchEndpoint:
disabled: false
reranking: false
rerankingModel: string
retrievalOptions:
boostBies:
- direction: string
field: string
keywordMatchMode: string
rewriteModel: string
rewriteQuery: false
scoreThreshold: 0
source: string
sourceParams:
excludeItems:
- string
includeItems:
- string
prefix: string
r2Jurisdiction: string
webCrawler:
discoverOptions:
depth: 0
includeExternalLinks: false
includeSubdomains: false
limit: 0
maxAge: 0
source: string
parseOptions:
contentSelectors:
- path: string
selector: string
includeHeaders:
string: string
includeImages: false
specificSitemaps:
- string
useBrowserRendering: false
parseType: string
storeOptions:
r2Jurisdiction: string
storageId: string
storageType: string
summarization: false
summarizationModel: string
syncInterval: 0
systemPromptAisearch: string
systemPromptIndexSummarization: string
systemPromptRewriteQuery: string
tokenId: string
type: string
AiSearchInstance Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The AiSearchInstance resource accepts the following input properties:
- Account
Id string - Ai
Search stringInstance Id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- Ai
Gateway stringId - Aisearch
Model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- Cache bool
- Cache
Threshold string - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- Cache
Ttl double - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- Chunk bool
- Chunk
Overlap int - Chunk
Size int - Custom
Metadatas List<AiSearch Instance Custom Metadata> - Embedding
Model string - Fusion
Method string - Available values: "max", "rrf".
- Hybrid
Search boolEnabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- Index
Method AiSearch Instance Index Method - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- Indexing
Options AiSearch Instance Indexing Options - Max
Num intResults - Metadata
Ai
Search Instance Metadata - Paused bool
- Public
Endpoint AiParams Search Instance Public Endpoint Params - Reranking bool
- Reranking
Model string - Retrieval
Options AiSearch Instance Retrieval Options - Rewrite
Model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- Rewrite
Query bool - Score
Threshold double - Source string
- Source
Params AiSearch Instance Source Params - Summarization bool
- Summarization
Model string - Sync
Interval double - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- System
Prompt stringAisearch - System
Prompt stringIndex Summarization - System
Prompt stringRewrite Query - Token
Id string - Type string
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
- Account
Id string - Ai
Search stringInstance Id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- Ai
Gateway stringId - Aisearch
Model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- Cache bool
- Cache
Threshold string - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- Cache
Ttl float64 - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- Chunk bool
- Chunk
Overlap int - Chunk
Size int - Custom
Metadatas []AiSearch Instance Custom Metadata Args - Embedding
Model string - Fusion
Method string - Available values: "max", "rrf".
- Hybrid
Search boolEnabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- Index
Method AiSearch Instance Index Method Args - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- Indexing
Options AiSearch Instance Indexing Options Args - Max
Num intResults - Metadata
Ai
Search Instance Metadata Args - Paused bool
- Public
Endpoint AiParams Search Instance Public Endpoint Params Args - Reranking bool
- Reranking
Model string - Retrieval
Options AiSearch Instance Retrieval Options Args - Rewrite
Model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- Rewrite
Query bool - Score
Threshold float64 - Source string
- Source
Params AiSearch Instance Source Params Args - Summarization bool
- Summarization
Model string - Sync
Interval float64 - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- System
Prompt stringAisearch - System
Prompt stringIndex Summarization - System
Prompt stringRewrite Query - Token
Id string - Type string
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
- account_
id string - ai_
search_ stringinstance_ id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- ai_
gateway_ stringid - aisearch_
model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- cache bool
- cache_
threshold string - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- cache_
ttl number - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- chunk bool
- chunk_
overlap number - chunk_
size number - custom_
metadatas list(object) - embedding_
model string - fusion_
method string - Available values: "max", "rrf".
- hybrid_
search_ boolenabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- index_
method object - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- indexing_
options object - max_
num_ numberresults - metadata object
- paused bool
- public_
endpoint_ objectparams - reranking bool
- reranking_
model string - retrieval_
options object - rewrite_
model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- rewrite_
query bool - score_
threshold number - source string
- source_
params object - summarization bool
- summarization_
model string - sync_
interval number - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- system_
prompt_ stringaisearch - system_
prompt_ stringindex_ summarization - system_
prompt_ stringrewrite_ query - token_
id string - type string
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
- account
Id String - ai
Search StringInstance Id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- ai
Gateway StringId - aisearch
Model String - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- cache Boolean
- cache
Threshold String - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- cache
Ttl Double - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- chunk Boolean
- chunk
Overlap Integer - chunk
Size Integer - custom
Metadatas List<AiSearch Instance Custom Metadata> - embedding
Model String - fusion
Method String - Available values: "max", "rrf".
- hybrid
Search BooleanEnabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- index
Method AiSearch Instance Index Method - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- indexing
Options AiSearch Instance Indexing Options - max
Num IntegerResults - metadata
Ai
Search Instance Metadata - paused Boolean
- public
Endpoint AiParams Search Instance Public Endpoint Params - reranking Boolean
- reranking
Model String - retrieval
Options AiSearch Instance Retrieval Options - rewrite
Model String - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- rewrite
Query Boolean - score
Threshold Double - source String
- source
Params AiSearch Instance Source Params - summarization Boolean
- summarization
Model String - sync
Interval Double - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- system
Prompt StringAisearch - system
Prompt StringIndex Summarization - system
Prompt StringRewrite Query - token
Id String - type String
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
- account
Id string - ai
Search stringInstance Id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- ai
Gateway stringId - aisearch
Model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- cache boolean
- cache
Threshold string - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- cache
Ttl number - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- chunk boolean
- chunk
Overlap number - chunk
Size number - custom
Metadatas AiSearch Instance Custom Metadata[] - embedding
Model string - fusion
Method string - Available values: "max", "rrf".
- hybrid
Search booleanEnabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- index
Method AiSearch Instance Index Method - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- indexing
Options AiSearch Instance Indexing Options - max
Num numberResults - metadata
Ai
Search Instance Metadata - paused boolean
- public
Endpoint AiParams Search Instance Public Endpoint Params - reranking boolean
- reranking
Model string - retrieval
Options AiSearch Instance Retrieval Options - rewrite
Model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- rewrite
Query boolean - score
Threshold number - source string
- source
Params AiSearch Instance Source Params - summarization boolean
- summarization
Model string - sync
Interval number - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- system
Prompt stringAisearch - system
Prompt stringIndex Summarization - system
Prompt stringRewrite Query - token
Id string - type string
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
- account_
id str - ai_
search_ strinstance_ id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- ai_
gateway_ strid - aisearch_
model str - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- cache bool
- cache_
threshold str - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- cache_
ttl float - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- chunk bool
- chunk_
overlap int - chunk_
size int - custom_
metadatas Sequence[AiSearch Instance Custom Metadata Args] - embedding_
model str - fusion_
method str - Available values: "max", "rrf".
- hybrid_
search_ boolenabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- index_
method AiSearch Instance Index Method Args - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- indexing_
options AiSearch Instance Indexing Options Args - max_
num_ intresults - metadata
Ai
Search Instance Metadata Args - paused bool
- public_
endpoint_ Aiparams Search Instance Public Endpoint Params Args - reranking bool
- reranking_
model str - retrieval_
options AiSearch Instance Retrieval Options Args - rewrite_
model str - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- rewrite_
query bool - score_
threshold float - source str
- source_
params AiSearch Instance Source Params Args - summarization bool
- summarization_
model str - sync_
interval float - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- system_
prompt_ straisearch - system_
prompt_ strindex_ summarization - system_
prompt_ strrewrite_ query - token_
id str - type str
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
- account
Id String - ai
Search StringInstance Id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- ai
Gateway StringId - aisearch
Model String - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- cache Boolean
- cache
Threshold String - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- cache
Ttl Number - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- chunk Boolean
- chunk
Overlap Number - chunk
Size Number - custom
Metadatas List<Property Map> - embedding
Model String - fusion
Method String - Available values: "max", "rrf".
- hybrid
Search BooleanEnabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- index
Method Property Map - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- indexing
Options Property Map - max
Num NumberResults - metadata Property Map
- paused Boolean
- public
Endpoint Property MapParams - reranking Boolean
- reranking
Model String - retrieval
Options Property Map - rewrite
Model String - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- rewrite
Query Boolean - score
Threshold Number - source String
- source
Params Property Map - summarization Boolean
- summarization
Model String - sync
Interval Number - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- system
Prompt StringAisearch - system
Prompt StringIndex Summarization - system
Prompt StringRewrite Query - token
Id String - type String
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
Outputs
All input properties are implicitly available as output properties. Additionally, the AiSearchInstance resource produces the following output properties:
- Created
At string - Created
By string - Enable bool
- Engine
Version double - Id string
- The provider-assigned unique ID for this managed resource.
- Last
Activity string - Modified
At string - Modified
By string - Namespace string
- Public
Endpoint stringId - Status string
- Created
At string - Created
By string - Enable bool
- Engine
Version float64 - Id string
- The provider-assigned unique ID for this managed resource.
- Last
Activity string - Modified
At string - Modified
By string - Namespace string
- Public
Endpoint stringId - Status string
- created_
at string - created_
by string - enable bool
- engine_
version number - id string
- The provider-assigned unique ID for this managed resource.
- last_
activity string - modified_
at string - modified_
by string - namespace string
- public_
endpoint_ stringid - status string
- created
At String - created
By String - enable Boolean
- engine
Version Double - id String
- The provider-assigned unique ID for this managed resource.
- last
Activity String - modified
At String - modified
By String - namespace String
- public
Endpoint StringId - status String
- created
At string - created
By string - enable boolean
- engine
Version number - id string
- The provider-assigned unique ID for this managed resource.
- last
Activity string - modified
At string - modified
By string - namespace string
- public
Endpoint stringId - status string
- created_
at str - created_
by str - enable bool
- engine_
version float - id str
- The provider-assigned unique ID for this managed resource.
- last_
activity str - modified_
at str - modified_
by str - namespace str
- public_
endpoint_ strid - status str
- created
At String - created
By String - enable Boolean
- engine
Version Number - id String
- The provider-assigned unique ID for this managed resource.
- last
Activity String - modified
At String - modified
By String - namespace String
- public
Endpoint StringId - status String
Look up Existing AiSearchInstance Resource
Get an existing AiSearchInstance resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: AiSearchInstanceState, opts?: CustomResourceOptions): AiSearchInstance@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
account_id: Optional[str] = None,
ai_gateway_id: Optional[str] = None,
ai_search_instance_id: Optional[str] = None,
aisearch_model: Optional[str] = None,
cache: Optional[bool] = None,
cache_threshold: Optional[str] = None,
cache_ttl: Optional[float] = None,
chunk: Optional[bool] = None,
chunk_overlap: Optional[int] = None,
chunk_size: Optional[int] = None,
created_at: Optional[str] = None,
created_by: Optional[str] = None,
custom_metadatas: Optional[Sequence[AiSearchInstanceCustomMetadataArgs]] = None,
embedding_model: Optional[str] = None,
enable: Optional[bool] = None,
engine_version: Optional[float] = None,
fusion_method: Optional[str] = None,
hybrid_search_enabled: Optional[bool] = None,
index_method: Optional[AiSearchInstanceIndexMethodArgs] = None,
indexing_options: Optional[AiSearchInstanceIndexingOptionsArgs] = None,
last_activity: Optional[str] = None,
max_num_results: Optional[int] = None,
metadata: Optional[AiSearchInstanceMetadataArgs] = None,
modified_at: Optional[str] = None,
modified_by: Optional[str] = None,
namespace: Optional[str] = None,
paused: Optional[bool] = None,
public_endpoint_id: Optional[str] = None,
public_endpoint_params: Optional[AiSearchInstancePublicEndpointParamsArgs] = None,
reranking: Optional[bool] = None,
reranking_model: Optional[str] = None,
retrieval_options: Optional[AiSearchInstanceRetrievalOptionsArgs] = None,
rewrite_model: Optional[str] = None,
rewrite_query: Optional[bool] = None,
score_threshold: Optional[float] = None,
source: Optional[str] = None,
source_params: Optional[AiSearchInstanceSourceParamsArgs] = None,
status: Optional[str] = None,
summarization: Optional[bool] = None,
summarization_model: Optional[str] = None,
sync_interval: Optional[float] = None,
system_prompt_aisearch: Optional[str] = None,
system_prompt_index_summarization: Optional[str] = None,
system_prompt_rewrite_query: Optional[str] = None,
token_id: Optional[str] = None,
type: Optional[str] = None) -> AiSearchInstancefunc GetAiSearchInstance(ctx *Context, name string, id IDInput, state *AiSearchInstanceState, opts ...ResourceOption) (*AiSearchInstance, error)public static AiSearchInstance Get(string name, Input<string> id, AiSearchInstanceState? state, CustomResourceOptions? opts = null)public static AiSearchInstance get(String name, Output<String> id, AiSearchInstanceState state, CustomResourceOptions options)resources: _: type: cloudflare:AiSearchInstance get: id: ${id}import {
to = cloudflare_ai_search_instance.example
id = "${id}"
}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Account
Id string - Ai
Gateway stringId - Ai
Search stringInstance Id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- Aisearch
Model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- Cache bool
- Cache
Threshold string - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- Cache
Ttl double - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- Chunk bool
- Chunk
Overlap int - Chunk
Size int - Created
At string - Created
By string - Custom
Metadatas List<AiSearch Instance Custom Metadata> - Embedding
Model string - Enable bool
- Engine
Version double - Fusion
Method string - Available values: "max", "rrf".
- Hybrid
Search boolEnabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- Index
Method AiSearch Instance Index Method - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- Indexing
Options AiSearch Instance Indexing Options - Last
Activity string - Max
Num intResults - Metadata
Ai
Search Instance Metadata - Modified
At string - Modified
By string - Namespace string
- Paused bool
- Public
Endpoint stringId - Public
Endpoint AiParams Search Instance Public Endpoint Params - Reranking bool
- Reranking
Model string - Retrieval
Options AiSearch Instance Retrieval Options - Rewrite
Model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- Rewrite
Query bool - Score
Threshold double - Source string
- Source
Params AiSearch Instance Source Params - Status string
- Summarization bool
- Summarization
Model string - Sync
Interval double - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- System
Prompt stringAisearch - System
Prompt stringIndex Summarization - System
Prompt stringRewrite Query - Token
Id string - Type string
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
- Account
Id string - Ai
Gateway stringId - Ai
Search stringInstance Id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- Aisearch
Model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- Cache bool
- Cache
Threshold string - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- Cache
Ttl float64 - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- Chunk bool
- Chunk
Overlap int - Chunk
Size int - Created
At string - Created
By string - Custom
Metadatas []AiSearch Instance Custom Metadata Args - Embedding
Model string - Enable bool
- Engine
Version float64 - Fusion
Method string - Available values: "max", "rrf".
- Hybrid
Search boolEnabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- Index
Method AiSearch Instance Index Method Args - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- Indexing
Options AiSearch Instance Indexing Options Args - Last
Activity string - Max
Num intResults - Metadata
Ai
Search Instance Metadata Args - Modified
At string - Modified
By string - Namespace string
- Paused bool
- Public
Endpoint stringId - Public
Endpoint AiParams Search Instance Public Endpoint Params Args - Reranking bool
- Reranking
Model string - Retrieval
Options AiSearch Instance Retrieval Options Args - Rewrite
Model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- Rewrite
Query bool - Score
Threshold float64 - Source string
- Source
Params AiSearch Instance Source Params Args - Status string
- Summarization bool
- Summarization
Model string - Sync
Interval float64 - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- System
Prompt stringAisearch - System
Prompt stringIndex Summarization - System
Prompt stringRewrite Query - Token
Id string - Type string
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
- account_
id string - ai_
gateway_ stringid - ai_
search_ stringinstance_ id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- aisearch_
model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- cache bool
- cache_
threshold string - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- cache_
ttl number - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- chunk bool
- chunk_
overlap number - chunk_
size number - created_
at string - created_
by string - custom_
metadatas list(object) - embedding_
model string - enable bool
- engine_
version number - fusion_
method string - Available values: "max", "rrf".
- hybrid_
search_ boolenabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- index_
method object - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- indexing_
options object - last_
activity string - max_
num_ numberresults - metadata object
- modified_
at string - modified_
by string - namespace string
- paused bool
- public_
endpoint_ stringid - public_
endpoint_ objectparams - reranking bool
- reranking_
model string - retrieval_
options object - rewrite_
model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- rewrite_
query bool - score_
threshold number - source string
- source_
params object - status string
- summarization bool
- summarization_
model string - sync_
interval number - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- system_
prompt_ stringaisearch - system_
prompt_ stringindex_ summarization - system_
prompt_ stringrewrite_ query - token_
id string - type string
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
- account
Id String - ai
Gateway StringId - ai
Search StringInstance Id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- aisearch
Model String - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- cache Boolean
- cache
Threshold String - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- cache
Ttl Double - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- chunk Boolean
- chunk
Overlap Integer - chunk
Size Integer - created
At String - created
By String - custom
Metadatas List<AiSearch Instance Custom Metadata> - embedding
Model String - enable Boolean
- engine
Version Double - fusion
Method String - Available values: "max", "rrf".
- hybrid
Search BooleanEnabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- index
Method AiSearch Instance Index Method - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- indexing
Options AiSearch Instance Indexing Options - last
Activity String - max
Num IntegerResults - metadata
Ai
Search Instance Metadata - modified
At String - modified
By String - namespace String
- paused Boolean
- public
Endpoint StringId - public
Endpoint AiParams Search Instance Public Endpoint Params - reranking Boolean
- reranking
Model String - retrieval
Options AiSearch Instance Retrieval Options - rewrite
Model String - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- rewrite
Query Boolean - score
Threshold Double - source String
- source
Params AiSearch Instance Source Params - status String
- summarization Boolean
- summarization
Model String - sync
Interval Double - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- system
Prompt StringAisearch - system
Prompt StringIndex Summarization - system
Prompt StringRewrite Query - token
Id String - type String
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
- account
Id string - ai
Gateway stringId - ai
Search stringInstance Id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- aisearch
Model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- cache boolean
- cache
Threshold string - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- cache
Ttl number - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- chunk boolean
- chunk
Overlap number - chunk
Size number - created
At string - created
By string - custom
Metadatas AiSearch Instance Custom Metadata[] - embedding
Model string - enable boolean
- engine
Version number - fusion
Method string - Available values: "max", "rrf".
- hybrid
Search booleanEnabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- index
Method AiSearch Instance Index Method - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- indexing
Options AiSearch Instance Indexing Options - last
Activity string - max
Num numberResults - metadata
Ai
Search Instance Metadata - modified
At string - modified
By string - namespace string
- paused boolean
- public
Endpoint stringId - public
Endpoint AiParams Search Instance Public Endpoint Params - reranking boolean
- reranking
Model string - retrieval
Options AiSearch Instance Retrieval Options - rewrite
Model string - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- rewrite
Query boolean - score
Threshold number - source string
- source
Params AiSearch Instance Source Params - status string
- summarization boolean
- summarization
Model string - sync
Interval number - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- system
Prompt stringAisearch - system
Prompt stringIndex Summarization - system
Prompt stringRewrite Query - token
Id string - type string
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
- account_
id str - ai_
gateway_ strid - ai_
search_ strinstance_ id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- aisearch_
model str - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- cache bool
- cache_
threshold str - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- cache_
ttl float - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- chunk bool
- chunk_
overlap int - chunk_
size int - created_
at str - created_
by str - custom_
metadatas Sequence[AiSearch Instance Custom Metadata Args] - embedding_
model str - enable bool
- engine_
version float - fusion_
method str - Available values: "max", "rrf".
- hybrid_
search_ boolenabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- index_
method AiSearch Instance Index Method Args - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- indexing_
options AiSearch Instance Indexing Options Args - last_
activity str - max_
num_ intresults - metadata
Ai
Search Instance Metadata Args - modified_
at str - modified_
by str - namespace str
- paused bool
- public_
endpoint_ strid - public_
endpoint_ Aiparams Search Instance Public Endpoint Params Args - reranking bool
- reranking_
model str - retrieval_
options AiSearch Instance Retrieval Options Args - rewrite_
model str - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- rewrite_
query bool - score_
threshold float - source str
- source_
params AiSearch Instance Source Params Args - status str
- summarization bool
- summarization_
model str - sync_
interval float - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- system_
prompt_ straisearch - system_
prompt_ strindex_ summarization - system_
prompt_ strrewrite_ query - token_
id str - type str
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
- account
Id String - ai
Gateway StringId - ai
Search StringInstance Id - AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.
- aisearch
Model String - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- cache Boolean
- cache
Threshold String - Available values: "superstrictmatch", "closeenough", "flexiblefriend", "anythingGoes".
- cache
Ttl Number - Cache entry TTL in seconds. Allowed values: 600 (10min), 1800 (30min), 3600 (1h), 7200 (2h), 21600 (6h), 43200 (12h), 86400 (24h), 172800 (48h), 259200 (72h), 518400 (6d). Available values: 600, 1800, 3600, 7200, 21600, 43200, 86400, 172800, 259200, 518400.
- chunk Boolean
- chunk
Overlap Number - chunk
Size Number - created
At String - created
By String - custom
Metadatas List<Property Map> - embedding
Model String - enable Boolean
- engine
Version Number - fusion
Method String - Available values: "max", "rrf".
- hybrid
Search BooleanEnabled - Deprecated — use indexMethod instead. Defaults to true for new instances; set false to create a vector-only instance.
- index
Method Property Map - Controls which storage backends are used during indexing. Defaults to vector and keyword indexing for new instances.
- indexing
Options Property Map - last
Activity String - max
Num NumberResults - metadata Property Map
- modified
At String - modified
By String - namespace String
- paused Boolean
- public
Endpoint StringId - public
Endpoint Property MapParams - reranking Boolean
- reranking
Model String - retrieval
Options Property Map - rewrite
Model String - A Workers AI model ID or an AI Gateway model ID compatible with the OpenAI Chat Completions API. An empty string uses the configured or default model.
- rewrite
Query Boolean - score
Threshold Number - source String
- source
Params Property Map - status String
- summarization Boolean
- summarization
Model String - sync
Interval Number - Interval between automatic syncs, in seconds. Allowed values: 900 (15min), 1800 (30min), 3600 (1h), 7200 (2h), 14400 (4h), 21600 (6h), 43200 (12h), 86400 (24h). Available values: 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400.
- system
Prompt StringAisearch - system
Prompt StringIndex Summarization - system
Prompt StringRewrite Query - token
Id String - type String
- Source type. When omitted or null with a non-blank source, HTTP(S) URLs infer web-crawler and existing R2 bucket names infer r2. A missing or blank source without a type uses managed upload-only storage. Available values: "r2", "web-crawler".
Supporting Types
AiSearchInstanceCustomMetadata, AiSearchInstanceCustomMetadataArgs
- data_
type string - Available values: "text", "number", "boolean", "datetime".
- field_
name string
- data_
type str - Available values: "text", "number", "boolean", "datetime".
- field_
name str
AiSearchInstanceIndexMethod, AiSearchInstanceIndexMethodArgs
AiSearchInstanceIndexingOptions, AiSearchInstanceIndexingOptionsArgs
- Keyword
Tokenizer string - Tokenizer used for keyword search indexing. porter provides word-level tokenization with Porter stemming (good for natural language queries). trigram enables character-level substring matching (good for partial matches, code, identifiers). Changing this triggers a full re-index. Defaults to porter. Available values: "porter", "trigram".
- Use
Ocr bool - Enables OCR ingestion for PDFs and images. Changing this triggers a full re-index. Defaults to false.
- Keyword
Tokenizer string - Tokenizer used for keyword search indexing. porter provides word-level tokenization with Porter stemming (good for natural language queries). trigram enables character-level substring matching (good for partial matches, code, identifiers). Changing this triggers a full re-index. Defaults to porter. Available values: "porter", "trigram".
- Use
Ocr bool - Enables OCR ingestion for PDFs and images. Changing this triggers a full re-index. Defaults to false.
- keyword_
tokenizer string - Tokenizer used for keyword search indexing. porter provides word-level tokenization with Porter stemming (good for natural language queries). trigram enables character-level substring matching (good for partial matches, code, identifiers). Changing this triggers a full re-index. Defaults to porter. Available values: "porter", "trigram".
- use_
ocr bool - Enables OCR ingestion for PDFs and images. Changing this triggers a full re-index. Defaults to false.
- keyword
Tokenizer String - Tokenizer used for keyword search indexing. porter provides word-level tokenization with Porter stemming (good for natural language queries). trigram enables character-level substring matching (good for partial matches, code, identifiers). Changing this triggers a full re-index. Defaults to porter. Available values: "porter", "trigram".
- use
Ocr Boolean - Enables OCR ingestion for PDFs and images. Changing this triggers a full re-index. Defaults to false.
- keyword
Tokenizer string - Tokenizer used for keyword search indexing. porter provides word-level tokenization with Porter stemming (good for natural language queries). trigram enables character-level substring matching (good for partial matches, code, identifiers). Changing this triggers a full re-index. Defaults to porter. Available values: "porter", "trigram".
- use
Ocr boolean - Enables OCR ingestion for PDFs and images. Changing this triggers a full re-index. Defaults to false.
- keyword_
tokenizer str - Tokenizer used for keyword search indexing. porter provides word-level tokenization with Porter stemming (good for natural language queries). trigram enables character-level substring matching (good for partial matches, code, identifiers). Changing this triggers a full re-index. Defaults to porter. Available values: "porter", "trigram".
- use_
ocr bool - Enables OCR ingestion for PDFs and images. Changing this triggers a full re-index. Defaults to false.
- keyword
Tokenizer String - Tokenizer used for keyword search indexing. porter provides word-level tokenization with Porter stemming (good for natural language queries). trigram enables character-level substring matching (good for partial matches, code, identifiers). Changing this triggers a full re-index. Defaults to porter. Available values: "porter", "trigram".
- use
Ocr Boolean - Enables OCR ingestion for PDFs and images. Changing this triggers a full re-index. Defaults to false.
AiSearchInstanceMetadata, AiSearchInstanceMetadataArgs
AiSearchInstanceMetadataCreatedFromEmdashPlugin, AiSearchInstanceMetadataCreatedFromEmdashPluginArgs
AiSearchInstancePublicEndpointParams, AiSearchInstancePublicEndpointParamsArgs
- List<string>
- Chat
Completions AiEndpoint Search Instance Public Endpoint Params Chat Completions Endpoint - Custom
Domains List<string> - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- Default
Domain boolEnabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- Enabled bool
- Mcp
Ai
Search Instance Public Endpoint Params Mcp - Rate
Limit AiSearch Instance Public Endpoint Params Rate Limit - Search
Endpoint AiSearch Instance Public Endpoint Params Search Endpoint
- []string
- Chat
Completions AiEndpoint Search Instance Public Endpoint Params Chat Completions Endpoint - Custom
Domains []string - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- Default
Domain boolEnabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- Enabled bool
- Mcp
Ai
Search Instance Public Endpoint Params Mcp - Rate
Limit AiSearch Instance Public Endpoint Params Rate Limit - Search
Endpoint AiSearch Instance Public Endpoint Params Search Endpoint
- list(string)
- chat_
completions_ objectendpoint - custom_
domains list(string) - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- default_
domain_ boolenabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- enabled bool
- mcp object
- rate_
limit object - search_
endpoint object
- List<String>
- chat
Completions AiEndpoint Search Instance Public Endpoint Params Chat Completions Endpoint - custom
Domains List<String> - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- default
Domain BooleanEnabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- enabled Boolean
- mcp
Ai
Search Instance Public Endpoint Params Mcp - rate
Limit AiSearch Instance Public Endpoint Params Rate Limit - search
Endpoint AiSearch Instance Public Endpoint Params Search Endpoint
- string[]
- chat
Completions AiEndpoint Search Instance Public Endpoint Params Chat Completions Endpoint - custom
Domains string[] - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- default
Domain booleanEnabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- enabled boolean
- mcp
Ai
Search Instance Public Endpoint Params Mcp - rate
Limit AiSearch Instance Public Endpoint Params Rate Limit - search
Endpoint AiSearch Instance Public Endpoint Params Search Endpoint
- Sequence[str]
- chat_
completions_ Aiendpoint Search Instance Public Endpoint Params Chat Completions Endpoint - custom_
domains Sequence[str] - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- default_
domain_ boolenabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- enabled bool
- mcp
Ai
Search Instance Public Endpoint Params Mcp - rate_
limit AiSearch Instance Public Endpoint Params Rate Limit - search_
endpoint AiSearch Instance Public Endpoint Params Search Endpoint
- List<String>
- chat
Completions Property MapEndpoint - custom
Domains List<String> - Custom domain hostnames that alias this public endpoint. GET and create responses return the current set; on update (PUT) this field is only echoed back when supplied in the request body, otherwise it is null (omit it to leave domains unchanged).
- default
Domain BooleanEnabled - When false, the instance is reachable only via a registered custom domain and the default \n\n.search.ai.cloudflare.com host returns 404. Requires at least one custom domain. Defaults to true. publicendpointparams is replaced wholesale on update, so resend defaultdomainenabled on every update to keep the default host off — omitting it resets to true.
- enabled Boolean
- mcp Property Map
- rate
Limit Property Map - search
Endpoint Property Map
AiSearchInstancePublicEndpointParamsChatCompletionsEndpoint, AiSearchInstancePublicEndpointParamsChatCompletionsEndpointArgs
- Disabled bool
- Disable chat completions endpoint for this public endpoint
- Disabled bool
- Disable chat completions endpoint for this public endpoint
- disabled bool
- Disable chat completions endpoint for this public endpoint
- disabled Boolean
- Disable chat completions endpoint for this public endpoint
- disabled boolean
- Disable chat completions endpoint for this public endpoint
- disabled bool
- Disable chat completions endpoint for this public endpoint
- disabled Boolean
- Disable chat completions endpoint for this public endpoint
AiSearchInstancePublicEndpointParamsMcp, AiSearchInstancePublicEndpointParamsMcpArgs
- Description string
- Disabled bool
- Disable MCP endpoint for this public endpoint
- Description string
- Disabled bool
- Disable MCP endpoint for this public endpoint
- description string
- disabled bool
- Disable MCP endpoint for this public endpoint
- description String
- disabled Boolean
- Disable MCP endpoint for this public endpoint
- description string
- disabled boolean
- Disable MCP endpoint for this public endpoint
- description str
- disabled bool
- Disable MCP endpoint for this public endpoint
- description String
- disabled Boolean
- Disable MCP endpoint for this public endpoint
AiSearchInstancePublicEndpointParamsRateLimit, AiSearchInstancePublicEndpointParamsRateLimitArgs
AiSearchInstancePublicEndpointParamsSearchEndpoint, AiSearchInstancePublicEndpointParamsSearchEndpointArgs
- Disabled bool
- Disable search endpoint for this public endpoint
- Disabled bool
- Disable search endpoint for this public endpoint
- disabled bool
- Disable search endpoint for this public endpoint
- disabled Boolean
- Disable search endpoint for this public endpoint
- disabled boolean
- Disable search endpoint for this public endpoint
- disabled bool
- Disable search endpoint for this public endpoint
- disabled Boolean
- Disable search endpoint for this public endpoint
AiSearchInstanceRetrievalOptions, AiSearchInstanceRetrievalOptionsArgs
- Boost
Bies List<AiSearch Instance Retrieval Options Boost By> - Metadata fields to boost search results by. Each entry specifies a metadata field and an optional direction. Direction defaults to 'asc' for numeric/datetime fields and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined custom*metadata field.
- Keyword
Match stringMode - Controls which documents are candidates for BM25 scoring. 'and' restricts candidates to documents containing all query terms; 'or' includes any document containing at least one term, ranked by BM25 relevance. When omitted on an update, the existing stored value is preserved; when never set, search falls back to 'and'. Available values: "and", "or".
- Boost
Bies []AiSearch Instance Retrieval Options Boost By - Metadata fields to boost search results by. Each entry specifies a metadata field and an optional direction. Direction defaults to 'asc' for numeric/datetime fields and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined custom*metadata field.
- Keyword
Match stringMode - Controls which documents are candidates for BM25 scoring. 'and' restricts candidates to documents containing all query terms; 'or' includes any document containing at least one term, ranked by BM25 relevance. When omitted on an update, the existing stored value is preserved; when never set, search falls back to 'and'. Available values: "and", "or".
- boost_
bies list(object) - Metadata fields to boost search results by. Each entry specifies a metadata field and an optional direction. Direction defaults to 'asc' for numeric/datetime fields and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined custom*metadata field.
- keyword_
match_ stringmode - Controls which documents are candidates for BM25 scoring. 'and' restricts candidates to documents containing all query terms; 'or' includes any document containing at least one term, ranked by BM25 relevance. When omitted on an update, the existing stored value is preserved; when never set, search falls back to 'and'. Available values: "and", "or".
- boost
Bies List<AiSearch Instance Retrieval Options Boost By> - Metadata fields to boost search results by. Each entry specifies a metadata field and an optional direction. Direction defaults to 'asc' for numeric/datetime fields and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined custom*metadata field.
- keyword
Match StringMode - Controls which documents are candidates for BM25 scoring. 'and' restricts candidates to documents containing all query terms; 'or' includes any document containing at least one term, ranked by BM25 relevance. When omitted on an update, the existing stored value is preserved; when never set, search falls back to 'and'. Available values: "and", "or".
- boost
Bies AiSearch Instance Retrieval Options Boost By[] - Metadata fields to boost search results by. Each entry specifies a metadata field and an optional direction. Direction defaults to 'asc' for numeric/datetime fields and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined custom*metadata field.
- keyword
Match stringMode - Controls which documents are candidates for BM25 scoring. 'and' restricts candidates to documents containing all query terms; 'or' includes any document containing at least one term, ranked by BM25 relevance. When omitted on an update, the existing stored value is preserved; when never set, search falls back to 'and'. Available values: "and", "or".
- boost_
bies Sequence[AiSearch Instance Retrieval Options Boost By] - Metadata fields to boost search results by. Each entry specifies a metadata field and an optional direction. Direction defaults to 'asc' for numeric/datetime fields and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined custom*metadata field.
- keyword_
match_ strmode - Controls which documents are candidates for BM25 scoring. 'and' restricts candidates to documents containing all query terms; 'or' includes any document containing at least one term, ranked by BM25 relevance. When omitted on an update, the existing stored value is preserved; when never set, search falls back to 'and'. Available values: "and", "or".
- boost
Bies List<Property Map> - Metadata fields to boost search results by. Each entry specifies a metadata field and an optional direction. Direction defaults to 'asc' for numeric/datetime fields and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined custom*metadata field.
- keyword
Match StringMode - Controls which documents are candidates for BM25 scoring. 'and' restricts candidates to documents containing all query terms; 'or' includes any document containing at least one term, ranked by BM25 relevance. When omitted on an update, the existing stored value is preserved; when never set, search falls back to 'and'. Available values: "and", "or".
AiSearchInstanceRetrievalOptionsBoostBy, AiSearchInstanceRetrievalOptionsBoostByArgs
- Field string
- Metadata field name to boost by. Use 'timestamp' for document freshness, or any custommetadata field. Numeric and datetime fields support all four directions (asc, desc, exists, notexists); text/boolean fields only support exists/not_exists.
- Direction string
- Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps). 'asc' = lower values rank higher. 'exists' = boost chunks that have the field. 'notexists' = boost chunks that lack the field. Optional — defaults to 'asc' for numeric/datetime fields, 'exists' for text/boolean fields. Available values: "asc", "desc", "exists", "notexists".
- Field string
- Metadata field name to boost by. Use 'timestamp' for document freshness, or any custommetadata field. Numeric and datetime fields support all four directions (asc, desc, exists, notexists); text/boolean fields only support exists/not_exists.
- Direction string
- Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps). 'asc' = lower values rank higher. 'exists' = boost chunks that have the field. 'notexists' = boost chunks that lack the field. Optional — defaults to 'asc' for numeric/datetime fields, 'exists' for text/boolean fields. Available values: "asc", "desc", "exists", "notexists".
- field string
- Metadata field name to boost by. Use 'timestamp' for document freshness, or any custommetadata field. Numeric and datetime fields support all four directions (asc, desc, exists, notexists); text/boolean fields only support exists/not_exists.
- direction string
- Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps). 'asc' = lower values rank higher. 'exists' = boost chunks that have the field. 'notexists' = boost chunks that lack the field. Optional — defaults to 'asc' for numeric/datetime fields, 'exists' for text/boolean fields. Available values: "asc", "desc", "exists", "notexists".
- field String
- Metadata field name to boost by. Use 'timestamp' for document freshness, or any custommetadata field. Numeric and datetime fields support all four directions (asc, desc, exists, notexists); text/boolean fields only support exists/not_exists.
- direction String
- Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps). 'asc' = lower values rank higher. 'exists' = boost chunks that have the field. 'notexists' = boost chunks that lack the field. Optional — defaults to 'asc' for numeric/datetime fields, 'exists' for text/boolean fields. Available values: "asc", "desc", "exists", "notexists".
- field string
- Metadata field name to boost by. Use 'timestamp' for document freshness, or any custommetadata field. Numeric and datetime fields support all four directions (asc, desc, exists, notexists); text/boolean fields only support exists/not_exists.
- direction string
- Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps). 'asc' = lower values rank higher. 'exists' = boost chunks that have the field. 'notexists' = boost chunks that lack the field. Optional — defaults to 'asc' for numeric/datetime fields, 'exists' for text/boolean fields. Available values: "asc", "desc", "exists", "notexists".
- field str
- Metadata field name to boost by. Use 'timestamp' for document freshness, or any custommetadata field. Numeric and datetime fields support all four directions (asc, desc, exists, notexists); text/boolean fields only support exists/not_exists.
- direction str
- Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps). 'asc' = lower values rank higher. 'exists' = boost chunks that have the field. 'notexists' = boost chunks that lack the field. Optional — defaults to 'asc' for numeric/datetime fields, 'exists' for text/boolean fields. Available values: "asc", "desc", "exists", "notexists".
- field String
- Metadata field name to boost by. Use 'timestamp' for document freshness, or any custommetadata field. Numeric and datetime fields support all four directions (asc, desc, exists, notexists); text/boolean fields only support exists/not_exists.
- direction String
- Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps). 'asc' = lower values rank higher. 'exists' = boost chunks that have the field. 'notexists' = boost chunks that lack the field. Optional — defaults to 'asc' for numeric/datetime fields, 'exists' for text/boolean fields. Available values: "asc", "desc", "exists", "notexists".
AiSearchInstanceSourceParams, AiSearchInstanceSourceParamsArgs
- Exclude
Items List<string> - List of path patterns to exclude. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /admin/** matches /admin/users and /admin/settings/advanced). Most accounts are limited to 10 rules; contact support to raise it.
- Include
Items List<string> - List of path patterns to include. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /blog/** matches /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact support to raise it.
- Prefix string
- R2Jurisdiction string
- Web
Crawler AiSearch Instance Source Params Web Crawler
- Exclude
Items []string - List of path patterns to exclude. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /admin/** matches /admin/users and /admin/settings/advanced). Most accounts are limited to 10 rules; contact support to raise it.
- Include
Items []string - List of path patterns to include. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /blog/** matches /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact support to raise it.
- Prefix string
- R2Jurisdiction string
- Web
Crawler AiSearch Instance Source Params Web Crawler
- exclude_
items list(string) - List of path patterns to exclude. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /admin/** matches /admin/users and /admin/settings/advanced). Most accounts are limited to 10 rules; contact support to raise it.
- include_
items list(string) - List of path patterns to include. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /blog/** matches /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact support to raise it.
- prefix string
- r2_
jurisdiction string - web_
crawler object
- exclude
Items List<String> - List of path patterns to exclude. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /admin/** matches /admin/users and /admin/settings/advanced). Most accounts are limited to 10 rules; contact support to raise it.
- include
Items List<String> - List of path patterns to include. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /blog/** matches /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact support to raise it.
- prefix String
- r2Jurisdiction String
- web
Crawler AiSearch Instance Source Params Web Crawler
- exclude
Items string[] - List of path patterns to exclude. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /admin/** matches /admin/users and /admin/settings/advanced). Most accounts are limited to 10 rules; contact support to raise it.
- include
Items string[] - List of path patterns to include. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /blog/** matches /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact support to raise it.
- prefix string
- r2Jurisdiction string
- web
Crawler AiSearch Instance Source Params Web Crawler
- exclude_
items Sequence[str] - List of path patterns to exclude. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /admin/** matches /admin/users and /admin/settings/advanced). Most accounts are limited to 10 rules; contact support to raise it.
- include_
items Sequence[str] - List of path patterns to include. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /blog/** matches /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact support to raise it.
- prefix str
- r2_
jurisdiction str - web_
crawler AiSearch Instance Source Params Web Crawler
- exclude
Items List<String> - List of path patterns to exclude. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /admin/** matches /admin/users and /admin/settings/advanced). Most accounts are limited to 10 rules; contact support to raise it.
- include
Items List<String> - List of path patterns to include. Uses micromatch glob syntax: * matches within a path segment, ** matches across path segments (e.g., /blog/** matches /blog/post and /blog/2024/post). Most accounts are limited to 10 rules; contact support to raise it.
- prefix String
- r2Jurisdiction String
- web
Crawler Property Map
AiSearchInstanceSourceParamsWebCrawler, AiSearchInstanceSourceParamsWebCrawlerArgs
- Store
Options AiSearch Instance Source Params Web Crawler Store Options - Discover
Options AiSearch Instance Source Params Web Crawler Discover Options - Options for parse*type 'discover', where Browser Run discovers URLs by link following and sitemaps. Ignored for 'sitemap'.
- Parse
Options AiSearch Instance Source Params Web Crawler Parse Options - Parse
Type string - How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links recursively and requires the source to be a Verified zone on this account. Available values: "sitemap", "discover".
- Store
Options AiSearch Instance Source Params Web Crawler Store Options - Discover
Options AiSearch Instance Source Params Web Crawler Discover Options - Options for parse*type 'discover', where Browser Run discovers URLs by link following and sitemaps. Ignored for 'sitemap'.
- Parse
Options AiSearch Instance Source Params Web Crawler Parse Options - Parse
Type string - How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links recursively and requires the source to be a Verified zone on this account. Available values: "sitemap", "discover".
- store_
options object - discover_
options object - Options for parse*type 'discover', where Browser Run discovers URLs by link following and sitemaps. Ignored for 'sitemap'.
- parse_
options object - parse_
type string - How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links recursively and requires the source to be a Verified zone on this account. Available values: "sitemap", "discover".
- store
Options AiSearch Instance Source Params Web Crawler Store Options - discover
Options AiSearch Instance Source Params Web Crawler Discover Options - Options for parse*type 'discover', where Browser Run discovers URLs by link following and sitemaps. Ignored for 'sitemap'.
- parse
Options AiSearch Instance Source Params Web Crawler Parse Options - parse
Type String - How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links recursively and requires the source to be a Verified zone on this account. Available values: "sitemap", "discover".
- store
Options AiSearch Instance Source Params Web Crawler Store Options - discover
Options AiSearch Instance Source Params Web Crawler Discover Options - Options for parse*type 'discover', where Browser Run discovers URLs by link following and sitemaps. Ignored for 'sitemap'.
- parse
Options AiSearch Instance Source Params Web Crawler Parse Options - parse
Type string - How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links recursively and requires the source to be a Verified zone on this account. Available values: "sitemap", "discover".
- store_
options AiSearch Instance Source Params Web Crawler Store Options - discover_
options AiSearch Instance Source Params Web Crawler Discover Options - Options for parse*type 'discover', where Browser Run discovers URLs by link following and sitemaps. Ignored for 'sitemap'.
- parse_
options AiSearch Instance Source Params Web Crawler Parse Options - parse_
type str - How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links recursively and requires the source to be a Verified zone on this account. Available values: "sitemap", "discover".
- store
Options Property Map - discover
Options Property Map - Options for parse*type 'discover', where Browser Run discovers URLs by link following and sitemaps. Ignored for 'sitemap'.
- parse
Options Property Map - parse
Type String - How URLs are discovered. 'sitemap' reads XML sitemaps; 'discover' follows links recursively and requires the source to be a Verified zone on this account. Available values: "sitemap", "discover".
AiSearchInstanceSourceParamsWebCrawlerDiscoverOptions, AiSearchInstanceSourceParamsWebCrawlerDiscoverOptionsArgs
- Depth double
- Maximum link-follow depth from the seed URL.
- Include
External boolLinks - Follow links that point outside the source domain. Must stay
false— discover crawls are restricted to the zone you own. - Include
Subdomains bool - Follow links to subdomains of the source host.
- Limit double
- Maximum number of pages to crawl (1-100000).
- Max
Age double - Maximum content age in seconds to accept (0–604800).
- Source string
- Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links' follows page links only, 'all' does both. Available values: "all", "sitemaps", "links".
- Depth float64
- Maximum link-follow depth from the seed URL.
- Include
External boolLinks - Follow links that point outside the source domain. Must stay
false— discover crawls are restricted to the zone you own. - Include
Subdomains bool - Follow links to subdomains of the source host.
- Limit float64
- Maximum number of pages to crawl (1-100000).
- Max
Age float64 - Maximum content age in seconds to accept (0–604800).
- Source string
- Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links' follows page links only, 'all' does both. Available values: "all", "sitemaps", "links".
- depth number
- Maximum link-follow depth from the seed URL.
- include_
external_ boollinks - Follow links that point outside the source domain. Must stay
false— discover crawls are restricted to the zone you own. - include_
subdomains bool - Follow links to subdomains of the source host.
- limit number
- Maximum number of pages to crawl (1-100000).
- max_
age number - Maximum content age in seconds to accept (0–604800).
- source string
- Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links' follows page links only, 'all' does both. Available values: "all", "sitemaps", "links".
- depth Double
- Maximum link-follow depth from the seed URL.
- include
External BooleanLinks - Follow links that point outside the source domain. Must stay
false— discover crawls are restricted to the zone you own. - include
Subdomains Boolean - Follow links to subdomains of the source host.
- limit Double
- Maximum number of pages to crawl (1-100000).
- max
Age Double - Maximum content age in seconds to accept (0–604800).
- source String
- Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links' follows page links only, 'all' does both. Available values: "all", "sitemaps", "links".
- depth number
- Maximum link-follow depth from the seed URL.
- include
External booleanLinks - Follow links that point outside the source domain. Must stay
false— discover crawls are restricted to the zone you own. - include
Subdomains boolean - Follow links to subdomains of the source host.
- limit number
- Maximum number of pages to crawl (1-100000).
- max
Age number - Maximum content age in seconds to accept (0–604800).
- source string
- Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links' follows page links only, 'all' does both. Available values: "all", "sitemaps", "links".
- depth float
- Maximum link-follow depth from the seed URL.
- include_
external_ boollinks - Follow links that point outside the source domain. Must stay
false— discover crawls are restricted to the zone you own. - include_
subdomains bool - Follow links to subdomains of the source host.
- limit float
- Maximum number of pages to crawl (1-100000).
- max_
age float - Maximum content age in seconds to accept (0–604800).
- source str
- Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links' follows page links only, 'all' does both. Available values: "all", "sitemaps", "links".
- depth Number
- Maximum link-follow depth from the seed URL.
- include
External BooleanLinks - Follow links that point outside the source domain. Must stay
false— discover crawls are restricted to the zone you own. - include
Subdomains Boolean - Follow links to subdomains of the source host.
- limit Number
- Maximum number of pages to crawl (1-100000).
- max
Age Number - Maximum content age in seconds to accept (0–604800).
- source String
- Where the crawler looks for URLs: 'sitemaps' reads sitemap XML only, 'links' follows page links only, 'all' does both. Available values: "all", "sitemaps", "links".
AiSearchInstanceSourceParamsWebCrawlerParseOptions, AiSearchInstanceSourceParamsWebCrawlerParseOptionsArgs
- Content
Selectors List<AiSearch Instance Source Params Web Crawler Parse Options Content Selector> - List of path-to-selector mappings for extracting specific content from crawled pages. Each entry pairs a URL glob pattern with a CSS selector. The first matching path wins. Only the matched HTML fragment is stored and indexed. Omit the field to disable content selection — empty arrays are rejected.
- Include
Headers Dictionary<string, string> - Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230 token characters (no spaces, colons, or control characters); values must be HTAB + printable ASCII (no CR/LF).
- Include
Images bool - Specific
Sitemaps List<string> - List of specific sitemap URLs to use for crawling. Only valid when parseType is 'sitemap'.
- Use
Browser boolRendering
- Content
Selectors []AiSearch Instance Source Params Web Crawler Parse Options Content Selector - List of path-to-selector mappings for extracting specific content from crawled pages. Each entry pairs a URL glob pattern with a CSS selector. The first matching path wins. Only the matched HTML fragment is stored and indexed. Omit the field to disable content selection — empty arrays are rejected.
- Include
Headers map[string]string - Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230 token characters (no spaces, colons, or control characters); values must be HTAB + printable ASCII (no CR/LF).
- Include
Images bool - Specific
Sitemaps []string - List of specific sitemap URLs to use for crawling. Only valid when parseType is 'sitemap'.
- Use
Browser boolRendering
- content_
selectors list(object) - List of path-to-selector mappings for extracting specific content from crawled pages. Each entry pairs a URL glob pattern with a CSS selector. The first matching path wins. Only the matched HTML fragment is stored and indexed. Omit the field to disable content selection — empty arrays are rejected.
- include_
headers map(string) - Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230 token characters (no spaces, colons, or control characters); values must be HTAB + printable ASCII (no CR/LF).
- include_
images bool - specific_
sitemaps list(string) - List of specific sitemap URLs to use for crawling. Only valid when parseType is 'sitemap'.
- use_
browser_ boolrendering
- content
Selectors List<AiSearch Instance Source Params Web Crawler Parse Options Content Selector> - List of path-to-selector mappings for extracting specific content from crawled pages. Each entry pairs a URL glob pattern with a CSS selector. The first matching path wins. Only the matched HTML fragment is stored and indexed. Omit the field to disable content selection — empty arrays are rejected.
- include
Headers Map<String,String> - Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230 token characters (no spaces, colons, or control characters); values must be HTAB + printable ASCII (no CR/LF).
- include
Images Boolean - specific
Sitemaps List<String> - List of specific sitemap URLs to use for crawling. Only valid when parseType is 'sitemap'.
- use
Browser BooleanRendering
- content
Selectors AiSearch Instance Source Params Web Crawler Parse Options Content Selector[] - List of path-to-selector mappings for extracting specific content from crawled pages. Each entry pairs a URL glob pattern with a CSS selector. The first matching path wins. Only the matched HTML fragment is stored and indexed. Omit the field to disable content selection — empty arrays are rejected.
- include
Headers {[key: string]: string} - Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230 token characters (no spaces, colons, or control characters); values must be HTAB + printable ASCII (no CR/LF).
- include
Images boolean - specific
Sitemaps string[] - List of specific sitemap URLs to use for crawling. Only valid when parseType is 'sitemap'.
- use
Browser booleanRendering
- content_
selectors Sequence[AiSearch Instance Source Params Web Crawler Parse Options Content Selector] - List of path-to-selector mappings for extracting specific content from crawled pages. Each entry pairs a URL glob pattern with a CSS selector. The first matching path wins. Only the matched HTML fragment is stored and indexed. Omit the field to disable content selection — empty arrays are rejected.
- include_
headers Mapping[str, str] - Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230 token characters (no spaces, colons, or control characters); values must be HTAB + printable ASCII (no CR/LF).
- include_
images bool - specific_
sitemaps Sequence[str] - List of specific sitemap URLs to use for crawling. Only valid when parseType is 'sitemap'.
- use_
browser_ boolrendering
- content
Selectors List<Property Map> - List of path-to-selector mappings for extracting specific content from crawled pages. Each entry pairs a URL glob pattern with a CSS selector. The first matching path wins. Only the matched HTML fragment is stored and indexed. Omit the field to disable content selection — empty arrays are rejected.
- include
Headers Map<String> - Up to 5 custom HTTP headers sent with each crawl request. Names must be RFC-7230 token characters (no spaces, colons, or control characters); values must be HTAB + printable ASCII (no CR/LF).
- include
Images Boolean - specific
Sitemaps List<String> - List of specific sitemap URLs to use for crawling. Only valid when parseType is 'sitemap'.
- use
Browser BooleanRendering
AiSearchInstanceSourceParamsWebCrawlerParseOptionsContentSelector, AiSearchInstanceSourceParamsWebCrawlerParseOptionsContentSelectorArgs
- Path string
- Glob pattern to match against the page URL path. Uses standard glob syntax: * matches within a segment, ** crosses directories.
- Selector string
- CSS selector to extract content from pages matching the path pattern. Must not contain disallowed characters (;, `, $, {, }, ). Must target a single element; if multiple elements match, the selector is ignored and the full page is used.
- Path string
- Glob pattern to match against the page URL path. Uses standard glob syntax: * matches within a segment, ** crosses directories.
- Selector string
- CSS selector to extract content from pages matching the path pattern. Must not contain disallowed characters (;, `, $, {, }, ). Must target a single element; if multiple elements match, the selector is ignored and the full page is used.
- path string
- Glob pattern to match against the page URL path. Uses standard glob syntax: * matches within a segment, ** crosses directories.
- selector string
- CSS selector to extract content from pages matching the path pattern. Must not contain disallowed characters (;, `, $, {, }, ). Must target a single element; if multiple elements match, the selector is ignored and the full page is used.
- path String
- Glob pattern to match against the page URL path. Uses standard glob syntax: * matches within a segment, ** crosses directories.
- selector String
- CSS selector to extract content from pages matching the path pattern. Must not contain disallowed characters (;, `, $, {, }, ). Must target a single element; if multiple elements match, the selector is ignored and the full page is used.
- path string
- Glob pattern to match against the page URL path. Uses standard glob syntax: * matches within a segment, ** crosses directories.
- selector string
- CSS selector to extract content from pages matching the path pattern. Must not contain disallowed characters (;, `, $, {, }, ). Must target a single element; if multiple elements match, the selector is ignored and the full page is used.
- path str
- Glob pattern to match against the page URL path. Uses standard glob syntax: * matches within a segment, ** crosses directories.
- selector str
- CSS selector to extract content from pages matching the path pattern. Must not contain disallowed characters (;, `, $, {, }, ). Must target a single element; if multiple elements match, the selector is ignored and the full page is used.
- path String
- Glob pattern to match against the page URL path. Uses standard glob syntax: * matches within a segment, ** crosses directories.
- selector String
- CSS selector to extract content from pages matching the path pattern. Must not contain disallowed characters (;, `, $, {, }, ). Must target a single element; if multiple elements match, the selector is ignored and the full page is used.
AiSearchInstanceSourceParamsWebCrawlerStoreOptions, AiSearchInstanceSourceParamsWebCrawlerStoreOptionsArgs
- R2Jurisdiction string
- Storage
Id string - Storage
Type string
- R2Jurisdiction string
- Storage
Id string - Storage
Type string
- r2_
jurisdiction string - storage_
id string - storage_
type string
- r2Jurisdiction String
- storage
Id String - storage
Type String
- r2Jurisdiction string
- storage
Id string - storage
Type string
- r2_
jurisdiction str - storage_
id str - storage_
type str
- r2Jurisdiction String
- storage
Id String - storage
Type String
Package Details
- Repository
- Cloudflare pulumi/pulumi-cloudflare
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
cloudflareTerraform Provider.
published on Wednesday, Oct 21, 2026 by Pulumi