## Update instances.

`aisearch.instances.update(strid, InstanceUpdateParams**kwargs)  -> InstanceUpdateResponse`

**put** `/accounts/{account_id}/ai-search/instances/{id}`

Update instances.

### Parameters

- `account_id: str`

- `id: str`

  AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.

- `ai_gateway_id: Optional[str]`

- `aisearch_model: Optional[Literal["@cf/meta/llama-3.3-70b-instruct-fp8-fast", "@cf/zai-org/glm-4.7-flash", "@cf/meta/llama-3.1-8b-instruct-fast", 25 more]]`

  - `"@cf/meta/llama-3.3-70b-instruct-fp8-fast"`

  - `"@cf/zai-org/glm-4.7-flash"`

  - `"@cf/meta/llama-3.1-8b-instruct-fast"`

  - `"@cf/meta/llama-3.1-8b-instruct-fp8"`

  - `"@cf/meta/llama-4-scout-17b-16e-instruct"`

  - `"@cf/qwen/qwen3-30b-a3b-fp8"`

  - `"@cf/deepseek-ai/deepseek-r1-distill-qwen-32b"`

  - `"@cf/moonshotai/kimi-k2-instruct"`

  - `"@cf/google/gemma-3-12b-it"`

  - `"anthropic/claude-3-7-sonnet"`

  - `"anthropic/claude-sonnet-4"`

  - `"anthropic/claude-opus-4"`

  - `"anthropic/claude-3-5-haiku"`

  - `"cerebras/qwen-3-235b-a22b-instruct"`

  - `"cerebras/qwen-3-235b-a22b-thinking"`

  - `"cerebras/llama-3.3-70b"`

  - `"cerebras/llama-4-maverick-17b-128e-instruct"`

  - `"cerebras/llama-4-scout-17b-16e-instruct"`

  - `"cerebras/gpt-oss-120b"`

  - `"google-ai-studio/gemini-2.5-flash"`

  - `"google-ai-studio/gemini-2.5-pro"`

  - `"grok/grok-4"`

  - `"groq/llama-3.3-70b-versatile"`

  - `"groq/llama-3.1-8b-instant"`

  - `"openai/gpt-5"`

  - `"openai/gpt-5-mini"`

  - `"openai/gpt-5-nano"`

  - `""`

- `cache: Optional[bool]`

- `cache_threshold: Optional[Literal["super_strict_match", "close_enough", "flexible_friend", "anything_goes"]]`

  - `"super_strict_match"`

  - `"close_enough"`

  - `"flexible_friend"`

  - `"anything_goes"`

- `chunk: Optional[bool]`

- `chunk_overlap: Optional[int]`

- `chunk_size: Optional[int]`

- `custom_metadata: Optional[Iterable[CustomMetadata]]`

  - `data_type: Literal["text", "number", "boolean", "datetime"]`

    - `"text"`

    - `"number"`

    - `"boolean"`

    - `"datetime"`

  - `field_name: str`

- `embedding_model: Optional[Literal["@cf/qwen/qwen3-embedding-0.6b", "@cf/baai/bge-m3", "@cf/baai/bge-large-en-v1.5", 6 more]]`

  - `"@cf/qwen/qwen3-embedding-0.6b"`

  - `"@cf/baai/bge-m3"`

  - `"@cf/baai/bge-large-en-v1.5"`

  - `"@cf/google/embeddinggemma-300m"`

  - `"google-ai-studio/gemini-embedding-001"`

  - `"google-ai-studio/gemini-embedding-2-preview"`

  - `"openai/text-embedding-3-small"`

  - `"openai/text-embedding-3-large"`

  - `""`

- `fusion_method: Optional[Literal["max", "rrf"]]`

  - `"max"`

  - `"rrf"`

- `hybrid_search_enabled: Optional[bool]`

- `indexing_options: Optional[IndexingOptions]`

  - `keyword_tokenizer: Optional[Literal["porter", "trigram"]]`

    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.

    - `"porter"`

    - `"trigram"`

- `max_num_results: Optional[int]`

- `metadata: Optional[Metadata]`

  - `created_from_aisearch_wizard: Optional[bool]`

  - `worker_domain: Optional[str]`

- `paused: Optional[bool]`

- `public_endpoint_params: Optional[PublicEndpointParams]`

  - `authorized_hosts: Optional[SequenceNotStr[str]]`

  - `chat_completions_endpoint: Optional[PublicEndpointParamsChatCompletionsEndpoint]`

    - `disabled: Optional[bool]`

      Disable chat completions endpoint for this public endpoint

  - `enabled: Optional[bool]`

  - `mcp: Optional[PublicEndpointParamsMcp]`

    - `description: Optional[str]`

    - `disabled: Optional[bool]`

      Disable MCP endpoint for this public endpoint

  - `rate_limit: Optional[PublicEndpointParamsRateLimit]`

    - `period_ms: Optional[int]`

    - `requests: Optional[int]`

    - `technique: Optional[Literal["fixed", "sliding"]]`

      - `"fixed"`

      - `"sliding"`

  - `search_endpoint: Optional[PublicEndpointParamsSearchEndpoint]`

    - `disabled: Optional[bool]`

      Disable search endpoint for this public endpoint

- `reranking: Optional[bool]`

- `reranking_model: Optional[Literal["@cf/baai/bge-reranker-base", ""]]`

  - `"@cf/baai/bge-reranker-base"`

  - `""`

- `retrieval_options: Optional[RetrievalOptions]`

  - `boost_by: Optional[Iterable[RetrievalOptionsBoostBy]]`

    Metadata fields to boost search results by. Each entry specifies a metadata field and an optional direction. Direction defaults to 'asc' for numeric fields and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined custom_metadata field.

    - `field: str`

      Metadata field name to boost by. Use 'timestamp' for document freshness, or any custom_metadata field. Numeric and datetime fields support asc/desc directions; text/boolean fields support exists/not_exists.

    - `direction: Optional[Literal["asc", "desc", "exists", "not_exists"]]`

      Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps). 'asc' = lower values rank higher. 'exists' = boost chunks that have the field. 'not_exists' = boost chunks that lack the field. Optional ��� defaults to 'asc' for numeric/datetime fields, 'exists' for text/boolean fields.

      - `"asc"`

      - `"desc"`

      - `"exists"`

      - `"not_exists"`

  - `keyword_match_mode: Optional[Literal["and", "or"]]`

    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. Defaults to 'and'. Legacy values 'exact_match' and 'fuzzy_match' are accepted and map to 'and' and 'or' respectively.

    - `"and"`

    - `"or"`

- `rewrite_model: Optional[Literal["@cf/meta/llama-3.3-70b-instruct-fp8-fast", "@cf/zai-org/glm-4.7-flash", "@cf/meta/llama-3.1-8b-instruct-fast", 25 more]]`

  - `"@cf/meta/llama-3.3-70b-instruct-fp8-fast"`

  - `"@cf/zai-org/glm-4.7-flash"`

  - `"@cf/meta/llama-3.1-8b-instruct-fast"`

  - `"@cf/meta/llama-3.1-8b-instruct-fp8"`

  - `"@cf/meta/llama-4-scout-17b-16e-instruct"`

  - `"@cf/qwen/qwen3-30b-a3b-fp8"`

  - `"@cf/deepseek-ai/deepseek-r1-distill-qwen-32b"`

  - `"@cf/moonshotai/kimi-k2-instruct"`

  - `"@cf/google/gemma-3-12b-it"`

  - `"anthropic/claude-3-7-sonnet"`

  - `"anthropic/claude-sonnet-4"`

  - `"anthropic/claude-opus-4"`

  - `"anthropic/claude-3-5-haiku"`

  - `"cerebras/qwen-3-235b-a22b-instruct"`

  - `"cerebras/qwen-3-235b-a22b-thinking"`

  - `"cerebras/llama-3.3-70b"`

  - `"cerebras/llama-4-maverick-17b-128e-instruct"`

  - `"cerebras/llama-4-scout-17b-16e-instruct"`

  - `"cerebras/gpt-oss-120b"`

  - `"google-ai-studio/gemini-2.5-flash"`

  - `"google-ai-studio/gemini-2.5-pro"`

  - `"grok/grok-4"`

  - `"groq/llama-3.3-70b-versatile"`

  - `"groq/llama-3.1-8b-instant"`

  - `"openai/gpt-5"`

  - `"openai/gpt-5-mini"`

  - `"openai/gpt-5-nano"`

  - `""`

- `rewrite_query: Optional[bool]`

- `score_threshold: Optional[float]`

