diff --git a/src/content/vintage/advanced/cluster-management/high-availability/control-plane/index.md b/src/content/vintage/advanced/cluster-management/high-availability/control-plane/index.md
index 92eb522c37..7b61509443 100644
--- a/src/content/vintage/advanced/cluster-management/high-availability/control-plane/index.md
+++ b/src/content/vintage/advanced/cluster-management/high-availability/control-plane/index.md
@@ -109,7 +109,7 @@ Check the reference for the `--master-ha` flag.
 
 ### Via the REST API {#rest-api}
 
-Check the [v5 cluster modification API reference](/api/#operation/modifyClusterV5)
+Check the [v5 cluster modification API reference](https://giantswarm.github.io/api-spec/#operation/modifyClusterV5)
 to find out how to convert a cluster programmatically using the Giant Swarm REST API.
 
 ### Via the Management API {#management-api}
diff --git a/src/content/vintage/advanced/cluster-management/high-availability/multi-az/index.md b/src/content/vintage/advanced/cluster-management/high-availability/multi-az/index.md
index f04ef24317..d418aaa96b 100644
--- a/src/content/vintage/advanced/cluster-management/high-availability/multi-az/index.md
+++ b/src/content/vintage/advanced/cluster-management/high-availability/multi-az/index.md
@@ -113,7 +113,7 @@ You can create clusters in several ways:
 
 - In the [web interface]({{< relref "/vintage/platform-overview/web-interface/" >}}).
 - In `gsctl` using the [`create cluster`]({{< relref "/vintage/use-the-api/gsctl/create-cluster" >}}) command with the appropriate details set in a [cluster definition]({{< relref "/vintage/use-the-api/gsctl/cluster-definition" >}}).
-- Via the [Giant Swarm REST API](/api/#operation/addCluster).
+- Via the [Giant Swarm REST API](https://giantswarm.github.io/api-spec/#operation/addCluster).
 
 When inspecting details of such a cluster, or using the [`gsctl show cluster`]({{< relref "/vintage/use-the-api/gsctl/show-cluster" >}}) command, we display the list of availability zones used by the cluster.
 
diff --git a/src/content/vintage/advanced/cluster-management/node-pools-vintage/index.md b/src/content/vintage/advanced/cluster-management/node-pools-vintage/index.md
index 675655f9b3..223cb19920 100644
--- a/src/content/vintage/advanced/cluster-management/node-pools-vintage/index.md
+++ b/src/content/vintage/advanced/cluster-management/node-pools-vintage/index.md
@@ -169,12 +169,12 @@ with homogeneous worker nodes. To account for this need, we introduced a new API
 
 Using the v5 API endpoints, you can
 
-- [Create a new cluster supporting node pools](/api/#operation/addClusterV5)
-- [Get node pools of a cluster](/api/#operation/getNodePools)
-- [Create a new node pool](/api/#operation/addNodePool)
-- [Modify a cluster](/api/#operation/modifyClusterV5)
-- [Modify a node pool](/api/#operation/modifyNodePool)
-- [Delete a node pool](/api/#operation/deleteNodePool)
+- [Create a new cluster supporting node pools](https://giantswarm.github.io/api-spec/#operation/addClusterV5)
+- [Get node pools of a cluster](https://giantswarm.github.io/api-spec/#operation/getNodePools)
+- [Create a new node pool](https://giantswarm.github.io/api-spec/#operation/addNodePool)
+- [Modify a cluster](https://giantswarm.github.io/api-spec/#operation/modifyClusterV5)
+- [Modify a node pool](https://giantswarm.github.io/api-spec/#operation/modifyNodePool)
+- [Delete a node pool](https://giantswarm.github.io/api-spec/#operation/deleteNodePool)
 
 ## Node pools and the cluster definition YAML format
 
diff --git a/src/content/vintage/advanced/infrastructure-management/multi-account/index.md b/src/content/vintage/advanced/infrastructure-management/multi-account/index.md
index 6d6c0b34d2..e4085e00b3 100644
--- a/src/content/vintage/advanced/infrastructure-management/multi-account/index.md
+++ b/src/content/vintage/advanced/infrastructure-management/multi-account/index.md
@@ -64,7 +64,7 @@ Details of the implementation differ between AWS and Azure.
 
 ## Get started
 
-To create clusters in a new cloud provider account, you first need to provide the credentials to the organization you'd like to use for this purpose. You are free to create a new organization for this purpose if you like. Organizations can be created in the Giant Swarm web UI, or via the [Giant Swarm REST API](/api/#operation/addOrganization).
+To create clusters in a new cloud provider account, you first need to provide the credentials to the organization you'd like to use for this purpose. You are free to create a new organization for this purpose if you like. Organizations can be created in the Giant Swarm web UI, or via the [Giant Swarm REST API](https://giantswarm.github.io/api-spec/#operation/addOrganization).
 
 To prepare your credentials, either as AWS account roles or as an Azure service principle, please follow our specific guides:
 
@@ -75,7 +75,7 @@ You can then assign the credentials to your organization in several ways:
 
 - In the Giant Swarm web UI via the organization details page
 - In `gsctl` using the [`update organization set-credentials`]({{< relref "/vintage/use-the-api/gsctl/update-org-set-credentials" >}}) command
-- Via the [Giant Swarm REST API](/api/#operation/addCredentials)
+- Via the [Giant Swarm REST API](https://giantswarm.github.io/api-spec/#operation/addCredentials)
 
 All workload clusters created for that organization will then use the credentials provided to the organization and will reside in the account/subscription associated with them.
 
diff --git a/src/content/vintage/getting-started/app-platform/app-configuration/index.md b/src/content/vintage/getting-started/app-platform/app-configuration/index.md
index 7cc1cddb51..9954e04485 100644
--- a/src/content/vintage/getting-started/app-platform/app-configuration/index.md
+++ b/src/content/vintage/getting-started/app-platform/app-configuration/index.md
@@ -414,8 +414,8 @@ access to the Management API. However, for the time being, our web interface mak
 By supplying a JSON body with the values you would like to set, the Giant Swarm REST API will
 create a ConfigMap or Secret in the right format and wire it up correctly for you.
 
-- [REST API App Configs reference](/api/#tag/app-configs) for adding configuration values
-- [REST API App Secrets reference](/api/#tag/app-secrets) for adding secret values
+- [REST API App Configs reference](https://giantswarm.github.io/api-spec/#tag/app-configs) for adding configuration values
+- [REST API App Secrets reference](https://giantswarm.github.io/api-spec/#tag/app-secrets) for adding secret values
 
 ### Using the Management API {#management-api}
 
diff --git a/src/content/vintage/getting-started/cloud-provider-accounts/cluster-api/aws/_index.md b/src/content/vintage/getting-started/cloud-provider-accounts/cluster-api/aws/_index.md
index ad299f5dc9..b5de8e1c12 100644
--- a/src/content/vintage/getting-started/cloud-provider-accounts/cluster-api/aws/_index.md
+++ b/src/content/vintage/getting-started/cloud-provider-accounts/cluster-api/aws/_index.md
@@ -101,8 +101,8 @@ This CR needs to be created only once for each AWS Account. It can be then refer
 ## Further reading
 
 - [Basics and Concepts: Multi Account Support]({{< relref "/vintage/advanced/infrastructure-management/multi-account" >}})
-- [API: Set credentials](/api/#operation/addCredentials)
+- [API: Set credentials](https://giantswarm.github.io/api-spec/#operation/addCredentials)
 - [Giant Swarm Architecture]({{< relref "/vintage/platform-overview/cluster-management/vintage/aws" >}})
-- [Giant Swarm REST API documentation](/api/)
+- [Giant Swarm REST API documentation](https://giantswarm.github.io/api-spec/)
 - [AWS Service Limits](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)
 - [AWS Support Center](https://console.aws.amazon.com/support/home)
diff --git a/src/content/vintage/getting-started/cloud-provider-accounts/vintage/aws/index.md b/src/content/vintage/getting-started/cloud-provider-accounts/vintage/aws/index.md
index 0729f8d745..dd49f83ea7 100644
--- a/src/content/vintage/getting-started/cloud-provider-accounts/vintage/aws/index.md
+++ b/src/content/vintage/getting-started/cloud-provider-accounts/vintage/aws/index.md
@@ -277,9 +277,9 @@ organization. These clusters' resources will be created in your AWS account.
 
 - [Basics and Concepts: Multi Account Support]({{< relref "/vintage/advanced/infrastructure-management/multi-account" >}})
 - [gsctl Reference: `update organization set-credentials`]({{< relref "/vintage/use-the-api/gsctl/update-org-set-credentials" >}})
-- [API: Set credentials](/api/#operation/addCredentials)
+- [API: Set credentials](https://giantswarm.github.io/api-spec/#operation/addCredentials)
 - [Giant Swarm Architecture]({{< relref "/vintage/platform-overview/cluster-management/vintage/aws" >}})
-- [Giant Swarm REST API documentation](/api/)
+- [Giant Swarm REST API documentation](https://giantswarm.github.io/api-spec/)
 - [AWS Service Limits](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)
 - [AWS Support Center](https://console.aws.amazon.com/support/home)
 
diff --git a/src/content/vintage/getting-started/operations/autoscaling/cluster-size/index.md b/src/content/vintage/getting-started/operations/autoscaling/cluster-size/index.md
index fb92c6a663..6058a44a70 100644
--- a/src/content/vintage/getting-started/operations/autoscaling/cluster-size/index.md
+++ b/src/content/vintage/getting-started/operations/autoscaling/cluster-size/index.md
@@ -93,8 +93,8 @@ In workload clusters without autoscaling support, the number of Ingress Controll
 - [`gsctl create cluster`]({{< relref "/vintage/use-the-api/gsctl/create-cluster" >}}): Creating a cluster
 - [`gsctl scale cluster`]({{< relref "/vintage/use-the-api/gsctl/scale-cluster" >}}): Scaling a cluster
 - [`gsctl show cluster`]({{< relref "/vintage/use-the-api/gsctl/show-cluster" >}}): Inspecting a cluster
-- [API: Create cluster](/api/#operation/addCluster)
-- [API: Modify cluster](/api/#operation/modifyCluster)
-- [API: Get cluster details](/api/#operation/getCluster)
-- [API: Get cluster status](/api/#operation/getClusterStatus)
+- [API: Create cluster](https://giantswarm.github.io/api-spec/#operation/addCluster)
+- [API: Modify cluster](https://giantswarm.github.io/api-spec/#operation/modifyCluster)
+- [API: Get cluster details](https://giantswarm.github.io/api-spec/#operation/getCluster)
+- [API: Get cluster status](https://giantswarm.github.io/api-spec/#operation/getClusterStatus)
 - [Kubernetes autoscaler FAQ](https://github.com/kubernetes/autoscaler/blob/master/cluster-autoscaler/FAQ.md)
diff --git a/src/content/vintage/platform-overview/app-platform/index.md b/src/content/vintage/platform-overview/app-platform/index.md
index 7c757655b9..a70059d69f 100644
--- a/src/content/vintage/platform-overview/app-platform/index.md
+++ b/src/content/vintage/platform-overview/app-platform/index.md
@@ -141,7 +141,7 @@ You can interact with the Giant Swarm App Platform through creating App custom r
 
 - [App CRD reference]({{< relref "/vintage/use-the-api/management-api/crd/apps.application.giantswarm.io.md" >}})
 - [Web Interface Reference: The Giant Swarm App Platform]({{< relref "/vintage/platform-overview/web-interface/app-platform" >}})
-- [Apps and App Configs in the API reference](/api/#tag/apps)
+- [Apps and App Configs in the API reference](https://giantswarm.github.io/api-spec/#tag/apps)
 
 Both our web interface and REST API are used to create (or update) a set of App Custom Resources on your Kubernetes management cluster.
 
diff --git a/src/content/vintage/platform-overview/cluster-management/cluster-upgrades/index.md b/src/content/vintage/platform-overview/cluster-management/cluster-upgrades/index.md
index 636d2e6ea5..9eefbe93b3 100644
--- a/src/content/vintage/platform-overview/cluster-management/cluster-upgrades/index.md
+++ b/src/content/vintage/platform-overview/cluster-management/cluster-upgrades/index.md
@@ -108,7 +108,7 @@ Note that by default, our user interfaces upgrade to the next active workload cl
 
 - In **kubectl-gs**, the [`update cluster`]({{< relref "/reference/kubectl-gs/update-cluster" >}})) command provides an optional flag `--release-version` which allows to specify the version to upgrade to.
 
-- Alternatively, you can use the [Giant Swarm REST API](/api/#operation/modifyClusterV5) or the [Management API]({{< relref "/vintage/use-the-api/management-api" >}}) to trigger the upgrade. Please talk to your Account Engineer in case you have any questions regarding this.
+- Alternatively, you can use the [Giant Swarm REST API](https://giantswarm.github.io/api-spec/#operation/modifyClusterV5) or the [Management API]({{< relref "/vintage/use-the-api/management-api" >}}) to trigger the upgrade. Please talk to your Account Engineer in case you have any questions regarding this.
 
 ## How upgrades work
 
diff --git a/src/content/vintage/use-the-api/gsctl/cluster-definition.md b/src/content/vintage/use-the-api/gsctl/cluster-definition.md
index fd70c7069f..4f5c2a731c 100644
--- a/src/content/vintage/use-the-api/gsctl/cluster-definition.md
+++ b/src/content/vintage/use-the-api/gsctl/cluster-definition.md
@@ -86,7 +86,7 @@ workers:
 - `owner`: Name of the owner organization.
 - `name`: Friendly name of the cluster. If not specified, a name will be generated.
 - `release_version`: Allows to select a specific release version. The value must be the semantic version number (SemVer) of an active release. To get information on all available releases, use the [`gsctl list releases`]({{< relref "/vintage/use-the-api/gsctl/list-releases" >}}) command.
-- `availability_zones`: Number of availability zones to use for worker nodes (on AWS and Azure only). Both the default value and the maximum can be obtained via the [Info endpoint](/api/#operation/getInfo) of the Giant Swarm REST API.
+- `availability_zones`: Number of availability zones to use for worker nodes (on AWS and Azure only). Both the default value and the maximum can be obtained via the [Info endpoint](https://giantswarm.github.io/api-spec/#operation/getInfo) of the Giant Swarm REST API.
 - `workers`: Array of node definition objects describing each worker node. See below for possible keys. If not specified, the default number of worker nodes with default settings will be created.
 
 #### Node definition keys {#node-keys}
@@ -218,6 +218,6 @@ Chances are that you already work with YAML in various places. If not, here are
 - [`gsctl create cluster`]({{< relref "/vintage/use-the-api/gsctl/create-cluster" >}}): Create a cluster based on flags, or a definition file
 - [`gsctl create nodepool`]({{< relref "/vintage/use-the-api/gsctl/create-nodepool" >}})
 - [`gsctl list releases`]({{< relref "/vintage/use-the-api/gsctl/list-releases" >}}): Listing available releases
-- [API: Create cluster (v4)](/api/#operation/addCluster)
-- [API: Create cluster (v5)](/api/#operation/addClusterV5)
-- [API: Create node pool](/api/#operation/addNodePool)
+- [API: Create cluster (v4)](https://giantswarm.github.io/api-spec/#operation/addCluster)
+- [API: Create cluster (v5)](https://giantswarm.github.io/api-spec/#operation/addClusterV5)
+- [API: Create node pool](https://giantswarm.github.io/api-spec/#operation/addNodePool)
diff --git a/src/content/vintage/use-the-api/gsctl/create-cluster.md b/src/content/vintage/use-the-api/gsctl/create-cluster.md
index 742188ec26..8f51bfc907 100644
--- a/src/content/vintage/use-the-api/gsctl/create-cluster.md
+++ b/src/content/vintage/use-the-api/gsctl/create-cluster.md
@@ -113,5 +113,5 @@ When requesting cluster creation with workload cluster release v{{% first_aws_no
 - [`gsctl create kubeconfig`]({{< relref "/vintage/use-the-api/gsctl/create-kubeconfig" >}}) - Getting a key pair and enabling `kubectl` to access a cluster
 - [`gsctl delete cluster`]({{< relref "/vintage/use-the-api/gsctl/delete-cluster" >}}) - Deleting a cluster
 - [Basics: Cluster Size and Autoscaling]({{< relref "/vintage/getting-started/operations/autoscaling/cluster-size" >}})
-- [API: Create cluster (v4)](/api/#operation/addCluster)
-- [API: Create cluster (v5)](/api/#operation/addClusterV5)
+- [API: Create cluster (v4)](https://giantswarm.github.io/api-spec/#operation/addCluster)
+- [API: Create cluster (v5)](https://giantswarm.github.io/api-spec/#operation/addClusterV5)
diff --git a/src/content/vintage/use-the-api/gsctl/create-keypair.md b/src/content/vintage/use-the-api/gsctl/create-keypair.md
index 156204886c..4cb51477fd 100644
--- a/src/content/vintage/use-the-api/gsctl/create-keypair.md
+++ b/src/content/vintage/use-the-api/gsctl/create-keypair.md
@@ -79,4 +79,4 @@ __Warning:__ Setting `system:masters` as an organization means the user who uses
 
 - [Creating workload cluster key pairs via the Management API]({{< relref "/vintage/use-the-api/management-api/wc-key-pairs" >}})
 - [`gsctl create kubeconfig`]({{< relref "/vintage/use-the-api/gsctl/create-kubeconfig" >}}): Create a key pair and prepare your kubectl configuration to access the cluster.
-- [Rest API: Create key pair](/api/#operation/addKeyPair)
+- [Rest API: Create key pair](https://giantswarm.github.io/api-spec/#operation/addKeyPair)
diff --git a/src/content/vintage/use-the-api/gsctl/create-kubeconfig.md b/src/content/vintage/use-the-api/gsctl/create-kubeconfig.md
index df1ba3574a..8c71515321 100644
--- a/src/content/vintage/use-the-api/gsctl/create-kubeconfig.md
+++ b/src/content/vintage/use-the-api/gsctl/create-kubeconfig.md
@@ -226,5 +226,5 @@ Passing flag `--output` with value `json` to `gsctl create kubeconfig` changes t
 - [Creating workload cluster key pairs via the Management API]({{< relref "/vintage/use-the-api/management-api/wc-key-pairs" >}})
 - [`gsctl create keypair`]({{< relref "/vintage/use-the-api/gsctl/create-keypair" >}}): Create and download a key pair
 - [kubectl reference](https://kubernetes.io/docs/reference/kubectl/overview/)
-- [API: Create key pair](/api/#operation/addKeyPair)
+- [API: Create key pair](https://giantswarm.github.io/api-spec/#operation/addKeyPair)
 - [Kubie](https://github.com/sbstp/kubie)
diff --git a/src/content/vintage/use-the-api/gsctl/delete-cluster.md b/src/content/vintage/use-the-api/gsctl/delete-cluster.md
index 414ce20cb2..0235c7fa5f 100644
--- a/src/content/vintage/use-the-api/gsctl/delete-cluster.md
+++ b/src/content/vintage/use-the-api/gsctl/delete-cluster.md
@@ -82,4 +82,4 @@ Passing flag `--output` with value `json` to `gsctl delete cluster` changes the
 
 - [`gsctl scale cluster`]({{< relref "/vintage/use-the-api/gsctl/scale-cluster" >}})
 - [`gsctl` reference overview]({{< relref "/vintage/use-the-api/gsctl" >}})
-- [API: Delete cluster](/api/#operation/deleteCluster)
+- [API: Delete cluster](https://giantswarm.github.io/api-spec/#operation/deleteCluster)
diff --git a/src/content/vintage/use-the-api/gsctl/info.md b/src/content/vintage/use-the-api/gsctl/info.md
index 3cb5bee55c..30069da68b 100644
--- a/src/content/vintage/use-the-api/gsctl/info.md
+++ b/src/content/vintage/use-the-api/gsctl/info.md
@@ -100,4 +100,4 @@ Maximum workers per cluster:  20
 ## Related
 
 - [`gsctl select endpoint`]({{< relref "/vintage/use-the-api/gsctl/select-endpoint" >}})
-- [API: Get information on the installation](/api/#operation/getInfo)
+- [API: Get information on the installation](https://giantswarm.github.io/api-spec/#operation/getInfo)
diff --git a/src/content/vintage/use-the-api/gsctl/list-clusters.md b/src/content/vintage/use-the-api/gsctl/list-clusters.md
index c9755646d1..8f9e174fde 100644
--- a/src/content/vintage/use-the-api/gsctl/list-clusters.md
+++ b/src/content/vintage/use-the-api/gsctl/list-clusters.md
@@ -63,4 +63,4 @@ Providing a small part of the column name is also accepted: `d`/`del`/`deleting`
 - [`gsctl create cluster`]({{< relref "/vintage/use-the-api/gsctl/create-cluster" >}})
 - [`gsctl scale cluster`]({{< relref "/vintage/use-the-api/gsctl/scale-cluster" >}})
 - [`gsctl delete cluster`]({{< relref "/vintage/use-the-api/gsctl/delete-cluster" >}})
-- [API: Get clusters](/api/#operation/getClusters)
+- [API: Get clusters](https://giantswarm.github.io/api-spec/#operation/getClusters)
diff --git a/src/content/vintage/use-the-api/gsctl/list-keypairs.md b/src/content/vintage/use-the-api/gsctl/list-keypairs.md
index 8802e71d8d..2c1ca8c90f 100644
--- a/src/content/vintage/use-the-api/gsctl/list-keypairs.md
+++ b/src/content/vintage/use-the-api/gsctl/list-keypairs.md
@@ -82,5 +82,5 @@ CREATED                 EXPIRES                 ID          DESCRIPTION
 - [`gsctl create keypair`]({{< relref "/vintage/use-the-api/gsctl/create-keypair" >}})
 - [`gsctl create kubeconfig`]({{< relref "/vintage/use-the-api/gsctl/create-kubeconfig" >}})
 - [Securing your cluster with RBAC and PSP]({{< relref "/vintage/getting-started/security" >}})
-- [API: Get key pairs](/api/#operation/getKeyPairs)
+- [API: Get key pairs](https://giantswarm.github.io/api-spec/#operation/getKeyPairs)
 - [X.509 on Wikipedia](https://en.wikipedia.org/wiki/X.509)
diff --git a/src/content/vintage/use-the-api/gsctl/list-releases.md b/src/content/vintage/use-the-api/gsctl/list-releases.md
index a907d138e7..2bf6b64561 100644
--- a/src/content/vintage/use-the-api/gsctl/list-releases.md
+++ b/src/content/vintage/use-the-api/gsctl/list-releases.md
@@ -83,5 +83,5 @@ Output details:
 
 - [`gsctl create cluster`]({{< relref "/vintage/use-the-api/gsctl/create-cluster" >}})
 - [`gsctl show cluster`]({{< relref "/vintage/use-the-api/gsctl/show-cluster" >}})
-- [API: Get releases](/api/#operation/getReleases)
+- [API: Get releases](https://giantswarm.github.io/api-spec/#operation/getReleases)
 - [`kubectl gs get releases`]({{< relref "/reference/kubectl-gs/get-releases" >}})
diff --git a/src/content/vintage/use-the-api/gsctl/login.md b/src/content/vintage/use-the-api/gsctl/login.md
index 2d73eafe29..c6ef9b594b 100644
--- a/src/content/vintage/use-the-api/gsctl/login.md
+++ b/src/content/vintage/use-the-api/gsctl/login.md
@@ -53,4 +53,4 @@ gsctl login <email> -e <endpoint> -p <password>
 
 ## Related
 
-- [API: Create auth token](/api/#operation/createAuthToken)
+- [API: Create auth token](https://giantswarm.github.io/api-spec/#operation/createAuthToken)
diff --git a/src/content/vintage/use-the-api/gsctl/scale-cluster.md b/src/content/vintage/use-the-api/gsctl/scale-cluster.md
index de41759e0b..f8a1f948e4 100644
--- a/src/content/vintage/use-the-api/gsctl/scale-cluster.md
+++ b/src/content/vintage/use-the-api/gsctl/scale-cluster.md
@@ -58,4 +58,4 @@ Use `gsctl scale cluster --help` for a additional (global) arguments.
 - [`gsctl update nodepool`]({{< relref "/vintage/use-the-api/gsctl/update-nodepool" >}}): Among others, allows to scale a node pool
 - [`gsctl delete cluster`]({{< relref "/vintage/use-the-api/gsctl/delete-cluster" >}}): Delete a cluster
 - [Basics: Cluster Size and Autoscaling]({{< relref "/vintage/getting-started/operations/autoscaling/cluster-size" >}})
-- [API: Modify cluster](/api/#operation/modifyCluster)
+- [API: Modify cluster](https://giantswarm.github.io/api-spec/#operation/modifyCluster)
diff --git a/src/content/vintage/use-the-api/gsctl/show-cluster.md b/src/content/vintage/use-the-api/gsctl/show-cluster.md
index f6ceffd1b3..48fc5dbc83 100644
--- a/src/content/vintage/use-the-api/gsctl/show-cluster.md
+++ b/src/content/vintage/use-the-api/gsctl/show-cluster.md
@@ -109,4 +109,4 @@ Note that some dynamic pieces of information, like the current number of workers
 - [`gsctl list clusters`]({{< relref "/vintage/use-the-api/gsctl/list-clusters" >}})
 - [`gsctl scale cluster`]({{< relref "/vintage/use-the-api/gsctl/scale-cluster" >}})
 - [`gsctl delete cluster`]({{< relref "/vintage/use-the-api/gsctl/delete-cluster" >}})
-- [API: Get cluster details](/api/#operation/getCluster)
+- [API: Get cluster details](https://giantswarm.github.io/api-spec/#operation/getCluster)
diff --git a/src/content/vintage/use-the-api/gsctl/update-cluster.md b/src/content/vintage/use-the-api/gsctl/update-cluster.md
index 14b9627471..1c2385caf3 100644
--- a/src/content/vintage/use-the-api/gsctl/update-cluster.md
+++ b/src/content/vintage/use-the-api/gsctl/update-cluster.md
@@ -71,7 +71,7 @@ To remove a label, set its key to an empty string (`labeltodelete=`).
 
 - [`gsctl create cluster`]({{< relref "/vintage/use-the-api/gsctl/create-cluster" >}}) - Add a node pool to a cluster
 - [`gsctl list clusters`]({{< relref "/vintage/use-the-api/gsctl/list-clusters" >}}) - List all node pools of a cluster
-- [API: Modify cluster (v4)](/api/#operation/modifyCluster)
-- [API: Modify cluster (v5)](/api/#operation/modifyClusterV5)
-- [API: Update cluster labels](/api/#operation/setClusterLabels)
+- [API: Modify cluster (v4)](https://giantswarm.github.io/api-spec/#operation/modifyCluster)
+- [API: Modify cluster (v5)](https://giantswarm.github.io/api-spec/#operation/modifyClusterV5)
+- [API: Update cluster labels](https://giantswarm.github.io/api-spec/#operation/setClusterLabels)
 - [Labelling workload clusters]({{< relref "/vintage/advanced/cluster-management/labelling-workload-clusters" >}})
diff --git a/src/content/vintage/use-the-api/gsctl/update-org-set-credentials.md b/src/content/vintage/use-the-api/gsctl/update-org-set-credentials.md
index 4d064553f1..193722a432 100644
--- a/src/content/vintage/use-the-api/gsctl/update-org-set-credentials.md
+++ b/src/content/vintage/use-the-api/gsctl/update-org-set-credentials.md
@@ -79,4 +79,4 @@ The flags mean:
 - [Basics and Concepts: Multi-Account Support]({{< relref "/vintage/advanced/infrastructure-management/multi-account" >}})
 - [Guides: Prepare an AWS account to run Giant Swarm workload clusters]({{< relref "/vintage/getting-started/cloud-provider-accounts/vintage/aws" >}})
 - [Guides: Prepare an Azure subscription to run Giant Swarm workload clusters]({{< relref "/vintage/getting-started/cloud-provider-accounts/vintage/azure" >}})
-- [API: Set credentials](/api/#operation/addCredentials)
+- [API: Set credentials](https://giantswarm.github.io/api-spec/#operation/addCredentials)
diff --git a/src/content/vintage/use-the-api/gsctl/upgrade-cluster.md b/src/content/vintage/use-the-api/gsctl/upgrade-cluster.md
index f179e86a5b..57d519d43b 100644
--- a/src/content/vintage/use-the-api/gsctl/upgrade-cluster.md
+++ b/src/content/vintage/use-the-api/gsctl/upgrade-cluster.md
@@ -49,4 +49,4 @@ You can list available workload cluster releases with `gsctl list releases`.
 - [`gsctl create cluster`]({{< relref "/vintage/use-the-api/gsctl/create-cluster" >}}): Reference for creating a cluster
 - [`gsctl delete cluster`]({{< relref "/vintage/use-the-api/gsctl/delete-cluster" >}}): Reference for deleting a cluster
 - [`gsctl list releases`]({{< relref "/vintage/use-the-api/gsctl/list-releases" >}}): Reference for listing available workload cluster releases
-- [API: Upgrade cluster](/api/#operation/upgradeCluster)
+- [API: Upgrade cluster](https://giantswarm.github.io/api-spec/#operation/upgradeCluster)
diff --git a/src/content/vintage/use-the-api/rest-api/index.md b/src/content/vintage/use-the-api/rest-api/index.md
index c59a7c3316..aa5f44a32f 100644
--- a/src/content/vintage/use-the-api/rest-api/index.md
+++ b/src/content/vintage/use-the-api/rest-api/index.md
@@ -28,4 +28,4 @@ As of now, there is no termination date for the REST API. It is however **not av
 
 ## Further reading
 
-- [REST API documentation](/api/)
+- [REST API documentation](https://giantswarm.github.io/api-spec/)