# Cloudflare — API Agent Score

> Score: 73/100 (Grade: B) | Domain: cloudflare.com | Rubric: 1.0.0 | Checked: July 24, 2026

Cloudflare scored 73/100 (B), classified "partially-ready".

[View full report](https://www.postman.com/ai/ai-ready-apis/company/cloudflare)
[All organizations](https://www.postman.com/ai/ai-ready-apis/llms.txt)

## Summary

- Overall: 73/100 (B)
- Classification: partially-ready

## Category Scores

- API Design: 84/100 (A)
- Developer Experience: 49/100 (F)
- Agent Discovery: 95/100 (A+)
- Agent Understanding: 75/100 (B)
- Agent Usability: 63/100 (C)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="4.0.0") and url-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [warn] Schema coverage & depth — Max schema nesting depth: 9 (9-14 = medium). Investigated: spec 67%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 50%.
- [fail] Example coverage — 38% example coverage. Investigated: spec 0%, docs 0%.

### Developer Experience

- [pass] Description completeness — 63% description completeness (target 90%+). Investigated: spec 100%.
- [pass] Changelog published — changelog documented in the docs site at https://developers.cloudflare.com/changelog/. Investigated: spec 100%, docs 100%, sdk 100%.
- [fail] Self-service developer portal — No signup page detected across conventional paths (/signup, /sign-up, /register, /get-started, /console/signup, /dashboard/signup, /try, /try-free, /free, /free-trial, /start, /start-free). Investigated: docs 0%.
- [fail] Quickstart present — No quickstart/getting-started page found at the conventional paths. Investigated: docs 0%.
- [fail] Code samples in docs — No detectable code samples across 20 sampled docs pages. Investigated: docs 0%.

### Agent Discovery

- [pass] Docs reachable, not hard auth-gated — All 50 sampled pages are publicly accessible. Investigated: docs 100%.
- [pass] Registry & SDK presence — Indexed on Context7 (cloudflare/cloudflare-docs, 77741 snippets). Investigated: docs 100%, sdk 100%, cli 0%, mcp 0%, wellknown 0%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 5873/8108 sitemap doc pages (72%); 2235 missing; 197 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap). Investigated: docs 81%.
- [pass] Crawlable / AEO — Docs paths crawlable by all monitored AI agents. Investigated: wellknown 100%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — 17 distinct 4xx/5xx response codes documented. Investigated: docs 100%, spec 50%.
- [pass] Operation purpose clarity — 99% of operations have a clear summary + operationId an agent can select on. Investigated: spec 100%.
- [warn] Agent-navigable, token-efficient docs — 1 of 50 pages have substantive content differences between markdown and HTML (avg 3% missing). Investigated: docs 56%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [fail] Docs structured data — Neither JSON-LD nor OpenGraph/meta tags detected across 3 assessed pages (3 JS-rendered). Investigated: docs 0%.
- [skip] Description consistency across surfaces — Only 1 surface description(s) with ≥6 tokens available; need at least 2 to compare.

### Agent Usability

- [pass] Pagination documented & consistent — Pagination params detected on 31 list endpoint(s). Investigated: spec 100%, docs 100%.
- [pass] Sandbox separation — sandbox documented in the docs site at https://developers.cloudflare.com/sandbox/. Investigated: spec 100%, docs 100%.
- [warn] Rate-limit signaling — Only 1 rate-limit header(s) documented. Investigated: spec 50%, docs 50%.
- [fail] Idempotency documented — 0% of mutating operations document idempotency. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

Cloudflare's API program shows strong discoverability and schema quality, but two areas are putting partner adoption at risk. Developer onboarding is the most urgent gap: partners have no self-service portal, no quickstart, and no embedded code samples — meaning first contact requires significant effort before a single API call is made. Agent readiness is the second critical weakness: without an agent instructions file, structured doc markup, runnable collections with test scripts, or idempotency guidance, AI agents building on Cloudflare's APIs must guess at context and workflow safety. Prioritize establishing a self-service onboarding surface with real code examples first, then systematically close the agent-context gaps so partners and their agents can integrate confidently and autonomously.