Void with ResponseType attribute

[henkosch]

Take a look at the following snippet:

public class ValuesController : ApiController
{
    public void Put()
    {
    }

    [ResponseType(typeof(void))]
    public IHttpActionResult Post()
    {
        return StatusCode(HttpStatusCode.NoContent);
    }
}

I expect the two operation to have the same result in the responses field.

Both should have:

"responses":{"204":{"description":"No Content"}}

But instead the Post operation gets the following:

"responses":{"200":{"description":"OK","schema":{"$ref":"#/definitions/Void"}}}

This generates the following on swagger-ui:

Which is clearly wrong. I need the Post operation to have IHttpActionResult, so I can return with BadRequest() or Unauthorized() etc. That is why I used the ResponseType attribute to specify when it succeeds it should return 204 No content, without a schema reference.

How can I remove these strange "schema":{"$ref":"#/definitions/Void"} references from my operations?

[domaindrivendev]

This is a SB bug - just isnt handled because I never thought of the case where you would use ResponseType instead of void on the action signature. Simple fix ... will go out with next release

[domaindrivendev]

In the meantime, you could do the following as a workaround ...

[SwaggerResponseRemoveDefaults]
[SwaggerResponse(204, "No Content")]
public IHttpActionResult Post()
{
    ...
}

[domaindrivendev]

Should be resolved in latest release - 5.2.0

[dmyers]

Thanks I needed this too! Great release! 👍

[mc0re]

What about .NET Core version? It has no SwaggerResponseRemoveDefaults attribute, and [ProducesResponseType(StatusCodes.Status204NoContent, Type = typeof(void))] does not seem to work.