NSwag Response Headers

I tried to use OpenApiResponse.Headers to define the response headers but it seems this functionality does not work as expected.

Actual:

responses:
        '200':
          description: OK
          headers:
              X-RateLimit-Limit:
                type: integer
                description: Request limit per hour

Expected:

responses:
        '200':
          description: OK
          headers:
            X-RateLimit-Limit:
              schema:
                type: integer
              description: Request limit per hour.

On top of that, NSwag has the following limitations in regard to response headers:

1. Cannot set header name
2. Cannot set header description

[cjlotz]

I think I figured it out. Adding the response header as an OpenApiParameter seems to generate the correct schema for a response header:

            var header = new OpenApiParameter
                            {
                                Schema = new JsonSchema { Type = JsonObjectType.Integer },
                                Example = 100,
                                Description = "Id of the resource created"
                            };         
            context.Document.Components.Headers.Add("ResourceId", header);

[davidkeaveny]

Thanks @cjlotz, your solution fixed my issue.