← All breaking-change reports

Cloudflare API breaking change: path-removed on /accounts/{account_id}/ai-search/instances/{id}/items/{item_id}

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-search/instances/{id}/items/{item_id}

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

Who is affected

Delete the dead read at every call site: the items listing GET now 404s.

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:

Delete the dead read at every call site: the items listing GET now 404s. Removing the request and the code that consumes its response is the mechanical mend; if the caller needs ingestion visibility, the jobs/logs/stats routes still expose corpus processing state, but selecting which to adopt is a product decision outside the codemod.

Before:

const item = await cf.get(`/accounts/${acct}/ai-search/instances/${id}/items/${itemId}`);

After:

// GET .../items/{item_id} was removed upstream; dead read deleted.
// Per-document status is now observed via the job logs endpoint.

Replacement data source: instance ingestion state is still observable through the remaining /ai-search/instances/{id}/jobs, /jobs/{job_id}/logs and /stats routes in the NEW spec

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.