Cloudflare
@Cloudflare
Cloudflare now returns RFC 9457-compliant structured Markdown and JSON error payloads to AI agents, replacing heavyweight HTML pages with machine-readable instructions. https://t.co/h5toc5NOVt
18retweets
View on XCloudflare Serves AI Agents Structured Error Responses, Cutting Token Use 98%
ยท Updated
Cloudflare now returns RFC 9457-compliant structured error responses across its network, replacing HTML error pages that gave AI agents no actionable guidance. When an agent sends
Accept: text/markdown, Accept: application/json, or Accept: application/problem+json and hits a Cloudflare error, it receives a compact payload with stable fields: error_code, error_category, retryable, retry_after, and owner_action_required. All 1xxx-class errors are covered today, with 4xx and 5xx support coming next.Measured against a live 1015 rate-limit error, Markdown responses use 64.5x fewer tokens than HTML; JSON uses 55.7x fewer. For agents running multi-step workflows, those savings compound. The bigger shift is semantic โ agents read a stable policy contract instead of scraping HTML markup, enabling deterministic retry and escalation logic.
Add the appropriate Accept header to your agent's HTTP client at any Cloudflare-proxied endpoint โ structured responses activate automatically. Site owners configure nothing; browsers keep the existing HTML experience.
