From d24b3877409e80fa65ccd5b2daa40bb51324091b Mon Sep 17 00:00:00 2001 From: Erik-Jan Westendorp Date: Tue, 25 Nov 2025 15:04:17 +0100 Subject: [PATCH 1/4] Add note --- .../adding-a-custom-swagger-document.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/16/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md b/16/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md index 2cbd04ad292..d98929c2738 100644 --- a/16/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md +++ b/16/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md @@ -66,3 +66,7 @@ public class MyItemApiController : ManagementApiControllerBase Now when we visit the Swagger UI, "My item API" has its own Swagger document: ![My item API in Swagger UI](images/my-item-api-swagger-ui.png) + +{% hint style="info" %} +Swagger UI sometimes has persistent caching, which can prevent the new definition from appearing immediately. If this happens, it's best to use the developer tools to disable caching. +{% endhint %} From 62490055bd857822588d60a281124e3395ffd047 Mon Sep 17 00:00:00 2001 From: Erik-Jan Westendorp Date: Tue, 25 Nov 2025 15:06:27 +0100 Subject: [PATCH 2/4] Update v15 & 17 --- .../adding-a-custom-swagger-document.md | 4 ++++ .../adding-a-custom-swagger-document.md | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/15/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md b/15/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md index 2cbd04ad292..ae8b68538ce 100644 --- a/15/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md +++ b/15/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md @@ -66,3 +66,7 @@ public class MyItemApiController : ManagementApiControllerBase Now when we visit the Swagger UI, "My item API" has its own Swagger document: ![My item API in Swagger UI](images/my-item-api-swagger-ui.png) + +{% hint style="info" %} +Swagger UI sometimes has persistent caching, which can prevent the new definition from appearing immediately. If this happens, it's best to use the developer tools to disable caching. +{% endhint %} \ No newline at end of file diff --git a/17/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md b/17/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md index 2cbd04ad292..ae8b68538ce 100644 --- a/17/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md +++ b/17/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md @@ -66,3 +66,7 @@ public class MyItemApiController : ManagementApiControllerBase Now when we visit the Swagger UI, "My item API" has its own Swagger document: ![My item API in Swagger UI](images/my-item-api-swagger-ui.png) + +{% hint style="info" %} +Swagger UI sometimes has persistent caching, which can prevent the new definition from appearing immediately. If this happens, it's best to use the developer tools to disable caching. +{% endhint %} \ No newline at end of file From 505a083f1bf152da9a3380957c2bd047f9e516db Mon Sep 17 00:00:00 2001 From: Erik-Jan Westendorp Date: Wed, 26 Nov 2025 09:26:17 +0100 Subject: [PATCH 3/4] Update 15/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md Co-authored-by: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> --- .../adding-a-custom-swagger-document.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/15/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md b/15/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md index ae8b68538ce..c709041bf4d 100644 --- a/15/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md +++ b/15/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md @@ -68,5 +68,5 @@ Now when we visit the Swagger UI, "My item API" has its own Swagger document: ![My item API in Swagger UI](images/my-item-api-swagger-ui.png) {% hint style="info" %} -Swagger UI sometimes has persistent caching, which can prevent the new definition from appearing immediately. If this happens, it's best to use the developer tools to disable caching. +Swagger UI sometimes has persistent caching, which can prevent the new definition from appearing immediately. If this happens, disable caching in the **Network** tab of your browser's developer tools. {% endhint %} \ No newline at end of file From 1476c31105a64928556f08c535323da41aca605a Mon Sep 17 00:00:00 2001 From: Erik-Jan Westendorp Date: Wed, 26 Nov 2025 09:27:48 +0100 Subject: [PATCH 4/4] Update v16 and 17 --- .../adding-a-custom-swagger-document.md | 2 +- .../adding-a-custom-swagger-document.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/16/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md b/16/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md index d98929c2738..7097ef4d87d 100644 --- a/16/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md +++ b/16/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md @@ -68,5 +68,5 @@ Now when we visit the Swagger UI, "My item API" has its own Swagger document: ![My item API in Swagger UI](images/my-item-api-swagger-ui.png) {% hint style="info" %} -Swagger UI sometimes has persistent caching, which can prevent the new definition from appearing immediately. If this happens, it's best to use the developer tools to disable caching. +Swagger UI sometimes has persistent caching, which can prevent the new definition from appearing immediately. If this happens, disable caching in the **Network** tab of your browser's developer tools. {% endhint %} diff --git a/17/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md b/17/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md index ae8b68538ce..c709041bf4d 100644 --- a/17/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md +++ b/17/umbraco-cms/tutorials/creating-a-backoffice-api/adding-a-custom-swagger-document.md @@ -68,5 +68,5 @@ Now when we visit the Swagger UI, "My item API" has its own Swagger document: ![My item API in Swagger UI](images/my-item-api-swagger-ui.png) {% hint style="info" %} -Swagger UI sometimes has persistent caching, which can prevent the new definition from appearing immediately. If this happens, it's best to use the developer tools to disable caching. +Swagger UI sometimes has persistent caching, which can prevent the new definition from appearing immediately. If this happens, disable caching in the **Network** tab of your browser's developer tools. {% endhint %} \ No newline at end of file