OpenAPITools · wing328 · Mar 3, 2026 · Mar 3, 2026 · Mar 3, 2026 · Mar 3, 2026
diff --git a/modules/openapi-generator/src/main/resources/kotlin-spring/api.mustache b/modules/openapi-generator/src/main/resources/kotlin-spring/api.mustache
@@ -87,6 +87,9 @@ class {{classname}}Controller({{#serviceInterface}}@Autowired(required = true) v
     {{#vendorExtensions.x-operation-extra-annotation}}
     {{{.}}}
     {{/vendorExtensions.x-operation-extra-annotation}}
+    {{#isDeprecated}}
+    @Deprecated(message="Operation is deprecated")
+    {{/isDeprecated}}
     @RequestMapping(
         method = [RequestMethod.{{httpMethod}}],
         // "{{#lambdaEscapeInNormalString}}{{{path}}}{{/lambdaEscapeInNormalString}}"

diff --git a/modules/openapi-generator/src/main/resources/kotlin-spring/apiInterface.mustache b/modules/openapi-generator/src/main/resources/kotlin-spring/apiInterface.mustache
@@ -102,6 +102,9 @@ interface {{classname}} {
     {{#vendorExtensions.x-operation-extra-annotation}}
     {{{.}}}
     {{/vendorExtensions.x-operation-extra-annotation}}
+    {{#isDeprecated}}
+    @Deprecated(message="Operation is deprecated")
+    {{/isDeprecated}}
     @RequestMapping(
         method = [RequestMethod.{{httpMethod}}],
         // "{{#lambdaEscapeInNormalString}}{{{path}}}{{/lambdaEscapeInNormalString}}"

diff --git a/modules/openapi-generator/src/main/resources/kotlin-spring/service.mustache b/modules/openapi-generator/src/main/resources/kotlin-spring/service.mustache
@@ -30,6 +30,9 @@ interface {{classname}}Service {
     {{/externalDocs}}
      * @see {{classname}}#{{operationId}}
      */
+    {{#isDeprecated}}
+    @Deprecated(message="Operation is deprecated")
+    {{/isDeprecated}}
     {{#reactive}}{{^isArray}}suspend {{/isArray}}{{#isArray}}{{^useFlowForArrayReturnType}}suspend {{/useFlowForArrayReturnType}}{{/isArray}}{{/reactive}}fun {{operationId}}({{#allParams}}{{{paramName}}}: {{^isBodyParam}}{{>optionalDataType}}{{/isBodyParam}}{{#isBodyParam}}{{^reactive}}{{>optionalDataType}}{{/reactive}}{{#reactive}}{{^isArray}}{{>optionalDataType}}{{/isArray}}{{#isArray}}Flow<{{{baseType}}}>{{/isArray}}{{/reactive}}{{/isBodyParam}}{{^-last}}, {{/-last}}{{/allParams}}): {{>returnTypes}}
 {{/operation}}
 }

diff --git a/...r/src/test/java/org/openapitools/codegen/kotlin/spring/KotlinSpringServerCodegenTest.java b/...r/src/test/java/org/openapitools/codegen/kotlin/spring/KotlinSpringServerCodegenTest.java
@@ -4663,6 +4663,49 @@ public void testSealedResponseInterfacesVoidResponse() throws IOException {
         Assert.assertTrue(petContent.contains(") : CreatePetResponse {") || petContent.contains(") : CreatePetResponse"),
                 "Pet should implement CreatePetResponse");
     }
+
+    @Test
+    public void testDeprecatedAnnotationOnInterface() throws IOException {
+        File output = Files.createTempDirectory("test").toFile().getCanonicalFile();
+        output.deleteOnExit();
+        String outputPath = output.getAbsolutePath().replace('\\', '/');
+
+        KotlinSpringServerCodegen codegen = new KotlinSpringServerCodegen();
+        codegen.setOutputDir(output.getAbsolutePath());
+        codegen.additionalProperties().put(CodegenConstants.API_PACKAGE, "org.openapitools.api");
+        codegen.additionalProperties().put(KotlinSpringServerCodegen.INTERFACE_ONLY, true);
+
+        new DefaultGenerator().opts(new ClientOptInput()
+                        .openAPI(TestUtils.parseSpec("src/test/resources/3_0/kotlin/support-deprecated-api.yaml"))
+                        .config(codegen))
+                .generate();
+
+        assertFileContains(
+                Paths.get(outputPath + "/src/main/kotlin/org/openapitools/api/PingApi.kt"),
+                "@Deprecated(message=\"Operation is deprecated\") @RequestMapping("
+        );
+    }
+
+    @Test
+    public void testDeprecatedAnnotationOnController() throws IOException {
+        File output = Files.createTempDirectory("test").toFile().getCanonicalFile();
+        output.deleteOnExit();
+        String outputPath = output.getAbsolutePath().replace('\\', '/');
+
+        KotlinSpringServerCodegen codegen = new KotlinSpringServerCodegen();
+        codegen.setOutputDir(output.getAbsolutePath());
+        codegen.additionalProperties().put(CodegenConstants.API_PACKAGE, "org.openapitools.api");
+
+        new DefaultGenerator().opts(new ClientOptInput()
+                        .openAPI(TestUtils.parseSpec("src/test/resources/3_0/kotlin/support-deprecated-api.yaml"))
+                        .config(codegen))
+                .generate();
+
+        assertFileContains(
+                Paths.get(outputPath + "/src/main/kotlin/org/openapitools/api/PingApiController.kt"),
+                "@Deprecated(message=\"Operation is deprecated\") @RequestMapping("
+        );
+    }
 }
 
 
diff --git a/modules/openapi-generator/src/test/resources/3_0/kotlin/support-deprecated-api.yaml b/modules/openapi-generator/src/test/resources/3_0/kotlin/support-deprecated-api.yaml
@@ -0,0 +1,14 @@
+openapi: "3.0.0"
+info:
+  title: Verify @Deprecated annotation
+  version: "1.0"
+
+paths:
+
+  /ping:
+    get:
+      deprecated: true
+      operationId: ping
+      responses:
+        200:
+          description: OK
diff --git a/samples/server/petstore/kotlin-spring-cloud/src/main/kotlin/org/openapitools/api/PetApi.kt b/samples/server/petstore/kotlin-spring-cloud/src/main/kotlin/org/openapitools/api/PetApi.kt
@@ -73,6 +73,7 @@ interface PetApi {
     }
 
 
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...r/petstore/kotlin-spring-default/src/main/kotlin/org/openapitools/api/PetApiController.kt b/...r/petstore/kotlin-spring-default/src/main/kotlin/org/openapitools/api/PetApiController.kt
@@ -106,6 +106,7 @@ class PetApiController() {
             ApiResponse(responseCode = "400", description = "Invalid tag value") ],
         security = [ SecurityRequirement(name = "petstore_auth", scopes = [ "read:pets" ]) ]
     )
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...r/petstore/kotlin-spring-sealed-interfaces/src/main/kotlin/org/openapitools/api/PetApi.kt b/...r/petstore/kotlin-spring-sealed-interfaces/src/main/kotlin/org/openapitools/api/PetApi.kt
@@ -78,6 +78,7 @@ interface PetApi {
     }
 
 
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...-springboot-3-no-response-entity/src/main/kotlin/org/openapitools/api/PetApiController.kt b/...-springboot-3-no-response-entity/src/main/kotlin/org/openapitools/api/PetApiController.kt
@@ -69,6 +69,7 @@ class PetApiController(@Autowired(required = true) val service: PetApiService) {
     }
 
 
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...lin-springboot-3-no-response-entity/src/main/kotlin/org/openapitools/api/PetApiService.kt b/...lin-springboot-3-no-response-entity/src/main/kotlin/org/openapitools/api/PetApiService.kt
@@ -48,6 +48,7 @@ interface PetApiService {
      * @deprecated
      * @see PetApi#findPetsByTags
      */
+    @Deprecated(message="Operation is deprecated")
     fun findPetsByTags(tags: kotlin.collections.List<kotlin.String>): List<Pet>
 
     /**

diff --git a/...ver/petstore/kotlin-springboot-3/src/main/kotlin/org/openapitools/api/PetApiController.kt b/...ver/petstore/kotlin-springboot-3/src/main/kotlin/org/openapitools/api/PetApiController.kt
@@ -69,6 +69,7 @@ class PetApiController(@Autowired(required = true) val service: PetApiService) {
     }
 
 
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...server/petstore/kotlin-springboot-3/src/main/kotlin/org/openapitools/api/PetApiService.kt b/...server/petstore/kotlin-springboot-3/src/main/kotlin/org/openapitools/api/PetApiService.kt
@@ -48,6 +48,7 @@ interface PetApiService {
      * @deprecated
      * @see PetApi#findPetsByTags
      */
+    @Deprecated(message="Operation is deprecated")
     fun findPetsByTags(tags: kotlin.collections.List<kotlin.String>): List<Pet>
 
     /**

diff --git a/...-springboot-additionalproperties/src/main/kotlin/org/openapitools/api/PetApiController.kt b/...-springboot-additionalproperties/src/main/kotlin/org/openapitools/api/PetApiController.kt
@@ -69,6 +69,7 @@ class PetApiController(@Autowired(required = true) val service: PetApiService) {
     }
 
 
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...lin-springboot-additionalproperties/src/main/kotlin/org/openapitools/api/PetApiService.kt b/...lin-springboot-additionalproperties/src/main/kotlin/org/openapitools/api/PetApiService.kt
@@ -48,6 +48,7 @@ interface PetApiService {
      * @deprecated
      * @see PetApi#findPetsByTags
      */
+    @Deprecated(message="Operation is deprecated")
     fun findPetsByTags(tags: kotlin.collections.List<kotlin.String>): List<Pet>
 
     /**

diff --git a/...tore/kotlin-springboot-delegate-nodefaults/src/main/kotlin/org/openapitools/api/PetApi.kt b/...tore/kotlin-springboot-delegate-nodefaults/src/main/kotlin/org/openapitools/api/PetApi.kt
@@ -121,6 +121,7 @@ interface PetApi {
         ],
         security = [ SecurityRequirement(name = "petstore_auth", scopes = [ "read:pets" ]) ]
     )
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...server/petstore/kotlin-springboot-delegate/src/main/kotlin/org/openapitools/api/PetApi.kt b/...server/petstore/kotlin-springboot-delegate/src/main/kotlin/org/openapitools/api/PetApi.kt
@@ -120,6 +120,7 @@ interface PetApi {
         ],
         security = [ SecurityRequirement(name = "petstore_auth", scopes = [ "read:pets" ]) ]
     )
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...e/kotlin-springboot-modelMutable/src/main/kotlin/org/openapitools/api/PetApiController.kt b/...e/kotlin-springboot-modelMutable/src/main/kotlin/org/openapitools/api/PetApiController.kt
@@ -104,6 +104,7 @@ class PetApiController(@Autowired(required = true) val service: PetApiService) {
             ApiResponse(responseCode = "400", description = "Invalid tag value") ],
         security = [ SecurityRequirement(name = "petstore_auth", scopes = [ "write:pets", "read:pets" ]) ]
     )
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...tore/kotlin-springboot-modelMutable/src/main/kotlin/org/openapitools/api/PetApiService.kt b/...tore/kotlin-springboot-modelMutable/src/main/kotlin/org/openapitools/api/PetApiService.kt
@@ -45,6 +45,7 @@ interface PetApiService {
      * @deprecated
      * @see PetApi#findPetsByTags
      */
+    @Deprecated(message="Operation is deprecated")
     fun findPetsByTags(tags: kotlin.collections.List<kotlin.String>): List<Pet>
 
     /**

diff --git a/...lin-springboot-no-response-entity-delegate/src/main/kotlin/org/openapitools/api/PetApi.kt b/...lin-springboot-no-response-entity-delegate/src/main/kotlin/org/openapitools/api/PetApi.kt
@@ -74,6 +74,7 @@ interface PetApi {
     }
 
     @ResponseStatus(HttpStatus.OK)
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...ingboot-no-response-entity-delegate/src/main/kotlin/org/openapitools/api/PetApiService.kt b/...ingboot-no-response-entity-delegate/src/main/kotlin/org/openapitools/api/PetApiService.kt
@@ -45,6 +45,7 @@ interface PetApiService {
      * @deprecated
      * @see PetApi#findPetsByTags
      */
+    @Deprecated(message="Operation is deprecated")
     fun findPetsByTags(tags: kotlin.collections.List<kotlin.String>): List<Pet>
 
     /**

diff --git a/...in-springboot-no-response-entity/src/main/kotlin/org/openapitools/api/PetApiController.kt b/...in-springboot-no-response-entity/src/main/kotlin/org/openapitools/api/PetApiController.kt
@@ -68,6 +68,7 @@ class PetApiController(@Autowired(required = true) val service: PetApiService) {
     }
 
     @ResponseStatus(HttpStatus.OK)
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...otlin-springboot-no-response-entity/src/main/kotlin/org/openapitools/api/PetApiService.kt b/...otlin-springboot-no-response-entity/src/main/kotlin/org/openapitools/api/PetApiService.kt
@@ -45,6 +45,7 @@ interface PetApiService {
      * @deprecated
      * @see PetApi#findPetsByTags
      */
+    @Deprecated(message="Operation is deprecated")
     fun findPetsByTags(tags: kotlin.collections.List<kotlin.String>): List<Pet>
 
     /**

diff --git a/...springboot-reactive-without-flow/src/main/kotlin/org/openapitools/api/PetApiController.kt b/...springboot-reactive-without-flow/src/main/kotlin/org/openapitools/api/PetApiController.kt
@@ -107,6 +107,7 @@ class PetApiController(@Autowired(required = true) val service: PetApiService) {
             ApiResponse(responseCode = "400", description = "Invalid tag value") ],
         security = [ SecurityRequirement(name = "petstore_auth", scopes = [ "read:pets" ]) ]
     )
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...in-springboot-reactive-without-flow/src/main/kotlin/org/openapitools/api/PetApiService.kt b/...in-springboot-reactive-without-flow/src/main/kotlin/org/openapitools/api/PetApiService.kt
@@ -49,6 +49,7 @@ interface PetApiService {
      * @deprecated
      * @see PetApi#findPetsByTags
      */
+    @Deprecated(message="Operation is deprecated")
     suspend fun findPetsByTags(tags: kotlin.collections.List<kotlin.String>): List<Pet>
 
     /**

diff --git a/...store/kotlin-springboot-reactive/src/main/kotlin/org/openapitools/api/PetApiController.kt b/...store/kotlin-springboot-reactive/src/main/kotlin/org/openapitools/api/PetApiController.kt
@@ -107,6 +107,7 @@ class PetApiController(@Autowired(required = true) val service: PetApiService) {
             ApiResponse(responseCode = "400", description = "Invalid tag value") ],
         security = [ SecurityRequirement(name = "petstore_auth", scopes = [ "read:pets" ]) ]
     )
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...petstore/kotlin-springboot-reactive/src/main/kotlin/org/openapitools/api/PetApiService.kt b/...petstore/kotlin-springboot-reactive/src/main/kotlin/org/openapitools/api/PetApiService.kt
@@ -49,6 +49,7 @@ interface PetApiService {
      * @deprecated
      * @see PetApi#findPetsByTags
      */
+    @Deprecated(message="Operation is deprecated")
     fun findPetsByTags(tags: kotlin.collections.List<kotlin.String>): Flow<Pet>
 
     /**

diff --git a/.../petstore/kotlin-springboot-request-cookie/src/main/kotlin/org/openapitools/api/PetApi.kt b/.../petstore/kotlin-springboot-request-cookie/src/main/kotlin/org/openapitools/api/PetApi.kt
@@ -118,6 +118,7 @@ interface PetApi {
         ],
         security = [ SecurityRequirement(name = "petstore_auth", scopes = [ "read:pets" ]) ]
     )
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...otlin-springboot-source-swagger1/src/main/kotlin/org/openapitools/api/PetApiController.kt b/...otlin-springboot-source-swagger1/src/main/kotlin/org/openapitools/api/PetApiController.kt
@@ -109,6 +109,7 @@ class PetApiController(@Autowired(required = true) val service: PetApiService) {
         authorizations = [Authorization(value = "petstore_auth", scopes = [AuthorizationScope(scope = "write:pets", description = "modify pets in your account"), AuthorizationScope(scope = "read:pets", description = "read your pets")])])
     @ApiResponses(
         value = [ApiResponse(code = 200, message = "successful operation", response = Pet::class, responseContainer = "List"),ApiResponse(code = 400, message = "Invalid tag value")])
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...e/kotlin-springboot-source-swagger1/src/main/kotlin/org/openapitools/api/PetApiService.kt b/...e/kotlin-springboot-source-swagger1/src/main/kotlin/org/openapitools/api/PetApiService.kt
@@ -45,6 +45,7 @@ interface PetApiService {
      * @deprecated
      * @see PetApi#findPetsByTags
      */
+    @Deprecated(message="Operation is deprecated")
     fun findPetsByTags(tags: kotlin.collections.List<kotlin.String>): List<Pet>
 
     /**

diff --git a/...otlin-springboot-source-swagger2/src/main/kotlin/org/openapitools/api/PetApiController.kt b/...otlin-springboot-source-swagger2/src/main/kotlin/org/openapitools/api/PetApiController.kt
@@ -104,6 +104,7 @@ class PetApiController(@Autowired(required = true) val service: PetApiService) {
             ApiResponse(responseCode = "400", description = "Invalid tag value") ],
         security = [ SecurityRequirement(name = "petstore_auth", scopes = [ "write:pets", "read:pets" ]) ]
     )
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...e/kotlin-springboot-source-swagger2/src/main/kotlin/org/openapitools/api/PetApiService.kt b/...e/kotlin-springboot-source-swagger2/src/main/kotlin/org/openapitools/api/PetApiService.kt
@@ -45,6 +45,7 @@ interface PetApiService {
      * @deprecated
      * @see PetApi#findPetsByTags
      */
+    @Deprecated(message="Operation is deprecated")
     fun findPetsByTags(tags: kotlin.collections.List<kotlin.String>): List<Pet>
 
     /**

diff --git a/...tore/kotlin-springboot-springfox/src/main/kotlin/org/openapitools/api/PetApiController.kt b/...tore/kotlin-springboot-springfox/src/main/kotlin/org/openapitools/api/PetApiController.kt
@@ -109,6 +109,7 @@ class PetApiController(@Autowired(required = true) val service: PetApiService) {
         authorizations = [Authorization(value = "petstore_auth", scopes = [AuthorizationScope(scope = "write:pets", description = "modify pets in your account"), AuthorizationScope(scope = "read:pets", description = "read your pets")])])
     @ApiResponses(
         value = [ApiResponse(code = 200, message = "successful operation", response = Pet::class, responseContainer = "List"),ApiResponse(code = 400, message = "Invalid tag value")])
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...etstore/kotlin-springboot-springfox/src/main/kotlin/org/openapitools/api/PetApiService.kt b/...etstore/kotlin-springboot-springfox/src/main/kotlin/org/openapitools/api/PetApiService.kt
@@ -45,6 +45,7 @@ interface PetApiService {
      * @deprecated
      * @see PetApi#findPetsByTags
      */
+    @Deprecated(message="Operation is deprecated")
     fun findPetsByTags(tags: kotlin.collections.List<kotlin.String>): List<Pet>
 
     /**

diff --git a/...erver/petstore/kotlin-springboot/src/main/kotlin/org/openapitools/api/PetApiController.kt b/...erver/petstore/kotlin-springboot/src/main/kotlin/org/openapitools/api/PetApiController.kt
@@ -69,6 +69,7 @@ class PetApiController(@Autowired(required = true) val service: PetApiService) {
     }
 
 
+    @Deprecated(message="Operation is deprecated")
     @RequestMapping(
         method = [RequestMethod.GET],
         // "/pet/findByTags"

diff --git a/...s/server/petstore/kotlin-springboot/src/main/kotlin/org/openapitools/api/PetApiService.kt b/...s/server/petstore/kotlin-springboot/src/main/kotlin/org/openapitools/api/PetApiService.kt
@@ -45,6 +45,7 @@ interface PetApiService {
      * @deprecated
      * @see PetApi#findPetsByTags
      */
+    @Deprecated(message="Operation is deprecated")
     fun findPetsByTags(tags: kotlin.collections.List<kotlin.String>): List<Pet>
 
     /**