openapi: 3.1.0
info:
  title: "PlatPhorm SitemapOps API"
  version: "1.0.0"
  description: "SitemapOps is the route evidence engine for PlatPhormNews: it validates public routes, sitemaps, robots files, feeds, llms files, OpenAPI specs, MCP manifests, well-known policy files, canonicals, and source packets for SearchOps, TrustOps, AgentOps, and the root graph."
servers:
  - url: https://sitemapops.platphormnews.com
    description: Production
paths:
  /api/health:
    summary: /api/health
  /api/v1/health:
    summary: /api/v1/health
  /api/v1/services:
    summary: /api/v1/services
  /api/v1/network/graph:
    summary: /api/v1/network/graph
  /api/v1/network/services:
    summary: /api/v1/network/services
  /api/v1/network/evidence:
    summary: /api/v1/network/evidence
  /api/v1/searchops/source:
    summary: /api/v1/searchops/source
  /api/v1/searchops/routes:
    summary: /api/v1/searchops/routes
  /api/v1/searchops/canonicals:
    summary: /api/v1/searchops/canonicals
  /api/v1/searchops/feeds:
    summary: /api/v1/searchops/feeds
  /api/v1/trustops/source:
    summary: /api/v1/trustops/source
  /api/v1/trustops/route-evidence:
    summary: /api/v1/trustops/route-evidence
  /api/v1/trustops/policy-alignment:
    summary: /api/v1/trustops/policy-alignment
  /api/v1/trustops/public-protected-boundaries:
    summary: /api/v1/trustops/public-protected-boundaries
  /api/v1/agentops/source:
    summary: /api/v1/agentops/source
  /api/v1/agentops/tools:
    summary: /api/v1/agentops/tools
  /api/v1/agentops/routes:
    summary: /api/v1/agentops/routes
  /api/v1/agentops/actions:
    summary: /api/v1/agentops/actions
  /api/v1/agentops/policies:
    summary: /api/v1/agentops/policies
  /api/v1/integrations:
    summary: /api/v1/integrations
  /api/v1/integrations/status:
    summary: /api/v1/integrations/status
  /api/v1/webhooks/events:
    summary: /api/v1/webhooks/events
  /api/v1/trace/links:
    summary: /api/v1/trace/links
  /api/docs:
    summary: /api/docs
  /api/mcp:
    summary: /api/mcp
  /api/v1/validate/sitemap:
    summary: /api/v1/validate/sitemap
  /api/v1/validate/robots:
    summary: /api/v1/validate/robots
  /api/v1/validate/feed:
    summary: /api/v1/validate/feed
  /api/v1/validate/openapi:
    summary: /api/v1/validate/openapi
  /api/v1/validate/mcp:
    summary: /api/v1/validate/mcp
  /api/v1/validate/llms:
    summary: /api/v1/validate/llms
  /api/v1/validate/well-known:
    summary: /api/v1/validate/well-known
  /api/v1/validate/canonical:
    summary: /api/v1/validate/canonical
  /api/v1/validate/dead-links:
    summary: /api/v1/validate/dead-links
  /api/v1/network/dry-run-update:
    summary: /api/v1/network/dry-run-update
  /api/v1/scans:
    summary: /api/v1/scans
  /api/v1/reports/generate:
    summary: /api/v1/reports/generate
  /api/v1/network/refresh:
    summary: /api/v1/network/refresh
  /api/v1/searchops/publish:
    summary: /api/v1/searchops/publish
  /api/v1/trustops/publish:
    summary: /api/v1/trustops/publish
  /api/v1/agentops/publish:
    summary: /api/v1/agentops/publish
  /api/v1/reports/publish-docs:
    summary: /api/v1/reports/publish-docs
  /api/v1/reports/export-sheets:
    summary: /api/v1/reports/export-sheets
components:
  securitySchemes:
    PlatPhormApiKey:
      type: apiKey
      in: header
      name: X-PlatPhorm-API-Key
    PlatPhormBearer:
      type: http
      scheme: bearer