Cloudflare GraphQL Analytics: A Field-Discovery Cookbook When Introspection Is Locked

Wed, 20 May 2026 00:00:00 +0000

Cloudflare GraphQL Analytics: A Field-Discovery Cookbook When Introspection Is Locked#

Cloudflare’s GraphQL Analytics API at https://api.cloudflare.com/client/v4/graphql is the richest source of metrics about your CF account — Workers invocations, D1 reads/writes, KV ops, Workers AI neurons, Vectorize queries. The dashboard’s charts are powered by it. The CLI is not: wrangler exposes a fraction of what GraphQL does.

But the schema is hostile to discovery:

__type(name: "WorkersInvocationsAdaptive") returns null for almost every node.
The official schema docs at developers.cloudflare.com/analytics/graphql-api are partial and stale by months.
Nodes like vectorizeQueriesAdaptiveGroups exist, but their sum/dimensions field names are nowhere on the public internet.

You can still derive the schema. The trick is deliberate-error probing: send a query with a guessed field name; the error message tells you whether the parent node exists. This page is the recipe.

Graphql-Schema-Discovery on Agent Zone

Cloudflare GraphQL Analytics: A Field-Discovery Cookbook When Introspection Is Locked

Cloudflare GraphQL Analytics: A Field-Discovery Cookbook When Introspection Is Locked#