{
  "openapi": "3.1.0",
  "info": {
    "title": "Vitna Web API",
    "version": "1.0.0",
    "summary": "Web reading, extraction, crawling, structural change diffing, document parsing, claim verification, company dossiers, official public-registry data sources, and MCP tools.",
    "description": "Hosted at https://web.vitna.ai with invitation API keys (vitna_web_) or organization keys (vitna_key_). Every operation enforces public HTTPS targets, SSRF protection, per-key quotas, and explicit refusals rather than guesses.",
    "contact": {
      "name": "Vitna",
      "url": "https://vitna.ai/start#web"
    }
  },
  "externalDocs": {
    "description": "Full Markdown API reference",
    "url": "https://vitna.ai/docs/web/overview.md"
  },
  "servers": [
    {
      "url": "https://web.vitna.ai",
      "description": "Hosted Vitna Web API"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Read & Search",
      "description": "Render pages, batch scrape URLs, and query Vitna's web index"
    },
    {
      "name": "Extraction & Research",
      "description": "Selectors, JSON Schema extraction, product/company/catalog/careers/IR extraction, verification, and multi-hop research"
    },
    {
      "name": "Diff & Documents",
      "description": "Structural diff redlines and PDF/DOCX/XLSX/PPTX parsing and downloads"
    },
    {
      "name": "Intelligence & Enrichment",
      "description": "Company alt-data dossiers, cited entity-by-column enrichment grids, and structured firehose events"
    },
    {
      "name": "Site Mapping & Monitors",
      "description": "Site URL maps, background crawls, change monitors, recipes, and scheduled datasets"
    },
    {
      "name": "Official Sources",
      "description": "16 verified public-agency and regulatory data providers with typed contracts"
    },
    {
      "name": "Agent & Account",
      "description": "Streamable HTTP MCP server, account management, status, and usage"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "vitna_web_ or vitna_key_",
        "description": "Send Authorization: Bearer $VITNA_WEB_KEY (or organization key vitna_key_). Owner management routes use vitna_web_owner_ tokens."
      }
    },
    "responses": {
      "ErrorResponse": {
        "description": "Structured error envelope with machine-readable code and requestId.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        }
      }
    },
    "schemas": {
      "ErrorEnvelope": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "requestId": {
                "type": "string"
              },
              "durationMs": {
                "type": "integer"
              }
            }
          }
        }
      },
      "UrlRequest": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "render": {
            "type": "boolean",
            "default": true
          },
          "waitFor": {
            "type": "string"
          },
          "timeoutMs": {
            "type": "integer",
            "minimum": 1000,
            "maximum": 60000
          }
        }
      },
      "DiffRequest": {
        "type": "object",
        "properties": {
          "beforeUrl": {
            "type": "string",
            "format": "uri"
          },
          "beforeText": {
            "type": "string"
          },
          "afterUrl": {
            "type": "string",
            "format": "uri"
          },
          "afterText": {
            "type": "string"
          },
          "mode": {
            "type": "string",
            "enum": [
              "prose",
              "pricing",
              "policy",
              "risk_factors"
            ],
            "default": "prose"
          },
          "maxChanges": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200,
            "default": 50
          },
          "render": {
            "type": "boolean",
            "default": false
          }
        }
      },
      "ParseRequest": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "documentBase64": {
            "type": "string"
          },
          "filename": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "pdf",
              "docx",
              "xlsx",
              "pptx"
            ]
          },
          "format": {
            "type": "string",
            "enum": [
              "structured",
              "markdown",
              "both"
            ],
            "default": "both"
          },
          "maxPages": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "default": 100
          },
          "maxCharacters": {
            "type": "integer",
            "minimum": 100,
            "maximum": 1000000,
            "default": 200000
          },
          "render": {
            "type": "boolean",
            "default": false
          }
        }
      },
      "VerifyRequest": {
        "type": "object",
        "required": [
          "claim"
        ],
        "properties": {
          "claim": {
            "type": "string"
          },
          "urls": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            }
          },
          "query": {
            "type": "string"
          },
          "maxSources": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10,
            "default": 3
          },
          "minOverlap": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          }
        }
      },
      "EntityRequest": {
        "type": "object",
        "required": [
          "domain"
        ],
        "properties": {
          "domain": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "ticker": {
            "type": "string"
          },
          "modules": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "profile",
                "careers",
                "ir",
                "infra",
                "filings",
                "news"
              ]
            }
          },
          "maxItems": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 10
          }
        }
      },
      "GridRequest": {
        "type": "object",
        "required": [
          "entities",
          "columns"
        ],
        "properties": {
          "entities": {
            "type": "array",
            "minItems": 1,
            "maxItems": 100,
            "items": {
              "type": "object",
              "required": [
                "name"
              ],
              "properties": {
                "name": {
                  "type": "string"
                },
                "domain": {
                  "type": "string"
                },
                "ticker": {
                  "type": "string"
                }
              }
            }
          },
          "columns": {
            "type": "array",
            "minItems": 1,
            "maxItems": 10,
            "items": {
              "type": "object",
              "required": [
                "id",
                "strategy"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "strategy": {
                  "type": "string",
                  "enum": [
                    "entity",
                    "search",
                    "verify",
                    "source"
                  ]
                },
                "field": {
                  "type": "string"
                },
                "query": {
                  "type": "string"
                },
                "claim": {
                  "type": "string"
                },
                "provider": {
                  "type": "string"
                },
                "capability": {
                  "type": "string"
                },
                "options": {
                  "type": "object"
                }
              }
            }
          },
          "concurrency": {
            "type": "integer",
            "minimum": 1,
            "maximum": 4
          },
          "async": {
            "type": "boolean",
            "default": false
          },
          "jobTimeoutMs": {
            "type": "integer",
            "minimum": 1000,
            "maximum": 600000
          },
          "webhookUrl": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "PdfRequest": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "width": {
            "type": "integer",
            "minimum": 320,
            "maximum": 4096,
            "default": 1440
          },
          "height": {
            "type": "integer",
            "minimum": 240,
            "maximum": 4096,
            "default": 960
          },
          "pageRanges": {
            "type": "string",
            "description": "1-based page numbers or ranges such as 1-3 or 1-2,5."
          },
          "scale": {
            "type": "number",
            "minimum": 0.1,
            "maximum": 2,
            "description": "Page scale factor between 0.1 and 2."
          },
          "printBackground": {
            "type": "boolean",
            "default": true
          },
          "waitFor": {
            "type": "string"
          }
        }
      },
      "MonitorCreateRequest": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "page",
              "web"
            ],
            "default": "page"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "query": {
            "type": "string"
          },
          "intervalSeconds": {
            "type": "integer",
            "minimum": 60,
            "maximum": 2592000,
            "default": 3600
          },
          "diffMode": {
            "type": "string",
            "enum": [
              "prose",
              "pricing",
              "policy",
              "risk_factors"
            ]
          },
          "minMateriality": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "meaningfulChange": {
            "type": "object"
          },
          "selectors": {
            "type": "object"
          },
          "recipe": {
            "type": "string"
          },
          "webhookUrl": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "IrRequest": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "kinds": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "presentation",
                "press_release",
                "financial_report",
                "transcript",
                "webcast",
                "other"
              ]
            }
          },
          "maxItems": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200,
            "default": 50
          },
          "followSections": {
            "type": "boolean",
            "default": true
          }
        }
      },
      "SourcesFindRequest": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "enum": [
              "government",
              "finance",
              "health",
              "security"
            ]
          },
          "provider": {
            "type": "string"
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 5
          }
        }
      },
      "SourcesRunRequest": {
        "type": "object",
        "required": [
          "provider",
          "capability"
        ],
        "properties": {
          "provider": {
            "type": "string"
          },
          "capability": {
            "type": "string"
          },
          "options": {
            "type": "object"
          }
        }
      }
    }
  },
  "paths": {
    "/healthz": {
      "get": {
        "tags": [
          "Agent & Account"
        ],
        "summary": "Service health probe",
        "security": [],
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/read": {
      "post": {
        "tags": [
          "Read & Search"
        ],
        "summary": "Read a public page or document as Markdown, text, or cleaned HTML",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UrlRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/scrape": {
      "post": {
        "tags": [
          "Read & Search"
        ],
        "summary": "Alias for POST /v1/read",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UrlRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/batch": {
      "post": {
        "tags": [
          "Read & Search"
        ],
        "summary": "Batch read up to 20 URLs synchronously or up to 100 URLs asynchronously",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "urls"
                ],
                "properties": {
                  "urls": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uri"
                    },
                    "minItems": 1,
                    "maxItems": 100
                  },
                  "format": {
                    "type": "string",
                    "enum": [
                      "markdown",
                      "text",
                      "html"
                    ],
                    "default": "markdown"
                  },
                  "async": {
                    "type": "boolean",
                    "default": false
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/search": {
      "post": {
        "tags": [
          "Read & Search"
        ],
        "summary": "Search Vitna's web index with optional live page scraping",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "query"
                ],
                "properties": {
                  "query": {
                    "type": "string"
                  },
                  "maxResults": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 5
                  },
                  "ranking": {
                    "type": "string",
                    "enum": [
                      "lexical",
                      "semantic"
                    ]
                  },
                  "scrape": {
                    "type": [
                      "boolean",
                      "object"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/extract": {
      "post": {
        "tags": [
          "Extraction & Research"
        ],
        "summary": "Extract structured fields via CSS selectors, JSON Schema, prompt, or saved recipe",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "format": "uri"
                  },
                  "urls": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uri"
                    }
                  },
                  "selectors": {
                    "type": "object"
                  },
                  "schema": {
                    "type": "object"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "recipe": {
                    "type": "string"
                  },
                  "async": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/product": {
      "post": {
        "tags": [
          "Extraction & Research"
        ],
        "summary": "Extract normalized product pricing, offers, stock, and variants",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UrlRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/company": {
      "post": {
        "tags": [
          "Extraction & Research"
        ],
        "summary": "Extract normalized company profile, locations, social links, and contact links",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UrlRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/catalog": {
      "post": {
        "tags": [
          "Extraction & Research"
        ],
        "summary": "Extract Shopify or WooCommerce store catalog products and variants",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UrlRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/careers": {
      "post": {
        "tags": [
          "Extraction & Research"
        ],
        "summary": "Extract open roles from Greenhouse, Lever, Ashby, Workable, Recruitee, or Personio boards",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UrlRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/ir": {
      "post": {
        "tags": [
          "Extraction & Research"
        ],
        "summary": "Discover presentations, earnings releases, reports, transcripts, and webcasts from Investor Relations sites",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IrRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/research": {
      "post": {
        "tags": [
          "Extraction & Research"
        ],
        "summary": "Run bounded multi-round extractive research across search hits or seed URLs",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "query"
                ],
                "properties": {
                  "query": {
                    "type": "string"
                  },
                  "urls": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uri"
                    }
                  },
                  "followLinks": {
                    "type": "boolean"
                  },
                  "schema": {
                    "type": "object"
                  },
                  "stream": {
                    "type": "boolean"
                  },
                  "async": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/verify": {
      "post": {
        "tags": [
          "Extraction & Research"
        ],
        "summary": "Deterministically verify a factual claim with verbatim evidence offsets and SHA-256 attestation",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VerifyRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/diff": {
      "post": {
        "tags": [
          "Diff & Documents"
        ],
        "summary": "Structural change detection and redlines across URLs or inline text with materiality scoring",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DiffRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/parse": {
      "post": {
        "tags": [
          "Diff & Documents"
        ],
        "summary": "Parse PDF, DOCX, XLSX, or PPTX into typed blocks, tables, markdown, and citation offsets",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ParseRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/screenshot": {
      "post": {
        "tags": [
          "Diff & Documents"
        ],
        "summary": "Capture a Chromium PNG or JPEG screenshot",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UrlRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/pdf": {
      "post": {
        "tags": [
          "Diff & Documents"
        ],
        "summary": "Render a page to PDF with pageRanges, scale, and printBackground controls",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PdfRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/documents": {
      "post": {
        "tags": [
          "Diff & Documents"
        ],
        "summary": "List or download PDF, DOCX, XLSX, and PPTX documents linked from a page",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UrlRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/entity": {
      "post": {
        "tags": [
          "Intelligence & Enrichment"
        ],
        "summary": "Build a live company digital footprint and alt-data dossier",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EntityRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/grid": {
      "post": {
        "tags": [
          "Intelligence & Enrichment"
        ],
        "summary": "Run sync or async cited entities-by-columns enrichment matrices",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GridRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/firehose": {
      "get": {
        "tags": [
          "Intelligence & Enrichment"
        ],
        "summary": "Cursor-based stream of freshly crawled Common Crawl news pages",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/firehose/events": {
      "get": {
        "tags": [
          "Intelligence & Enrichment"
        ],
        "summary": "Normalized public-registry and SEC EDGAR filing event feed",
        "parameters": [
          {
            "name": "topic",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated topics: cisa-kev, federal-register, fda-drug-recalls, fda-device-recalls, treasury-debt, sec-8k, sec-13d, sec-form4"
          },
          {
            "name": "since",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "description": "Inclusive lower bound date YYYY-MM-DD"
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "description": "Maximum records (1 to 100)"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/firehose/backfill": {
      "post": {
        "tags": [
          "Intelligence & Enrichment"
        ],
        "summary": "Start a domain backfill job from a Common Crawl archive",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "domain"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/map": {
      "post": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Map URLs discovered via links, sitemaps, and search",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UrlRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/crawl": {
      "post": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Start an asynchronous site crawl job",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UrlRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/jobs/{id}": {
      "get": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Poll crawl, batch, extract, catalog, grid, backfill, or research job status",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      },
      "delete": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Cancel a running or queued background job",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/monitors": {
      "get": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "List configured page and web search monitors",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      },
      "post": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Create a page monitor (supports typed diffMode + minMateriality) or search monitor",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MonitorCreateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/monitors/{id}": {
      "get": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Read a monitor and its check history",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      },
      "delete": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Delete a monitor",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/monitors/{id}/check": {
      "post": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Execute an immediate check for a monitor",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/recipes/draft": {
      "post": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Infer extraction selectors from labeled sample values on a page",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "url",
                  "fields"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/recipes": {
      "get": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "List saved extraction recipes",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      },
      "post": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Save a reusable extraction recipe",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "selectors"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/recipes/{id}": {
      "get": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Read a saved extraction recipe",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      },
      "delete": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Delete a saved extraction recipe",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/datasets": {
      "get": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "List scheduled datasets",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      },
      "post": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Create a scheduled collection dataset",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "source",
                  "key"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/datasets/{id}": {
      "get": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Read a dataset and its recent runs",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      },
      "delete": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Delete a dataset",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/datasets/{id}/run": {
      "post": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Trigger a dataset collection run",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/datasets/{id}/records": {
      "get": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Export dataset run records as JSONL or CSV",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/datasets/{id}/changes": {
      "get": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Read added, changed, and removed dataset records since a run cursor",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/published": {
      "get": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "List operator-published public datasets",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/published/{slug}": {
      "get": {
        "tags": [
          "Site Mapping & Monitors"
        ],
        "summary": "Read metadata and runs of a published dataset",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/sources": {
      "get": {
        "tags": [
          "Official Sources"
        ],
        "summary": "List all configured official data providers (free)",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/sources/{provider}": {
      "get": {
        "tags": [
          "Official Sources"
        ],
        "summary": "Read a provider's capabilities, schemas, and license terms (free)",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/sources/find": {
      "post": {
        "tags": [
          "Official Sources"
        ],
        "summary": "Rank official source capabilities matching a natural-language task (free)",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SourcesFindRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/sources/run": {
      "post": {
        "tags": [
          "Official Sources"
        ],
        "summary": "Execute an official source capability with typed options",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SourcesRunRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/mcp": {
      "post": {
        "tags": [
          "Agent & Account"
        ],
        "summary": "Stateless Streamable HTTP MCP server exposing 25 tools",
        "description": "Supports MCP protocol versions 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26. See https://web.vitna.ai/.well-known/mcp.json for tool schemas.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "jsonrpc",
                  "method"
                ],
                "properties": {
                  "jsonrpc": {
                    "type": "string",
                    "enum": [
                      "2.0"
                    ]
                  },
                  "id": {
                    "type": [
                      "string",
                      "integer"
                    ]
                  },
                  "method": {
                    "type": "string"
                  },
                  "params": {
                    "type": "object"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/browser": {
      "get": {
        "tags": [
          "Agent & Account"
        ],
        "summary": "Upgrade to an authenticated Chrome DevTools Protocol WebSocket browser session",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/sessions/{id}": {
      "delete": {
        "tags": [
          "Agent & Account"
        ],
        "summary": "Clear persisted state for a sticky browser session",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/status": {
      "get": {
        "tags": [
          "Agent & Account"
        ],
        "summary": "Read live enabled capabilities, engines, limits, and active sources for your key",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/usage": {
      "get": {
        "tags": [
          "Agent & Account"
        ],
        "summary": "Read current UTC day usage, quota limits, and recent operation log",
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/accounts/activate": {
      "post": {
        "tags": [
          "Agent & Account"
        ],
        "summary": "Redeem a private invitation activation token for an API key and owner token",
        "security": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "activationToken"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    },
    "/v1/accounts/signup": {
      "get": {
        "tags": [
          "Agent & Account"
        ],
        "summary": "Report whether public signup is enabled",
        "security": [],
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      },
      "post": {
        "tags": [
          "Agent & Account"
        ],
        "summary": "Self-serve signup when enabled",
        "security": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful JSON response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "401": {
            "$ref": "#/components/responses/ErrorResponse"
          },
          "429": {
            "$ref": "#/components/responses/ErrorResponse"
          }
        }
      }
    }
  },
  "x-vitna-sources": {
    "totalProviders": 16,
    "totalCapabilities": 40,
    "providers": [
      {
        "id": "federal-register",
        "name": "Federal Register",
        "category": "government",
        "publisher": "Office of the Federal Register (National Archives) and the U.S. Government Publishing Office",
        "capabilities": [
          "documents/search",
          "documents/get"
        ]
      },
      {
        "id": "ecfr",
        "name": "Electronic Code of Federal Regulations",
        "category": "government",
        "publisher": "Office of the Federal Register (National Archives) and the U.S. Government Publishing Office",
        "capabilities": [
          "sections/search",
          "sections/text"
        ]
      },
      {
        "id": "usaspending",
        "name": "USAspending.gov",
        "category": "government",
        "publisher": "Bureau of the Fiscal Service, U.S. Department of the Treasury",
        "capabilities": [
          "awards/search",
          "agencies/list"
        ]
      },
      {
        "id": "sec-edgar",
        "name": "SEC EDGAR",
        "category": "finance",
        "publisher": "U.S. Securities and Exchange Commission",
        "capabilities": [
          "companies/lookup",
          "filings/recent",
          "facts/concept",
          "filings/search"
        ]
      },
      {
        "id": "openfda",
        "name": "openFDA",
        "category": "health",
        "publisher": "U.S. Food and Drug Administration",
        "capabilities": [
          "drugs/labels",
          "drugs/reactions",
          "recalls/search",
          "devices/events",
          "drugs/recalls",
          "devices/recalls"
        ]
      },
      {
        "id": "clinicaltrials",
        "name": "ClinicalTrials.gov",
        "category": "health",
        "publisher": "National Library of Medicine, U.S. National Institutes of Health",
        "capabilities": [
          "studies/search",
          "studies/get"
        ]
      },
      {
        "id": "cisa-kev",
        "name": "CISA Known Exploited Vulnerabilities",
        "category": "security",
        "publisher": "Cybersecurity and Infrastructure Security Agency (CISA)",
        "capabilities": [
          "catalog/search",
          "catalog/summary"
        ]
      },
      {
        "id": "fred",
        "name": "FRED (Federal Reserve Economic Data)",
        "category": "finance",
        "publisher": "Federal Reserve Bank of St. Louis",
        "capabilities": [
          "series/observations"
        ]
      },
      {
        "id": "finra",
        "name": "FINRA Reg SHO Short Sale Volume",
        "category": "finance",
        "publisher": "Financial Industry Regulatory Authority (FINRA)",
        "capabilities": [
          "short-volume/ticker",
          "short-volume/top"
        ]
      },
      {
        "id": "treasury",
        "name": "U.S. Treasury Fiscal Data",
        "category": "finance",
        "publisher": "U.S. Department of the Treasury",
        "capabilities": [
          "debt/daily",
          "cash/tga",
          "rates/average"
        ]
      },
      {
        "id": "nyfed",
        "name": "Federal Reserve Bank of New York Markets",
        "category": "finance",
        "publisher": "Federal Reserve Bank of New York",
        "capabilities": [
          "rates/sofr",
          "rates/effr",
          "operations/rrp"
        ]
      },
      {
        "id": "bls",
        "name": "Bureau of Labor Statistics (BLS)",
        "category": "government",
        "publisher": "U.S. Bureau of Labor Statistics",
        "capabilities": [
          "series/observations",
          "series/latest"
        ]
      },
      {
        "id": "courtlistener",
        "name": "CourtListener",
        "category": "government",
        "publisher": "Free Law Project",
        "capabilities": [
          "courts/list",
          "opinions/search",
          "dockets/search"
        ]
      },
      {
        "id": "fcc",
        "name": "FCC ECFS (Electronic Comment Filing System)",
        "category": "government",
        "publisher": "Federal Communications Commission",
        "capabilities": [
          "filings/search",
          "proceedings/search"
        ]
      },
      {
        "id": "eia",
        "name": "U.S. Energy Information Administration (EIA)",
        "category": "finance",
        "publisher": "U.S. Energy Information Administration",
        "capabilities": [
          "energy/inventory",
          "electricity/demand"
        ]
      },
      {
        "id": "dol-h1b",
        "name": "U.S. H-1B & OFLC Talent Filings",
        "category": "government",
        "publisher": "U.S. Citizenship and Immigration Services / Department of Labor",
        "capabilities": [
          "employers/approvals",
          "lca/search"
        ]
      }
    ]
  },
  "x-vitna-discovery": {
    "llmsTxt": "https://web.vitna.ai/llms.txt",
    "siteLlmsTxt": "https://vitna.ai/llms.txt",
    "llmsFullTxt": "https://vitna.ai/llms-full.txt",
    "mcp": "https://web.vitna.ai/.well-known/mcp.json",
    "agentCard": "https://web.vitna.ai/.well-known/agent-card.json",
    "playground": "https://vitna.ai/apis"
  }
}
