openapi: 3.2.0
info:
  title: AI Gateway MCP Server Context Map API
  description: Universal MCP Gateway with OAuth integration - Modern Architecture
  version: 2.0.3290
tags:
- name: Context Map
paths:
  /webhooks/context-map:
    post:
      tags:
      - Context Map
      summary: 'Git push-trigger: re-pull + reindex the Context Map (repo mode)'
      description: Git push webhook → re-pull + reindex (idempotent).
      operationId: context_map_webhook_webhooks_context_map_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/context-map/push:
    post:
      tags:
      - Context Map
      summary: 'Content-push: upsert/delete a page, set L0, or replace the whole map'
      description: 'Content-push feed → shared ingest gate → index.


        Payload contract (JSON):

        * ``{"path": "pages/shop.md", "content": ""}`` — upsert one page

        * ``{"path": "pages/shop.md", "deleted": true}`` — remove a page

        * ``{"path": "index.md", "content": ""}`` — set the L0 digest

        * ``{"content": ""}`` / raw body — replace the whole map


        Per-page is recommended; it splices into the inline corpus rather than

        replacing it. Auth is the secret header (never in the URL).'
      operationId: context_map_push_api_context_map_push_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}