Cloudflare API OpenAPI Specification
OpenAPI specification for the Cloudflare REST API (v4).
- “Find Cloudflare API endpoints and request/response shapes”
- “How do I update a DNS record using the Cloudflare API?”
Cloudflare serves an AI Catalog
manifest at /.well-known/ai-catalog.json on developers.cloudflare.com, declaring
4 agentic resources
that a discovery service can index without asking anyone’s permission.
did:web:developers.cloudflare.com —
resolving it returns 404. A did:web: that does not resolve is a string, not an identity, and does not earn the identity affordance here.
/.well-known/ai-catalog.json. ARD v0.91 renamed the path to /.well-known/ard.json and made the old one an optional courtesy, so a consumer implementing only the current spec will not find this manifest.
specVersion in the manifest. 1.0 is current for the AI Catalog data model; anything lower is an earlier draft. ARD reads this field as transport-defined and ignores it.did-web-does-not-resolveOpenAPI specification for the Cloudflare REST API (v4).
Server card listing Cloudflare MCP server endpoints and connection details.
Index of Cloudflare-published agent skills (metadata and download links).
Text index for AI systems: a structured list of Cloudflare docs sections and per-product llms.txt links.
Content-Type: application/json —
no — serves application/ai-catalog+jsonAccess-Control-Allow-Origin: * —
yeshttps://developers.cloudflare.com/.well-known/ai-catalog.json on 2026-09-13, HTTP
200. The verbatim body is stored alongside its manifest in the
Cloudflare repository
as ai-catalog/cloudflare-ai-catalog.json. Nothing on this page is derived
or generated: an AI Catalog manifest is served from the publisher’s own domain or it does not
exist, which makes it — like an
A2A Agent Card — one of the few agent artifacts that cannot be
produced on a provider’s behalf. Grades are recomputed on every build; the specification is a
v0.9 draft and
these verdicts will move when it does.
Every descriptor here is available over the APIs.io API and to AI agents over MCP. Agent Discovery is not yet its own endpoint on the v1 API. Reach it through catalog search and the tag graph, or the MCP server.