← All breaking-change reports

Cloudflare API breaking change: path-removed on /zones/{zone_id}/ssl/recommendation

cloudflare · breaking · 2026-07-27 · source: OpenAPI spec diff

What changed

According to the OpenAPI spec diff (cloudflare/cloudflare-oas-7abe88500e55-to-c92b9b0fde23-removals), the following surface changed:

path-removed: /zones/{zone_id}/ssl/recommendation

cloudflare OAS corridor pair 7abe88500e55 -> c92b9b0fde23 (client-breaking removals subset ingested 2026-08-01)

Who is affected

No direct replacement route exists in the NEW spec.

To find out whether your repo is hit — file and line number, no code leaving your machine:

npx mendapi scan --repo .

How to fix it

Migration path:

No direct replacement route exists in the NEW spec. Remove or feature-flag the call to '/zones/{zone_id}/ssl/recommendation' (get) and handle the missing capability explicitly. No recommendation-style SSL route remains in NEW; /zones/{zone_id}/ssl/verification (present in both OLD and NEW) serves certificate verification state, not mode recommendations.

Before:

await cf.request('/zones/{zone_id}/ssl/recommendation');

After:

// endpoint discontinued upstream; call removed (see migration guide)

Replacement data source: No recommendation-style SSL route remains in NEW; /zones/{zone_id}/ssl/verification (present in both OLD and NEW) serves certificate verification state, not mode recommendations.

With your own LLM key configured (BYO compute — mendapi never proxies your credentials), npx mendapi llmfix turns this guide into a reviewable draft patch for your repo.

Detected and tracked by mendapi — Dependabot for every API you depend on. Scans run locally; your code never leaves your machine.

Related

Change data is recorded from upstream provider releases, changelogs and OpenAPI spec diffs; every article names its source.