openapi: 3.1.0
info:
  title: PlatPhorm Decks API
  version: 0.6.0
  description: Cinematic presentation and slide delivery for the PlatPhormNews network, with reusable scroll-driven visual storytelling components.
servers:
  - url: https://decks.platphormnews.com
paths:
  /api/health:
    get:
      summary: Read service health
      responses:
        '200': { description: Standard health envelope }
  /api/slides:
    get:
      summary: Read the production slide registry
      responses:
        '200': { description: Registered slides }
  /api/mcp:
    get:
      summary: Read MCP metadata
      responses:
        '200': { description: MCP metadata }
    post:
      summary: Invoke the JSON-RPC 2.0 MCP server
      responses:
        '200': { description: JSON-RPC response }
  /api/network/register:
    post:
      summary: Register Decks with the network graph
      security:
        - PlatPhormBearer: []
        - PlatPhormApiKey: []
      responses:
        '200': { description: Registration result }
        '401': { description: PLATPHORM_API_KEY required }
components:
  securitySchemes:
    PlatPhormBearer:
      type: http
      scheme: bearer
      description: 'Use Authorization: Bearer $PLATPHORM_API_KEY for protected actions.'
    PlatPhormApiKey:
      type: apiKey
      in: header
      name: X-PlatPhorm-API-Key
      description: 'Use X-PlatPhorm-API-Key: $PLATPHORM_API_KEY for protected actions.'
