OpenAPI: /// <response code="404">The web hook could not be found.</response> are missing from the generated output.

[niemyjski]

Is there an existing issue for this?

• I have searched the existing issues

Describe the bug

/// The web hook could not be found. are missing from the generated output. See [HttpGet("open-api-model-issue")]

Expected Behavior

These should just work out of the box.

Steps To Reproduce

Clone https://github.com/exceptionless/aspnet-core-net10-issues# and run it, hit the open api json endpoint.

Exceptions (if any)

No response

.NET Version

10 preview 6

Anything else?

MacOS Latest, Rider/VS Code

#62150

[martincostello]

/// The web hook could not be found. are missing from the generated output. See [HttpGet("open-api-model-issue")]

It isn't clear to me what the problem is here.

Please explain.

[niemyjski]

Sorry, should have been more specific. My expectation and what I've experienced with swagger is that /// <response code="404">The web hook could not be found.</response> would produce the same result as [ProducesResponseType(StatusCodes.Status404NotFound)] and would be shown under a responses object in open api.

They are not included, so if you were to generate an api, you wouldn't know what the expected status codes were.

[martincostello]

Ah OK. AFAIK, that's just a Swashbuckle-specific feature that someone added once upon a time, so this is basically a feature request rather than a bug.

[niemyjski]

But the open api docs on microsofts site says that's a valid xml comment type.

[martincostello]

Which page/site?