Skip to content

chore(dev-portal): Fix v3 domain change date wording #3035

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

chore(dev-portal): Fix v3 domain change date wording #3035

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
2 changes: 1 addition & 1 deletion app/_landing_pages/dev-portal.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ rows:
- type: text
text: |
{:.warning}
> **Review domain breaking changes for Dev Portal v3 and migrate to the new domain before October 1, 2025.** [Review breaking changes](/dev-portal/breaking-changes/)
> [Review domain breaking changes for Dev Portal v3](/dev-portal/breaking-changes/)

- columns:
- blocks:
Expand Down
8 changes: 4 additions & 4 deletions app/dev-portal/breaking-changes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ With the GA release of the new Dev Portal (v3) in June 2025, some features and A

## Dev Portal default domain names

During Tech Preview and Beta, new Dev Portals were served on `https://{portalId}.edge.{geo}.portal.konghq.tech`. The `https://{portalId}.edge.{geo}.portal.konghq.tech` domain name will be discontinued on October 1, 2025 in favor of the `https://{portalId}.{geo}.kongportals.com` domain. During the transition period from Dev Portal v3 release to October 2025, both domain names will be served, but Kong recommends updating your domain names to the new naming convention during the transition period.
During Tech Preview and Beta, new Dev Portals were served on `https://{portalId}.edge.{geo}.portal.konghq.tech`. The `https://{portalId}.edge.{geo}.portal.konghq.tech` domain name was discontinued on October 1, 2025 in favor of the `https://{portalId}.{geo}.kongportals.com` domain. During the transition period from Dev Portal v3 release to October 2025, both domain names will be served, but Kong recommends updating your domain names to the new naming convention during the transition period.

You must update Dev Portal domain names everywhere they are referenced, including the following:

Expand All @@ -39,7 +39,7 @@ You must update Dev Portal domain names everywhere they are referenced, includin

## Migrate your custom domain

If you're using a [custom domain](/dev-portal/custom-domains/) that hasn't been migrated to the new DNS zone yet, you must follow additional migration steps. The new DNS zone is available concurrently with the old DNS zone until October 1, 2025. On October 1, 2025, the old DNS zone will be deactivated and custom domains that haven't been migrated will stop working.
If you're using a [custom domain](/dev-portal/custom-domains/) that hasn't been migrated to the new DNS zone yet, you must follow additional migration steps. The old DNS zone is no longer available as of October 1, 2025. On October 1, 2025, the old DNS zone was deactivated and custom domains that haven't been migrated will stop working.

### Dev Portal custom domain migration steps

Expand All @@ -62,12 +62,12 @@ Review the following Dev Portal breaking changes and make any necessary updates

### API specifications deprecated in favor of API versions

The [API specification endpoint](/api/konnect/api-builder/v3/#/operations/create-api-spec) is being deprecated on October 1, 2025 in favor of the [API versions endpoint](/api/konnect/api-builder/v3/#/operations/create-api-version).
The [API specification endpoint](/api/konnect/api-builder/v3/#/operations/create-api-spec) was deprecated on October 1, 2025 in favor of the [API versions endpoint](/api/konnect/api-builder/v3/#/operations/create-api-version).
Moving to the `/apis/{id}/versions` endpoints allows you to support additional versions of a spec.
Existing automation with specifications operations should work in parallel during this transition.
Each existing specification will be mapped one-to-one with a wrapping version entity.

The following `/apis/{id}/specifications` endpoints will be deprecated on October 1, 2025 and replaced with `/apis/{id}/versions` endpoints:
The following `/apis/{id}/specifications` endpoints were deprecated on October 1, 2025 and replaced with `/apis/{id}/versions` endpoints:

{% table %}
columns:
Expand Down
3 changes: 0 additions & 3 deletions app/dev-portal/custom-domains.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,9 +55,6 @@ faqs:
Ensure that the DNS records are public as it will not work with private DNS records.
---

{:.warning}
> **Dev Portal v3 domain breaking changes:** [Review custom domain breaking changes](/dev-portal/breaking-changes/#migrate-your-custom-domain) for Dev Portal v3 and migrate to the new domain before October 1, 2025.

Every Dev Portal instance has an auto-generated default URL. You can also manage custom URLs within {{site.konnect_short_name}}.
This gives users the ability to access the Dev Portal from either the default URL, for example `https://example.{geo}.kongportals.com`, or a custom URL like `portal.example.com`.

Expand Down
Loading