openapi: 3.0.3
info:
  title: SQLite Vector MCP REST API
  version: 0.1.0
  description: |
    REST API for text-based insert/search backed by sqlite-vec.
    Note: Endpoints are planned and documented here.
servers:
  - url: http://localhost:3000
paths:
  /api/items:
    post:
      summary: Add item from text
      description: Generates embeddings from text and stores item + vector.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                content:
                  type: string
              required:
                - content
      responses:
        "200":
          description: Item created
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                  content:
                    type: string
        "400":
          description: Invalid request
  /api/search:
    post:
      summary: Search by text
      description: Generates embeddings from text and returns nearest items.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                content:
                  type: string
              required:
                - content
      responses:
        "200":
          description: Search results
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        content:
                          type: string
                        distance:
                          type: number
        "400":
          description: Invalid request