Controller Obsolete is not showing in openapi json

[Indoraptor1]

Is there an existing issue for this?

• I have searched the existing issues

Is your feature request related to a problem? Please describe the problem.

Im trying to mark my controller as Obsolete, but it is not visible in the openapi json.

        [HttpGet("teszt")]
        [EndpointDescription("Test Enpoint")]
        [Obsolete("Nem támogatott!")]
        public IActionResult GetTeszt()
        {
            return Ok("teszt");
        }

"/api/v{version}/servers/teszt": {
      "get": {
        "tags": [
          "Server"
        ],
        "description": "Test Enpoint",
        "parameters": [
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  }

Is there any built in way to mark endpoint as deprecated?

Describe the solution you'd like

deprecated: true is missing

Additional context

No response

[martincostello]

What OpenAPI framework are you using?
How do you configure it?

[Indoraptor1]

@martincostello
Hello!
I'm using it like in the eShop sample (https://github.com/dotnet/eShop/tree/main/src/eShop.ServiceDefaults)

[xC0dex]

Hey @Indoraptor1,

I don't know if the Microsoft.AspNetCore.OpenApi package will get support for this, but meanwhile you could add a custom OpenApiOperationTransformer:

options.AddOperationTransformer((operation, context, _) =>
{
    var isObsolete = context.Description.ActionDescriptor.EndpointMetadata.OfType<ObsoleteAttribute>().Any();
    operation.Deprecated = isObsolete;
    return Task.CompletedTask;
});

[Indoraptor1]

@xC0dex
Thanks! It works!
One more question, if you can help me: I started to develop a personal .net 9 project, are Controllers better then something like this for a small project (5 enpoint category with 5-7 endpoints)?

[xC0dex]

Hey @Indoraptor1,

There’s no definitive right or wrong answer here. Choosing between Controllers and Minimal APIs in .NET has been a topic of debate since .NET 6, and both approaches have their strengths and trade-offs.

Personally, I prefer Minimal APIs!