openapi icon indicating copy to clipboard operation
openapi copied to clipboard

OpenAPI v3 cookie parameters not rendered

Open RonaldOlsthoorn opened this issue 1 year ago • 0 comments

I know I'm old-school using cookies. However, I still want to document their use. If I render the following v3 yaml file, no cookie parameter is rendered:

openapi: 3.0.3
info:
  title: Title - OpenAPI 3.0
  description: |-
    Description.
  version: 0.0.1
paths:
  /cat:
    get:
      summary: summary
      description: |
        Description
      parameters:
        - name: COOKIENAME
          in: cookie
          description: Description
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Cat'
components:
  schemas:
    Cat:
      type: object    
      properties:
        name:
          type: string
          description: name
          example: Simba

If I change parameter type from cookie to path it works. In the swagger editor it renders fine.

RonaldOlsthoorn avatar Jun 13 '24 09:06 RonaldOlsthoorn