Skip to content

[Version Management] Update API limitation, fix troubleshooting page, add code owner #31804

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ngayerie merged 3 commits into from
Jun 30, 2026
Merged

[Version Management] Update API limitation, fix troubleshooting page, add code owner #31804

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
9016f8b
Update Version Management API limitation and add code owner
ngayerie Jun 30, 2026
2e46c2b
Fix subject-verb agreement (is -> are)
ngayerie Jun 30, 2026
dcf481d
Update troubleshooting to reflect public Environments API
ngayerie Jun 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/CODEOWNERS
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@ package.json @cloudflare/content-engineering
/src/content/docs/tenant/ @jhutchings1 @cloudflare/product-owners
/src/content/docs/terraform/ @jhutchings1 @cloudflare/product-owners
/src/content/docs/version-management/ @jhutchings1 @cloudflare/product-owners
/src/content/partials/version-management/ @jhutchings1 @cloudflare/product-owners

# Billing

Expand Down
8 changes: 2 additions & 6 deletions src/content/docs/version-management/troubleshooting.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,13 +94,9 @@ To avoid this:
- Deploy Workers using Wrangler before creating new versions that reference the same routes.
- Avoid configuring the same custom domains across multiple versions.

## API and Terraform are not supported
## Terraform is not supported

Version Management does not currently expose a public API. You can only manage versions through the [Cloudflare dashboard](https://dash.cloudflare.com/).

[Terraform](/terraform/) is also not supported. If you currently use Terraform to manage your zone configuration, you should choose either Terraform or Version Management — using both simultaneously is not supported.

If you receive a `10001` authentication error when attempting to access Version Management endpoints through the API, this is expected behavior. There is no public API available at this time.
[Terraform](/terraform/) is not supported by Version Management. If you currently use Terraform to manage your zone configuration, you should choose either Terraform or Version Management — using both simultaneously is not supported.

## Analytics discrepancies

Expand Down
4 changes: 2 additions & 2 deletions src/content/partials/version-management/product-limitations.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,8 +50,8 @@ Version Management does not currently support or have limited support for the fo

<Details header="Cloudflare API">

- Version Management does not currently expose a public [API](/api/).
- Customers can only use Version Management through the [Cloudflare dashboard](https://dash.cloudflare.com/).
- Version Management environments — including their routing expressions and version assignments — can be managed through the public [Environments API](/api/resources/zones/subresources/environments/).
- Creating, cloning, and editing zone versions (the configuration snapshots themselves) are currently only available through the [Cloudflare dashboard](https://dash.cloudflare.com/).

</Details>

Expand Down