Indexing error codes·续

Models and AI Gateway

These errors appear when embedding models, Workers AI, external providers, or AI Gateway cannot process item content.

Error Details Recommended action
error_embedding_data_with_workers_ai Workers AI could not generate embeddings. Sync the item again. Check Cloudflare Status ↗︎ and contact support if the error persists.
workers_ai_invalid_input Workers AI rejected the input. Check file content, file type, and embedding model support.
workers_ai_free_allocation_exceeded Workers AI free tier allocation was exceeded. Review Workers AI pricing and wait for allocation reset, or upgrade your Workers plan.
workers_ai_internal_error Workers AI returned an internal error. Sync the item again. Check Cloudflare Status ↗︎ and contact support if the error persists.
workers_ai_out_of_capacity_error Workers AI capacity was unavailable. Retry later and review Workers AI limits.
workers_ai_timeout_error Workers AI timed out. Sync the item again. Check Cloudflare Status ↗︎ and contact support if the error persists.
error_external_model_unknown_error An external embedding model returned an unknown error. Check provider status and AI Gateway logs, then sync the item again.
error_external_model_rate_limited An external embedding model rate limited the request. Run a source sync job later, or raise the rate limit with your model provider. Check AI Gateway logs for the provider response.
error_external_model_unauthorized An external embedding model rejected authentication. Check provider credentials in AI Gateway, then sync the item again.
ai_gateway_request_blocked_firewall AI Gateway Guardrails blocked the request. Review AI Gateway Guardrails prompt settings for the configured gateway, then run a source sync job again.
ai_gateway_dlp_blocked AI Gateway Data Loss Prevention (DLP) blocked content. Review AI Gateway DLP settings and the item content.
ai_gateway_response_blocked_firewall AI Gateway Guardrails blocked the response. Review AI Gateway Guardrails response settings for the configured gateway, then run a source sync job again.
ai_gateway_rate_limited AI Gateway rate limited the request. Run a source sync job later. If the error persists, contact support.

Storage and Vectorize

These errors appear when storing or indexing an item fails, or when the instance reaches a capacity limit. AI Search uses Vectorize in the background to store vectors and manages it for you.

Error Details Recommended action
r2_unknown_error R2 returned an unknown error. Run a source sync job again. Check Cloudflare Status ↗︎ and contact support if the error persists.
r2_internal_error R2 returned an internal error. Run a source sync job again. Check Cloudflare Status ↗︎ and contact support if the error persists.
vectorize_rate_limited Vectorize rate limited the operation. Run a source sync job later. If the error persists, contact support.
vectorize_ingestion_timeout Vectorize did not process the mutation in time. Sync the item again. Check Cloudflare Status ↗︎ and contact support if the error persists.
vectorize_upstream_error Vectorize returned a transient upstream error. Sync the item again. Check Cloudflare Status ↗︎ and contact support if the error persists.
hybrid_search_indexing_failed Hybrid search indexing failed. Sync the item again. Check Cloudflare Status ↗︎ and contact support if the error persists.
ai_search_is_full The AI Search instance is full. Unlike a full hybrid search index, this does not pause the instance. Request a higher limit ↗︎ for the instance, or create another instance to index additional content. See limits.

Instance-level errors

These errors pause the whole instance and stop all indexing until the underlying cause is resolved and the instance is resumed. They are distinct from a manual pause or the automatic pause after a period of inactivity.

Error Details Recommended action
r2_not_enabled Pauses the instance. R2 is not enabled for the account. Enable R2 for the account, then resume the instance.
bucket_not_found Pauses the instance. The source R2 bucket was not found. Check the R2 data source bucket name and account, then resume the instance.
bucket_unauthorized Pauses the instance. AI Search cannot access the R2 bucket. Check the service API token and R2 bucket permissions, then resume the instance.
external_source_missing_api_token Pauses the instance. The external source is missing API credentials. Add or update the service API token, then resume the instance.
bucket_name_invalid Pauses the instance. The R2 bucket name is invalid. Use a valid bucket name without uppercase letters or underscores, update the R2 data source, then resume the instance.
invalid_custom_header Pauses the instance. A custom crawl header is invalid. Remove or update the authentication header, then resume the instance.
ai_gateway_not_configured Pauses the instance. The AI Gateway set on the instance was not found. Update the instance's ai_gateway_id to an existing gateway in AI Gateway, then resume the instance.
hybrid_search_is_full Pauses the instance. The hybrid search index is full. Its file limit is lower than the standard instance limit, so it can be reached earlier. Request a higher limit ↗︎ to resume the instance, or create another instance to index additional content. See limits.

Was this helpful?

YesNo

On this page

Indexing error codes·续 - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/ai-search/troubleshooting/indexing-error-codes/#page","headline":"Indexing error codes","description":"Resolve asynchronous indexing, sync, and crawl error codes.","url":"https://developers.cloudflare.com/ai-search/troubleshooting/indexing-error-codes/","inLanguage":"en","image":"https://developers.cloudflare.com/ai-search/troubleshooting/indexing-error-codes/og.png?v=656b5c81e6d85cf6","dateModified":"2026-10-01","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

Skip to content

API Reference

Copy Markdown

Open in ClaudeOpen in ChatGPTOpen in Cursor

Copy MarkdownView as Markdown