openapi: 3.1.0
info:
  title: "[YOUR_PRODUCT_NAME] API"
  version: 0.1.0
  description: Placeholder OpenAPI document for [YOUR_PRODUCT_NAME].
servers:
  - url: https://api.example.com
    description: Placeholder production API server
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
security:
  - ApiKeyAuth: []
paths:
  /health:
    get:
      summary: Check service health
      description: Returns a basic health response for the placeholder API.
      operationId: getHealth
      responses:
        "200":
          description: Successful health response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: ok
  /users:
    get:
      summary: List users
      description: Returns a placeholder user list response.
      operationId: listUsers
      responses:
        "200":
          description: Successful user list response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: user_123
                        name:
                          type: string
                          example: Example User
