diff --git a/CHANGELOG.md b/CHANGELOG.md
index d09ad60d..283e4755 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+## [2.36.0](https://github.com/netlify/open-api/compare/v2.35.1...v2.36.0) (2025-01-22)
+
+
+### Features
+
+* add API reference links to generated TypeScript comments ([#559](https://github.com/netlify/open-api/issues/559)) ([4f0031d](https://github.com/netlify/open-api/commit/4f0031dfa44ea2f3bbdae989cf89865db2bce7ca))
+
 ## [2.35.1](https://github.com/netlify/open-api/compare/v2.35.0...v2.35.1) (2025-01-17)
 
 
diff --git a/package-lock.json b/package-lock.json
index 3c22bcb1..bb856954 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,6 +1,6 @@
 {
   "name": "@netlify/open-api",
-  "version": "2.35.1",
+  "version": "2.36.0",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {
diff --git a/package.json b/package.json
index 4fe27232..8bfebd53 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@netlify/open-api",
   "description": "Netlify's open-api definition as a module",
-  "version": "2.35.1",
+  "version": "2.36.0",
   "author": "Netlify",
   "ava": {
     "files": [
diff --git a/swagger.yml b/swagger.yml
index 9a77efa9..e9c65be8 100644
--- a/swagger.yml
+++ b/swagger.yml
@@ -1,6 +1,6 @@
 swagger: '2.0'
 info:
-  version: 2.35.1
+  version: 2.36.0
   title: Netlify's API documentation
   description: >-
     Netlify is a hosting service for the programmable web. It understands your