Skip to content

Add changelog: legacy Tunnel routes and connections API endpoints retiring Oct 5, 2026#31879

Open
nikitacano wants to merge 3 commits into
productionfrom
ncano/tunnel-routes-connections-api-deprecation
Open

Add changelog: legacy Tunnel routes and connections API endpoints retiring Oct 5, 2026#31879
nikitacano wants to merge 3 commits into
productionfrom
ncano/tunnel-routes-connections-api-deprecation

Conversation

@nikitacano

Copy link
Copy Markdown
Contributor

Summary

Adds a Cloudflare Tunnel changelog entry announcing two related API deprecations, both effective October 5, 2026:

  1. Legacy route endpoints removed. The CIDR-encoded route endpoints (POST/PATCH/DELETE /accounts/{account_id}/teamnet/routes/network/{ip_network_encoded}) are removed in favor of the existing route_id-based endpoints (POST /accounts/{account_id}/teamnet/routes, PATCH/DELETE /accounts/{account_id}/teamnet/routes/{route_id}).
  2. connections field removed from list/get responses. Cloudflare Tunnel (cfd_tunnel) and Cloudflare Mesh (warp_connector) list and get endpoints no longer return the connections array. Callers should use the dedicated .../connections endpoints instead.

The entry includes a before/after comparison table, migration steps, curl examples, guidance for cloudflared and the cloudflare_zero_trust_tunnel_route Terraform resource, and links to the relevant API reference pages. Endpoint paths, method pages, and Terraform resource names were verified directly against the live API reference before writing.

Documentation checklist

  • Is there a changelog entry? — this PR is the changelog entry.
  • The change adheres to the documentation style guide (follows the deprecated-APIs content type: exact end-of-life date, replacement endpoint, context).
  • N/A — no new page, no issue needed.
  • N/A — no files renamed or moved.

@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/product-owners

@ask-bonk ask-bonk Bot added changelog Adds or updates changelog entries/pages. product:cloudflare-tunnel labels Jul 3, 2026

@ask-bonk ask-bonk Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verdict: 2 style guide issues to address before merge.

Issues:

  • MEDIUM (line 98): Heading uses contraction "we're" — style guide prohibits all contractions.
  • LOW (line 11): Directional language "below" — style guide prohibits "above" / "below" in prose.

Posted 2 inline suggestions.

@ask-bonk

ask-bonk Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Review completed for PR #31879.

Summary: This PR adds a changelog entry announcing two Cloudflare Tunnel / Mesh API deprecations effective October 5, 2026:

  1. Retirement of CIDR-encoded route endpoints in favor of route_id-based endpoints.
  2. Removal of the connections array from Tunnel and Mesh list/get responses, with callers directed to dedicated .../connections endpoints.

The entry includes migration steps, before/after curl examples, and guidance for cloudflared and Terraform users. pnpm run check passed with no errors.

Labels applied: changelog, product:cloudflare-tunnel

Issues flagged (2 inline suggestions posted):

  • MEDIUM (line 98): Heading ## Why we're making these changes uses a contraction — the style guide prohibits all contractions.
  • LOW (line 11): Phrase "review the changes below" uses directional language — the style guide prohibits "above"/"below" in prose.

No build breakers or technical inaccuracies found.

github run

@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Review

✅ No issues found in commit 8e1a58b.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

No code review issues found.

Conventions

Checks PR title, description, and redirect checklist.

No convention issues found.

Style Guide Review

No style-guide issues found.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.

@nikitacano nikitacano enabled auto-merge (squash) July 6, 2026 11:16
@nikitacano nikitacano force-pushed the ncano/tunnel-routes-connections-api-deprecation branch from b8e509e to e5f35d1 Compare July 6, 2026 13:53
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

CI run failed: build logs

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Broken Links

Found 4 broken link(s) across 3 file(s).

File Link Position Error
workers/cache/cache-keys.mdx /workers/configuration/versions-and-deployments/gradual-deployments/ 65:12 invalid link
workers/cache/configuration.mdx /workers/configuration/versions-and-deployments/gradual-deployments/ 117:15 invalid link
workers/cache/configuration.mdx /workers/configuration/versions-and-deployments/gradual-deployments/ 147:428 invalid link
workers/cache/index.mdx /workers/configuration/previews/ 212:3 invalid link

nikitacano and others added 3 commits July 6, 2026 16:50
…iring Oct 5, 2026

Announces two related API changes taking effect October 5, 2026:
- CIDR-encoded route create/update/delete endpoints
  (POST|PATCH|DELETE /accounts/{account_id}/teamnet/routes/network/{ip_network_encoded})
  are removed in favor of the existing route_id-based endpoints.
- The connections field is removed from Cloudflare Tunnel (cfd_tunnel) and
  Cloudflare Mesh (warp_connector) list/get responses; callers should use the
  dedicated .../connections endpoints instead.

Includes migration steps, before/after curl examples, cloudflared and
Terraform (cloudflare_zero_trust_tunnel_route) guidance, and links to the
relevant API reference pages.
Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
@nikitacano nikitacano force-pushed the ncano/tunnel-routes-connections-api-deprecation branch from e5f35d1 to 8e1a58b Compare July 6, 2026 15:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant