openapi: 3.0.3
info:
  title: announcementService
  description: Announcing patchnotes for KanzleiApp
  version: 1.0.0
paths:
  /patchnotes:
    post:
      tags:
        - Patchnotes
      description: creates new Patch notes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/patch_notes'
      responses:
        "200":
          description: game created
          content:
            application/json:
              schema:
                  $ref: '#/components/schemas/patch_notes'
        "400":
          description: bad payload
    get:
      description: returns list of all Patch notes
      responses:
        "200":
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/patch_notes'
          description: returns list of all unseen Patch notes from the user
        "404":
          description: no Patch notes found
      tags:
        - Patchnotes
      x-openapi-router-controller: openapi_server.controllers.patchnotes_controller
  /patchnotes/{patchID}:
    put:
      tags:
        - Patchnotes
      description: Updates one Patch
      parameters:
        - in: path
          name: patchID
          required: true
          schema:
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/patch_notes'
      responses:
        "200":
          description: patch updated
        "404":
          description: no patch found
    delete:
      tags:
        - Patchnotes
      description: deletes one Patch note
      parameters:
        - in: path
          name: patchID
          required: true
          schema:
            format: uuid
            type: string
          style: simple
      responses:
        "200":
          description: patch successfully deleted
        "404":
          description: patch not found
  /patchnotes/{date}:
    get:
      description: returns list of all unseen Patch notes from the user
      parameters:
        - explode: false
          in: path
          name: date
          required: true
          schema:
            format: date
            type: string
          style: simple
          example: 2025-01-02
      responses:
        "200":
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/patch_notes'
          description: returns list of all unseen Patch notes from the user
        "404":
          description: no Patch notes found
      tags:
        - Patchnotes
      x-openapi-router-controller: openapi_server.controllers.patchnotes_controller
components:
  schemas:
    patch_notes:
      example:
        patchID: 29e80bcc-5981-4a52-99e1-373442dea9b9
        title: Patch note 1
        changes: changes
        version: 1.0.0
        date: 2025-01-02
      properties:
        patchID:
          format: uuid
          title: patchID
          type: string
        title:
          type: string
          title: title
        changes:
          type: string
          title: changes
        version:
          type: string
          title: version
        patch_date:
          title: patch_date
          type: string
      required:
        - "title"
        - "changes"
        - "patch_date"
        - "version"
    user:
      example:
        lastSeenDate: 2025-01-02
      properties:
        lastSeenDate:
          format: date
          title: lastNoteChecked
          type: string