- `source_params: Optional[SourceParams]`

  - `exclude_items: Optional[SequenceNotStr[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)

  - `include_items: Optional[SequenceNotStr[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)

  - `prefix: Optional[str]`

  - `r2_jurisdiction: Optional[str]`

  - `web_crawler: Optional[SourceParamsWebCrawler]`

    - `crawl_options: Optional[SourceParamsWebCrawlerCrawlOptions]`

      - `depth: Optional[float]`

      - `include_external_links: Optional[bool]`

      - `include_subdomains: Optional[bool]`

      - `max_age: Optional[float]`

      - `source: Optional[Literal["all", "sitemaps", "links"]]`

        - `"all"`

        - `"sitemaps"`

        - `"links"`

    - `parse_options: Optional[SourceParamsWebCrawlerParseOptions]`

      - `content_selector: Optional[Iterable[SourceParamsWebCrawlerParseOptionsContentSelector]]`

        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.

        - `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. Supports standard CSS selectors including class, ID, element, and attribute selectors.

      - `include_headers: Optional[Dict[str, str]]`

      - `include_images: Optional[bool]`

      - `specific_sitemaps: Optional[SequenceNotStr[str]]`

        List of specific sitemap URLs to use for crawling. Only valid when parse_type is 'sitemap'.

      - `use_browser_rendering: Optional[bool]`

    - `parse_type: Optional[Literal["sitemap", "feed-rss", "crawl"]]`

      - `"sitemap"`

      - `"feed-rss"`

      - `"crawl"`

    - `store_options: Optional[SourceParamsWebCrawlerStoreOptions]`

      - `storage_id: str`

      - `r2_jurisdiction: Optional[str]`

      - `storage_type: Optional[Provider]`

        - `"r2"`

- `summarization: Optional[bool]`

- `summarization_model: Optional[Literal["@cf/meta/llama-3.3-70b-instruct-fp8-fast", "@cf/zai-org/glm-4.7-flash", "@cf/meta/llama-3.1-8b-instruct-fast", 25 more]]`

  - `"@cf/meta/llama-3.3-70b-instruct-fp8-fast"`

  - `"@cf/zai-org/glm-4.7-flash"`

  - `"@cf/meta/llama-3.1-8b-instruct-fast"`

  - `"@cf/meta/llama-3.1-8b-instruct-fp8"`

  - `"@cf/meta/llama-4-scout-17b-16e-instruct"`

  - `"@cf/qwen/qwen3-30b-a3b-fp8"`

  - `"@cf/deepseek-ai/deepseek-r1-distill-qwen-32b"`

  - `"@cf/moonshotai/kimi-k2-instruct"`

  - `"@cf/google/gemma-3-12b-it"`

  - `"anthropic/claude-3-7-sonnet"`

  - `"anthropic/claude-sonnet-4"`

  - `"anthropic/claude-opus-4"`

  - `"anthropic/claude-3-5-haiku"`

  - `"cerebras/qwen-3-235b-a22b-instruct"`

  - `"cerebras/qwen-3-235b-a22b-thinking"`

  - `"cerebras/llama-3.3-70b"`

  - `"cerebras/llama-4-maverick-17b-128e-instruct"`

  - `"cerebras/llama-4-scout-17b-16e-instruct"`

  - `"cerebras/gpt-oss-120b"`

  - `"google-ai-studio/gemini-2.5-flash"`

  - `"google-ai-studio/gemini-2.5-pro"`

  - `"grok/grok-4"`

  - `"groq/llama-3.3-70b-versatile"`

  - `"groq/llama-3.1-8b-instant"`

  - `"openai/gpt-5"`

  - `"openai/gpt-5-mini"`

  - `"openai/gpt-5-nano"`

  - `""`

- `system_prompt_aisearch: Optional[str]`

- `system_prompt_index_summarization: Optional[str]`

- `system_prompt_rewrite_query: Optional[str]`

- `token_id: Optional[str]`

### Returns

- `class InstanceUpdateResponse: …`

  - `id: str`

    AI Search instance ID. Lowercase alphanumeric, hyphens, and underscores.

  - `created_at: datetime`

  - `modified_at: datetime`

  - `ai_gateway_id: Optional[str]`

  - `aisearch_model: Optional[Literal["@cf/meta/llama-3.3-70b-instruct-fp8-fast", "@cf/zai-org/glm-4.7-flash", "@cf/meta/llama-3.1-8b-instruct-fast", 25 more]]`

    - `"@cf/meta/llama-3.3-70b-instruct-fp8-fast"`

    - `"@cf/zai-org/glm-4.7-flash"`

    - `"@cf/meta/llama-3.1-8b-instruct-fast"`

    - `"@cf/meta/llama-3.1-8b-instruct-fp8"`

    - `"@cf/meta/llama-4-scout-17b-16e-instruct"`

    - `"@cf/qwen/qwen3-30b-a3b-fp8"`

    - `"@cf/deepseek-ai/deepseek-r1-distill-qwen-32b"`

    - `"@cf/moonshotai/kimi-k2-instruct"`

    - `"@cf/google/gemma-3-12b-it"`

    - `"anthropic/claude-3-7-sonnet"`

    - `"anthropic/claude-sonnet-4"`

    - `"anthropic/claude-opus-4"`

    - `"anthropic/claude-3-5-haiku"`

    - `"cerebras/qwen-3-235b-a22b-instruct"`

    - `"cerebras/qwen-3-235b-a22b-thinking"`

    - `"cerebras/llama-3.3-70b"`

    - `"cerebras/llama-4-maverick-17b-128e-instruct"`

    - `"cerebras/llama-4-scout-17b-16e-instruct"`

    - `"cerebras/gpt-oss-120b"`

    - `"google-ai-studio/gemini-2.5-flash"`

    - `"google-ai-studio/gemini-2.5-pro"`

    - `"grok/grok-4"`

    - `"groq/llama-3.3-70b-versatile"`

    - `"groq/llama-3.1-8b-instant"`

    - `"openai/gpt-5"`

    - `"openai/gpt-5-mini"`

    - `"openai/gpt-5-nano"`

    - `""`

  - `cache: Optional[bool]`

  - `cache_threshold: Optional[Literal["super_strict_match", "close_enough", "flexible_friend", "anything_goes"]]`

    - `"super_strict_match"`

    - `"close_enough"`

    - `"flexible_friend"`

    - `"anything_goes"`

  - `chunk_overlap: Optional[int]`

  - `chunk_size: Optional[int]`

  - `created_by: Optional[str]`

  - `custom_metadata: Optional[List[CustomMetadata]]`

    - `data_type: Literal["text", "number", "boolean", "datetime"]`

      - `"text"`

      - `"number"`

      - `"boolean"`

      - `"datetime"`

    - `field_name: str`

  - `embedding_model: Optional[Literal["@cf/qwen/qwen3-embedding-0.6b", "@cf/baai/bge-m3", "@cf/baai/bge-large-en-v1.5", 6 more]]`

    - `"@cf/qwen/qwen3-embedding-0.6b"`

    - `"@cf/baai/bge-m3"`

    - `"@cf/baai/bge-large-en-v1.5"`

    - `"@cf/google/embeddinggemma-300m"`

    - `"google-ai-studio/gemini-embedding-001"`

    - `"google-ai-studio/gemini-embedding-2-preview"`

    - `"openai/text-embedding-3-small"`

    - `"openai/text-embedding-3-large"`

    - `""`

  - `enable: Optional[bool]`

  - `engine_version: Optional[float]`

  - `fusion_method: Optional[Literal["max", "rrf"]]`

    - `"max"`

    - `"rrf"`

  - `hybrid_search_enabled: Optional[bool]`

  - `indexing_options: Optional[IndexingOptions]`

    - `keyword_tokenizer: Optional[Literal["porter", "trigram"]]`

      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.

      - `"porter"`

      - `"trigram"`

  - `last_activity: Optional[datetime]`

  - `max_num_results: Optional[int]`

  - `metadata: Optional[Metadata]`

    - `created_from_aisearch_wizard: Optional[bool]`

    - `worker_domain: Optional[str]`

  - `modified_by: Optional[str]`

  - `namespace: Optional[str]`

  - `paused: Optional[bool]`

  - `public_endpoint_id: Optional[str]`

  - `public_endpoint_params: Optional[PublicEndpointParams]`

    - `authorized_hosts: Optional[List[str]]`

    - `chat_completions_endpoint: Optional[PublicEndpointParamsChatCompletionsEndpoint]`

      - `disabled: Optional[bool]`

        Disable chat completions endpoint for this public endpoint

    - `enabled: Optional[bool]`

    - `mcp: Optional[PublicEndpointParamsMcp]`

      - `description: Optional[str]`

      - `disabled: Optional[bool]`

        Disable MCP endpoint for this public endpoint

    - `rate_limit: Optional[PublicEndpointParamsRateLimit]`

      - `period_ms: Optional[int]`

      - `requests: Optional[int]`

      - `technique: Optional[Literal["fixed", "sliding"]]`

        - `"fixed"`

        - `"sliding"`

    - `search_endpoint: Optional[PublicEndpointParamsSearchEndpoint]`

      - `disabled: Optional[bool]`

        Disable search endpoint for this public endpoint

  - `reranking: Optional[bool]`

  - `reranking_model: Optional[Literal["@cf/baai/bge-reranker-base", ""]]`

    - `"@cf/baai/bge-reranker-base"`

    - `""`

  - `retrieval_options: Optional[RetrievalOptions]`

    - `boost_by: Optional[List[RetrievalOptionsBoostBy]]`

      Metadata fields to boost search results by. Each entry specifies a metadata field and an optional direction. Direction defaults to 'asc' for numeric fields and 'exists' for text/boolean fields. Fields must match 'timestamp' or a defined custom_metadata field.

      - `field: str`

        Metadata field name to boost by. Use 'timestamp' for document freshness, or any custom_metadata field. Numeric and datetime fields support asc/desc directions; text/boolean fields support exists/not_exists.

      - `direction: Optional[Literal["asc", "desc", "exists", "not_exists"]]`

        Boost direction. 'desc' = higher values rank higher (e.g. newer timestamps). 'asc' = lower values rank higher. 'exists' = boost chunks that have the field. 'not_exists' = boost chunks that lack the field. Optional ��� defaults to 'asc' for numeric/datetime fields, 'exists' for text/boolean fields.

        - `"asc"`

        - `"desc"`

        - `"exists"`

        - `"not_exists"`

    - `keyword_match_mode: Optional[Literal["and", "or"]]`

      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. Defaults to 'and'. Legacy values 'exact_match' and 'fuzzy_match' are accepted and map to 'and' and 'or' respectively.

      - `"and"`

      - `"or"`

  - `rewrite_model: Optional[Literal["@cf/meta/llama-3.3-70b-instruct-fp8-fast", "@cf/zai-org/glm-4.7-flash", "@cf/meta/llama-3.1-8b-instruct-fast", 25 more]]`

    - `"@cf/meta/llama-3.3-70b-instruct-fp8-fast"`

    - `"@cf/zai-org/glm-4.7-flash"`

    - `"@cf/meta/llama-3.1-8b-instruct-fast"`

    - `"@cf/meta/llama-3.1-8b-instruct-fp8"`

    - `"@cf/meta/llama-4-scout-17b-16e-instruct"`

    - `"@cf/qwen/qwen3-30b-a3b-fp8"`

    - `"@cf/deepseek-ai/deepseek-r1-distill-qwen-32b"`

    - `"@cf/moonshotai/kimi-k2-instruct"`

    - `"@cf/google/gemma-3-12b-it"`

    - `"anthropic/claude-3-7-sonnet"`

    - `"anthropic/claude-sonnet-4"`

    - `"anthropic/claude-opus-4"`

    - `"anthropic/claude-3-5-haiku"`

    - `"cerebras/qwen-3-235b-a22b-instruct"`

    - `"cerebras/qwen-3-235b-a22b-thinking"`

    - `"cerebras/llama-3.3-70b"`

    - `"cerebras/llama-4-maverick-17b-128e-instruct"`

    - `"cerebras/llama-4-scout-17b-16e-instruct"`

    - `"cerebras/gpt-oss-120b"`

    - `"google-ai-studio/gemini-2.5-flash"`

    - `"google-ai-studio/gemini-2.5-pro"`

    - `"grok/grok-4"`

    - `"groq/llama-3.3-70b-versatile"`

    - `"groq/llama-3.1-8b-instant"`

    - `"openai/gpt-5"`

    - `"openai/gpt-5-mini"`

    - `"openai/gpt-5-nano"`

    - `""`

  - `rewrite_query: Optional[bool]`

  - `score_threshold: Optional[float]`

  - `source: Optional[str]`

  - `source_params: Optional[SourceParams]`

    - `exclude_items: Optional[List[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)

    - `include_items: Optional[List[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)

    - `prefix: Optional[str]`

    - `r2_jurisdiction: Optional[str]`

    - `web_crawler: Optional[SourceParamsWebCrawler]`

      - `crawl_options: Optional[SourceParamsWebCrawlerCrawlOptions]`

        - `depth: Optional[float]`

        - `include_external_links: Optional[bool]`

        - `include_subdomains: Optional[bool]`

        - `max_age: Optional[float]`

        - `source: Optional[Literal["all", "sitemaps", "links"]]`

          - `"all"`

          - `"sitemaps"`

          - `"links"`

      - `parse_options: Optional[SourceParamsWebCrawlerParseOptions]`

        - `content_selector: Optional[List[SourceParamsWebCrawlerParseOptionsContentSelector]]`

          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.

          - `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. Supports standard CSS selectors including class, ID, element, and attribute selectors.

        - `include_headers: Optional[Dict[str, str]]`

        - `include_images: Optional[bool]`

        - `specific_sitemaps: Optional[List[str]]`

          List of specific sitemap URLs to use for crawling. Only valid when parse_type is 'sitemap'.

        - `use_browser_rendering: Optional[bool]`

      - `parse_type: Optional[Literal["sitemap", "feed-rss", "crawl"]]`

        - `"sitemap"`

        - `"feed-rss"`

        - `"crawl"`

      - `store_options: Optional[SourceParamsWebCrawlerStoreOptions]`

        - `storage_id: str`

        - `r2_jurisdiction: Optional[str]`

        - `storage_type: Optional[Provider]`

          - `"r2"`

  - `status: Optional[str]`

  - `token_id: Optional[str]`

  - `type: Optional[Literal["r2", "web-crawler"]]`

    - `"r2"`

    - `"web-crawler"`

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
instance = client.aisearch.instances.update(
    id="my-ai-search",
    account_id="c3dc5f0b34a14ff8e1b3ec04895e1b22",
)
print(instance.id)
```

#### Response

```json
{
  "result": {
    "id": "my-ai-search",
    "created_at": "2019-12-27T18:11:19.117Z",
    "modified_at": "2019-12-27T18:11:19.117Z",
    "ai_gateway_id": "ai_gateway_id",
    "ai_search_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
    "cache": true,
    "cache_threshold": "super_strict_match",
    "chunk_overlap": 0,
    "chunk_size": 64,
    "created_by": "created_by",
    "custom_metadata": [
      {
        "data_type": "text",
        "field_name": "x"
      }
    ],
    "embedding_model": "@cf/qwen/qwen3-embedding-0.6b",
    "enable": true,
    "engine_version": 0,
    "fusion_method": "max",
    "hybrid_search_enabled": true,
    "indexing_options": {
      "keyword_tokenizer": "porter"
    },
    "last_activity": "2019-12-27T18:11:19.117Z",
    "max_num_results": 1,
    "metadata": {
      "created_from_aisearch_wizard": true,
      "worker_domain": "worker_domain"
    },
    "modified_by": "modified_by",
    "namespace": "x",
    "paused": true,
    "public_endpoint_id": "public_endpoint_id",
    "public_endpoint_params": {
      "authorized_hosts": [
        "string"
      ],
      "chat_completions_endpoint": {
        "disabled": true
      },
      "enabled": true,
      "mcp": {
        "description": "description",
        "disabled": true
      },
      "rate_limit": {
        "period_ms": 60000,
        "requests": 1,
        "technique": "fixed"
      },
      "search_endpoint": {
        "disabled": true
      }
    },
    "reranking": true,
    "reranking_model": "@cf/baai/bge-reranker-base",
    "retrieval_options": {
      "boost_by": [
        {
          "field": "timestamp",
          "direction": "desc"
        }
      ],
      "keyword_match_mode": "and"
    },
    "rewrite_model": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
    "rewrite_query": true,
    "score_threshold": 0,
    "source": "source",
    "source_params": {
      "exclude_items": [
        "/admin/**",
        "/private/**",
        "**\\temp\\**"
      ],
      "include_items": [
        "/blog/**",
        "/docs/**/*.html",
        "**\\blog\\**.html"
      ],
      "prefix": "prefix",
      "r2_jurisdiction": "r2_jurisdiction",
      "web_crawler": {
        "crawl_options": {
          "depth": 1,
          "include_external_links": true,
          "include_subdomains": true,
          "max_age": 0,
          "source": "all"
        },
        "parse_options": {
          "content_selector": [
            {
              "path": "**/blog/**",
              "selector": "article .post-body"
            }
          ],
          "include_headers": {
            "foo": "string"
          },
          "include_images": true,
          "specific_sitemaps": [
            "https://example.com/sitemap.xml",
            "https://example.com/blog-sitemap.xml"
          ],
          "use_browser_rendering": true
        },
        "parse_type": "sitemap",
        "store_options": {
          "storage_id": "storage_id",
          "r2_jurisdiction": "r2_jurisdiction",
          "storage_type": "r2"
        }
      }
    },
    "status": "status",
    "token_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "type": "r2"
  },
  "success": true
}
```