Glyph Glyph API

openapi: 3.2.0
info:
  title: Glyph API
  description: 'A language for agents: encode content into the cheapest substrate the reading model can parse, with honest per-reader token math. Fillin is the retrieval product — a time-series index of the dev internet that closes the gap between an LLM''s training cutoff and now.'
  version: 0.1.0
tags:
- name: Glyph
paths:
  /:
    get:
      summary: Root
      description: 'Host-split front doors.


        fillinmcp.com / www.fillinmcp.com → web/fillin.html (Fillin product).

        glyphapi.dev and every other Host (incl. TestClient''s testserver) →

        web/language.html (Glyph language page). The cinematic film stays at /film.

        nginx already forwards Host; no extra vhost required for the split.


        This is the durable replacement for the temporary fillinmcp.com

        `location = /` static file on the VPS. After this ships, glyphdesk

        removes that nginx override so `/` comes from uvicorn again.'
      operationId: root__get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Glyph
  /v2:
    get:
      summary: Legacy Funnels Redirect
      operationId: _legacy_funnels_redirect_v2_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Glyph
  /glyph:
    get:
      summary: Glyph Page
      description: Glyph photo-glyph surface. Fillin (the retrieval product) supplies the corpus.
      operationId: glyph_page_glyph_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Glyph
  /glyph/film:
    get:
      summary: Glyph Film
      description: 'Glyph — the cinematic scroll experience: the product''s pipeline (post-cutoff

        corpus → dense glyph → vision-model read → cited pieces → cross-model transfer)

        performed as a scroll-driven canvas film. Static asset; additive to /glyph.'
      operationId: glyph_film_glyph_film_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Glyph
  /v1/glyph:
    post:
      summary: Glyph Query Route
      description: 'Search, then return the result pieces as photo glyph image(s).


        Billed at the flat /query rate (the glyph render is free). Default returns

        JSON ({query, gap_days, n_results, glyph:{pages:[{png_b64,...}], manifest}}).

        Pass `?format=png&page=N` to get raw image/png bytes for one page instead.'
      operationId: glyph_query_route_v1_glyph_post
      security:
      - HTTPBearer: []
      parameters:
      - name: format
        in: query
        required: false
        schema:
          type: string
          default: json
          title: Format
      - name: page
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Page
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GlyphIn'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Glyph
  /v1/glyph/sample:
    get:
      summary: Glyph Sample Route
      description: 'Free, no-auth, no-corpus demo render. Lets an agent confirm its vision

        model can decode glyphs before paying, and powers the landing page.'
      operationId: glyph_sample_route_v1_glyph_sample_get
      parameters:
      - name: tier
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Tier
      - name: mode
        in: query
        required: false
        schema:
          type: string
          default: combined
          title: Mode
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Glyph
  /v1/glyph/sample.png:
    get:
      summary: Glyph Sample Png Route
      description: Raw image/png of the free sample render (page N).
      operationId: glyph_sample_png_route_v1_glyph_sample_png_get
      parameters:
      - name: tier
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Tier
      - name: page
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Page
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Glyph
components:
  schemas:
    GlyphIn:
      properties:
        cutoff:
          type: string
          format: date-time
          title: Cutoff
          description: ISO8601 — your model's training cutoff
        query:
          type: string
          maxLength: 512
          minLength: 1
          title: Query
        k:
          type: integer
          maximum: 20.0
          minimum: 1.0
          title: K
          default: 6
        tier:
          anyOf:
          - type: string
          - type: 'null'
          title: Tier
          description: 'Density tier: ''6x'' | ''10x'' | ''15x''. Default ''10x''.'
        mode:
          type: string
          title: Mode
          description: '''combined'' (all pieces on shared pages, token-efficient) or ''per_piece'' (one image per result).'
          default: combined
        sources:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Sources
          description: Optional source filter, same semantics as /query.
      type: object
      required:
      - cutoff
      - query
      title: GlyphIn
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer