Skip to content

do not merge - [Sandboxes] Document the new tunnels API#30981

Open
mvvmm wants to merge 6 commits into
productionfrom
vance/test-flue-review
Open

do not merge - [Sandboxes] Document the new tunnels API#30981
mvvmm wants to merge 6 commits into
productionfrom
vance/test-flue-review

Conversation

@mvvmm
Copy link
Copy Markdown
Contributor

@mvvmm mvvmm commented May 20, 2026

Summary

This adds a new Tunnels page to the Sandbox documents that covers the new sandbox.tunnels interface recently added to the SDK. This gives an API reference as well as updating existing locations that reference exposePort() to point to the new API.

Currently Cloudflare Tunnels have limited use and need to exist next to exposePort() while we work on the remaining functionality. I've tried to capture this in the Preview URLs document.

Note: This is a test PR for the flue AI code review system.

Documentation checklist

  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.

@github-actions
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/docs/sandbox/ @whoiskatrin, @ghostwriternr, @cloudflare/product-owners, @cloudflare/ai-agents

@mvvmm
Copy link
Copy Markdown
Contributor Author

mvvmm commented May 20, 2026

(Testing some agent stuff - do not merge)

ask-bonk[bot]

This comment was marked as duplicate.

@ask-bonk ask-bonk Bot added documentation Documentation edits content:new Request for new/missing content labels May 20, 2026
@mvvmm mvvmm changed the title [Sandboxes] Document the new tunnels API do not merge - [Sandboxes] Document the new tunnels API May 20, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 20, 2026

Preview URL: https://adca0488.preview.developers.cloudflare.com
Preview Branch URL: https://vance-test-flue-review.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/sandbox/api/tunnels/ https://vance-test-flue-review.preview.developers.cloudflare.com/sandbox/api/tunnels/
https://developers.cloudflare.com/sandbox/concepts/preview-urls/ https://vance-test-flue-review.preview.developers.cloudflare.com/sandbox/concepts/preview-urls/
https://developers.cloudflare.com/sandbox/concepts/security/ https://vance-test-flue-review.preview.developers.cloudflare.com/sandbox/concepts/security/
https://developers.cloudflare.com/sandbox/api/ https://vance-test-flue-review.preview.developers.cloudflare.com/sandbox/api/
https://developers.cloudflare.com/sandbox/api/ports/ https://vance-test-flue-review.preview.developers.cloudflare.com/sandbox/api/ports/
https://developers.cloudflare.com/sandbox/get-started/ https://vance-test-flue-review.preview.developers.cloudflare.com/sandbox/get-started/
https://developers.cloudflare.com/sandbox/guides/expose-services/ https://vance-test-flue-review.preview.developers.cloudflare.com/sandbox/guides/expose-services/
https://developers.cloudflare.com/sandbox/guides/production-deployment/ https://vance-test-flue-review.preview.developers.cloudflare.com/sandbox/guides/production-deployment/
https://developers.cloudflare.com/sandbox/guides/websocket-connections/ https://vance-test-flue-review.preview.developers.cloudflare.com/sandbox/guides/websocket-connections/
https://developers.cloudflare.com/sandbox/concepts/ https://vance-test-flue-review.preview.developers.cloudflare.com/sandbox/concepts/

@cloudflare cloudflare deleted a comment from cloudflare-docs-bot Bot May 21, 2026
@cloudflare cloudflare deleted a comment from ask-bonk Bot May 21, 2026
@cloudflare cloudflare deleted a comment from cloudflare-docs-bot Bot May 21, 2026
@cloudflare cloudflare deleted a comment from cloudflare-docs-bot Bot May 21, 2026
@cloudflare cloudflare deleted a comment from cloudflare-docs-bot Bot May 21, 2026
@cloudflare cloudflare deleted a comment from cloudflare-docs-bot Bot May 21, 2026
@cloudflare cloudflare deleted a comment from cloudflare-docs-bot Bot May 21, 2026
@cloudflare cloudflare deleted a comment from cloudflare-docs-bot Bot May 21, 2026
@cloudflare cloudflare deleted a comment from cloudflare-docs-bot Bot May 21, 2026
@mvvmm mvvmm force-pushed the vance/test-flue-review branch from 6c2d005 to adca048 Compare May 21, 2026 22:54
@cloudflare-docs-bot
Copy link
Copy Markdown

cloudflare-docs-bot Bot commented May 21, 2026

Review

⚠️ 6 warnings and 2 suggestions found in commit adca048.

Warnings (6)
File Issue
sandbox/concepts/preview-urls.mdx line 11 No H1 in body — Added line: # Quick deployment Fix: Change to ## Quick deployment or remove the heading.
sandbox/concepts/preview-urls.mdx line 13 Use root-relative internal links — The changed line uses https://developers.cloudflare.com/tunnel/ Fix: Change to /tunnel/.
sandbox/concepts/preview-urls.mdx line 32 Do not use directional languagedocumented below Fix: Replace with a specific reference, e.g. documented in the [Production usage, stable URLs and custom domains] section.
sandbox/concepts/preview-urls.mdx line 35 Standard phrasing for cross-referencesSee the [tunnels API reference] Fix: Change to refer to the [tunnels API reference].
sandbox/concepts/preview-urls.mdx line 37 No H1 in body — Added line: # Production usage, stable URLs & custom domains Fix: Change to ## Production usage, stable URLs & custom domains or remove the heading.
sandbox/concepts/security.mdx line 102 Standard phrasing for cross-referencesSee the [Tunnels API] Fix: Change to refer to the [Tunnels API].
Suggestions (2)
File Issue
sandbox/concepts/preview-urls.mdx line 13 Use the Oxford commalocal development, workers.dev and production usage Fix: Change to local development, workers.dev, and production usage.
sandbox/concepts/preview-urls.mdx line 32 Use the Oxford commaproduction deployments, custom hostnames and authentication Fix: Change to production deployments, custom hostnames, and authentication.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content:new Request for new/missing content documentation Documentation edits product:sandbox size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants