← All breaking-change reports

Cloudflare API breaking change: path-removed on /accounts/{account_id}/ai/run/@cf/google/omni-embeddinggemma-300m

cloudflare · breaking · 2026-03-31 · source: OpenAPI spec diff

What changed

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

path-removed: /accounts/{account_id}/ai/run/@cf/google/omni-embeddinggemma-300m

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

Who is affected

Mechanical slug rewrite at every call site that runs this Workers AI model: replace the removed model slug '@cf/google/omni-embeddinggemma-300m' with the canonical slug '@cf/google/embeddinggemma-300m' in the ai/run URL (raw fetch callers) or in the model-name argument passed to env.AI.run / the SDK ai.run helper.

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

npx mendapi sync  # the one network call: fetch the change feed
npx mendapi scan --repo .  # local scan, nothing leaves your machine

How to fix it

mendapi ships a deterministic migration pack for this change (cloudflare-workers-ai-model-slug-renames). Preview the patch locally (dry-run is the default; nothing is modified without --apply):

npx mendapi fix --repo . --migration cloudflare-workers-ai-model-slug-renames

The pack is idempotent, gold-regression tested, and safe on partially migrated code.

What the migration does:

Mechanical slug rewrite at every call site that runs this Workers AI model: replace the removed model slug '@cf/google/omni-embeddinggemma-300m' with the canonical slug '@cf/google/embeddinggemma-300m' in the ai/run URL (raw fetch callers) or in the model-name argument passed to env.AI.run / the SDK ai.run helper. Request and response schemas for the canonical route are unchanged between the two specs, so no payload edits are needed; this is a one-token rename per call site.

Before:

await env.AI.run('@cf/google/omni-embeddinggemma-300m', { text: input });

After:

await env.AI.run('@cf/google/embeddinggemma-300m', { text: input });

Replacement data source: the same model remains served at /accounts/{account_id}/ai/run/@cf/google/embeddinggemma-300m

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.