custom-monad.yaml

openapi: 3.0.0
info:
  title: Custom Monad Spec
  version: 0.0.1
paths:
  /health:
    summary: Check health of the API
    get:
      responses:
        200:
          description: healthy
        503:
          description: unavailable
  /users:
    summary: List of all users
    get:
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: "#/components/schemas/user"
  /users/{id}:
    parameters:
      - $ref: "#/components/parameters/id"
    get:
      summary: Get user by ID
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/user"
        404:
          description: User not found
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/error"
components:
  schemas:
    user:
      type: object
      properties:
        name:
          type: string
        role:
          type: string
          enum: ["admin", "user"]
      required: ["name", "role"]
    error:
      type: object
      properties:
        message:
          type: string
  parameters:
    id:
      name: id
      in: path
      required: true
      schema:
        type: integer
        minimum: 1