parameters:
  - in: path
    name: poll-id
    required: true
    schema:
      type: integer
      format: int64
get:
  operationId: get-poll
  summary: Gets a poll by ID
  responses:
    '200':
      description: OK
      content:
        application/json:
          schema:
            $ref: ../components/schemas/poll.yaml
    '404':
      $ref: ../components/responses/poll-not-found.yaml
patch:
  operationId: update-poll
  summary: Updates a poll
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: ../components/schemas/poll.yaml
  security:
    - {}
    - pollAuth: []
  responses:
    '200':
      description: OK
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: ../components/schemas/poll.yaml
delete:
  operationId: delete-poll
  summary: Deletes a poll
  responses:
    '200':
      description: OK
    '404':
      $ref: ../components/responses/poll-not-found.yaml
  security:
    - pollAuth: []