Cloudflare is now returning RFC 9457-compliant structured Markdown and JSON error payloads to AI agents, replacing verbose HTML error pages with machine-readable instructions. This significantly reduces payload size and token usage โ by over 98% in measured tests โ which is crucial for cost-effective AI agent operation. The new responses include actionable guidance, allowing agents to understand *why* an error occurred and *how* to proceed, whether that means retrying with backoff, escalating the issue, or stopping altogether.
This is a network-wide change, automatically available without any site owner configuration.
- `Accept: text/markdown` returns a yaml header and human readable markdown
- `Accept: application/json` returns JSON
- `Accept: application/problem+json` returns JSON with the `application/problem+json` content type.