definma-api/oas/material.yaml

/material/{id}:
  parameters:
    - $ref: 'oas.yaml#/components/parameters/Id'
  get:
    summary: TODO get material details
    description: 'Auth: all, levels: read, write, maintain, dev, admin'
    tags:
      - /material
    responses:
      200:
        description: created material
        content:
          application/json:
            schema:
              $ref: 'oas.yaml#/components/schemas/Material'
      400:
        $ref: 'oas.yaml#/components/responses/400'
      401:
        $ref: 'oas.yaml#/components/responses/401'
      500:
        $ref: 'oas.yaml#/components/responses/500'
  put:
    summary: TODO add/change material
    description: 'Auth: basic, levels: write, maintain, dev, admin'
    tags:
      - /material
    security:
      - BasicAuth: []
    requestBody:
      required: true
      content:
        application/json:
          schema:
            $ref: 'oas.yaml#/components/schemas/Material'
    responses:
      200:
        description: material details
        content:
          application/json:
            schema:
              $ref: 'oas.yaml#/components/schemas/Material'
      400:
        $ref: 'oas.yaml#/components/responses/400'
      401:
        $ref: 'oas.yaml#/components/responses/401'
      403:
        $ref: 'oas.yaml#/components/responses/403'
      500:
        $ref: 'oas.yaml#/components/responses/500'
  delete:
    summary: TODO delete material
    description: 'Auth: basic, levels: write, maintain, dev, admin'
    tags:
      - /material
    security:
      - BasicAuth: []
    responses:
      200:
        $ref: 'oas.yaml#/components/responses/Ok'
      400:
        $ref: 'oas.yaml#/components/responses/400'
      401:
        $ref: 'oas.yaml#/components/responses/401'
      403:
        $ref: 'oas.yaml#/components/responses/403'
      500:
        $ref: 'oas.yaml#/components/responses/500'