AI Search: improve API error responses

[G4brym]

Changes

• Document specific AI Gateway client errors
• Document stricter instance search and web-source validation

[cloudflare-docs-bot]

Review

✅ No issues found in commit 0defe53.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

_{No code review issues found.}

Conventions

_{No convention issues found.}

Style Guide Review

_{No style-guide issues found.}

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command	Description
/review	Runs a review now. Incremental if a prior review exists, full if not.
/full-review	Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit	Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review	Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.

[github-actions]

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
/src/content/changelog/ai-search/	@cloudflare/pm-changelogs, @rita3ko, @irvinebroque, @aninibread, @mchenco, @cloudflare/product-owners

[github-actions]

Preview URL: https://0defe53a.preview.developers.cloudflare.com
Preview Branch URL: https://ai-search-config-api-error-responses-rag-1186.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/changelog/post/2026-07-19-api-error-responses/	https://ai-search-config-api-error-responses-rag-1186.preview.developers.cloudflare.com/changelog/post/2026-07-19-api-error-responses/