← All breaking-change reports

Cloudflare API breaking change: path-removed on /accounts/{account_id}/ai/run/@cf/baai/ray-bge-large-en-v1.5

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/baai/ray-bge-large-en-v1.5

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/baai/ray-bge-large-en-v1.5' with the canonical slug '@cf/baai/bge-large-en-v1.5' 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 scan --repo .

How to fix it

Migration path:

Mechanical slug rewrite at every call site that runs this Workers AI model: replace the removed model slug '@cf/baai/ray-bge-large-en-v1.5' with the canonical slug '@cf/baai/bge-large-en-v1.5' 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/baai/ray-bge-large-en-v1.5', { text: input });

After:

await env.AI.run('@cf/baai/bge-large-en-v1.5', { text: input });

Replacement data source: the same model remains served at /accounts/{account_id}/ai/run/@cf/baai/bge-large-en-v1.5

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.