"openapi": "3.1.0"
"info":
  "title": "WebhookLab API"
  "version": "1.0.0"
  "description": "Webhook simulation, signature generation and verification, delivery tracking, replay, contract testing, MCP integration, and PlatPhorm discovery for webhooks.platphormnews.com."
"servers":
  - 
    "url": "https://webhooks.platphormnews.com"
"tags":
  - 
    "name": "Discovery"
    "description": "Public-safe service metadata and route discovery."
  - 
    "name": "Webhooks"
    "description": "Webhook event, endpoint, receive, and delivery APIs."
  - 
    "name": "Signatures"
    "description": "Public-safe HMAC signature utilities. Secrets are never persisted."
  - 
    "name": "Contracts"
    "description": "Webhook contract creation and payload validation."
  - 
    "name": "Delivery Jobs"
    "description": "Async webhook delivery job APIs."
  - 
    "name": "Integrations"
    "description": "Spec, Evals, Sandbox, AgentUI, Monitor, Trace, MCP, API, CLI, Docs, Sheets, and Decks handoffs."
  - 
    "name": "Agent Policy"
    "description": "Public-safe agent policy, robots, AI, trust, and platform access metadata."
  - 
    "name": "Reports"
    "description": "Protected report export APIs."
  - 
    "name": "Agent"
    "description": "Agent-operable action surface with protected mutation gating."
  - 
    "name": "MCP"
    "description": "JSON-RPC MCP endpoint."
"components":
  "securitySchemes":
    "platphormApiKeyHeader":
      "type": "apiKey"
      "in": "header"
      "name": "X-PlatPhorm-API-Key"
    "platphormApiKeyBearer":
      "type": "http"
      "scheme": "bearer"
      "bearerFormat": "PLATPHORM_API_KEY"
  "schemas":
    "ApiSuccess":
      "type": "object"
      "required":
        - "ok"
        - "data"
      "properties":
        "ok":
          "const": true
        "data":

    "ApiError":
      "type": "object"
      "required":
        - "ok"
        - "error"
      "properties":
        "ok":
          "const": false
        "error":
          "type": "object"
          "required":
            - "code"
            - "message"
          "properties":
            "code":
              "type": "string"
            "message":
              "type": "string"
            "details":

    "Health":
      "type": "object"
      "properties":
        "status":
          "enum":
            - "healthy"
            - "degraded"
        "service":
          "const": "webhooklab"
        "version":
          "type": "string"
        "timestamp":
          "type": "string"
          "format": "date-time"
        "checks":
          "type": "object"
        "routes":
          "type": "object"
    "Capabilities":
      "type": "object"
      "properties":
        "schemaVersion":
          "const": "platphorm-capabilities.v1"
        "site":
          "type": "object"
        "summary":
          "type": "object"
        "routes":
          "type": "array"
          "items":
            "type": "object"
        "capabilities":
          "type": "array"
          "items":
            "type": "object"
        "degradedFeatures":
          "type": "array"
          "items":
            "type": "object"
    "WebhookEventInput":
      "type": "object"
      "required":
        - "eventType"
        - "payload"
      "properties":
        "eventType":
          "type": "string"
          "example": "user.created"
        "payload":
          "type": "object"
          "additionalProperties": true
        "endpointId":
          "type": "string"
          "format": "uuid"
        "simulated":
          "type": "boolean"
          "default": true
    "EndpointRegistrationInput":
      "type": "object"
      "required":
        - "name"
        - "url"
        - "events"
      "properties":
        "name":
          "type": "string"
          "example": "Production Webhook"
        "url":
          "type": "string"
          "format": "uri"
          "example": "https://example.com/webhooks"
        "events":
          "type": "array"
          "items":
            "type": "string"
          "example":
            - "user.created"
        "signingAlgorithm":
          "enum":
            - "sha256"
            - "sha512"
          "default": "sha256"
    "Delivery":
      "type": "object"
      "properties":
        "id":
          "type": "string"
        "event_id":
          "type": "string"
        "endpoint_id":
          "type": "string"
        "status":
          "type": "string"
        "trace_id":
          "type": "string"
        "signatureConfigured":
          "type": "boolean"
    "ContractInput":
      "type": "object"
      "required":
        - "name"
        - "contractData"
      "properties":
        "name":
          "type": "string"
        "description":
          "type": "string"
        "contractData":
          "type": "object"
          "additionalProperties": true
        "testCases":
          "type": "array"
          "items":
            "type": "object"
    "SignatureGenerateInput":
      "type": "object"
      "required":
        - "payload"
      "properties":
        "payload":
          "type": "object"
          "additionalProperties": true
        "secret":
          "type": "string"
          "description": "Transient signing secret. It is never persisted or returned."
        "algorithm":
          "enum":
            - "sha256"
            - "sha512"
          "default": "sha256"
    "SignatureVerifyInput":
      "type": "object"
      "required":
        - "signature"
        - "payload"
      "properties":
        "signature":
          "type": "string"
          "example": "t=1234567890,v1=abc123"
        "payload":
          "type": "object"
          "additionalProperties": true
        "secret":
          "type": "string"
          "description": "Transient signing secret. It is never persisted or returned."
        "algorithm":
          "enum":
            - "sha256"
            - "sha512"
          "default": "sha256"
        "tolerance":
          "type": "integer"
          "default": 300
    "AgentActionInput":
      "type": "object"
      "required":
        - "action"
      "properties":
        "action":
          "type": "string"
          "example": "generate_test_payload"
        "params":
          "type": "object"
          "additionalProperties": true
    "McpRequest":
      "type": "object"
      "required":
        - "jsonrpc"
        - "method"
      "properties":
        "jsonrpc":
          "const": "2.0"
        "id":
          "oneOf":
            - 
              "type": "string"
            - 
              "type": "integer"
        "method":
          "type": "string"
          "example": "tools/list"
        "params":
          "type": "object"
          "additionalProperties": true
  "responses":
    "Unauthorized":
      "description": "Protected action requires PLATPHORM_API_KEY."
      "content":
        "application/json":
          "schema":
            "$ref": "#/components/schemas/ApiError"
    "ValidationError":
      "description": "Request validation failed."
      "content":
        "application/json":
          "schema":
            "$ref": "#/components/schemas/ApiError"
"paths":
  "/api/health":
    "get":
      "tags":
        - "Discovery"
      "summary": "Service health"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "allOf":
                  - 
                    "$ref": "#/components/schemas/ApiSuccess"
                  - 
                    "type": "object"
                    "properties":
                      "data":
                        "$ref": "#/components/schemas/Health"
  "/api/v1/health":
    "get":
      "tags":
        - "Discovery"
      "summary": "Service health alias"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "allOf":
                  - 
                    "$ref": "#/components/schemas/ApiSuccess"
                  - 
                    "type": "object"
                    "properties":
                      "data":
                        "$ref": "#/components/schemas/Health"
  "/api/capabilities":
    "get":
      "tags":
        - "Discovery"
      "summary": "PlatPhorm capability metadata"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "allOf":
                  - 
                    "$ref": "#/components/schemas/ApiSuccess"
                  - 
                    "type": "object"
                    "properties":
                      "data":
                        "$ref": "#/components/schemas/Capabilities"
  "/.well-known/platphorm.json":
    "get":
      "tags":
        - "Discovery"
      "summary": "PlatPhorm site manifest"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/api/docs":
    "get":
      "tags":
        - "Discovery"
      "summary": "OpenAPI document"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/api/v1/docs":
    "get":
      "tags":
        - "Discovery"
      "summary": "OpenAPI document alias"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/openapi.yaml":
    "get":
      "tags":
        - "Discovery"
      "summary": "OpenAPI YAML document"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/openapi.json":
    "get":
      "tags":
        - "Discovery"
      "summary": "OpenAPI JSON document"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/api/openapi.json":
    "get":
      "tags":
        - "Discovery"
      "summary": "OpenAPI JSON alias"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/llms.txt":
    "get":
      "tags":
        - "Discovery"
      "summary": "Readable llms context"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/llms-full.txt":
    "get":
      "tags":
        - "Discovery"
      "summary": "Full llms context"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/llms-index.json":
    "get":
      "tags":
        - "Discovery"
      "summary": "Machine-readable llms index"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/robots.txt":
    "get":
      "tags":
        - "Discovery"
      "summary": "Crawler policy"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/sitemap.xml":
    "get":
      "tags":
        - "Discovery"
      "summary": "Public route sitemap"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/sitemap-main.xml":
    "get":
      "tags":
        - "Discovery"
      "summary": "Main sitemap alias"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/sitemap-index.xml":
    "get":
      "tags":
        - "Discovery"
      "summary": "Sitemap index"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/rss.xml":
    "get":
      "tags":
        - "Discovery"
      "summary": "Public-safe RSS feed"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/feed.xml":
    "get":
      "tags":
        - "Discovery"
      "summary": "Public-safe Atom feed"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/.well-known/mcp.json":
    "get":
      "tags":
        - "Discovery"
      "summary": "MCP well-known descriptor"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/.well-known/agents.json":
    "get":
      "tags":
        - "Discovery"
      "summary": "Agent well-known descriptor"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/.well-known/agent-policy.json":
    "get":
      "tags":
        - "Discovery"
      "summary": "Agent policy"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/.well-known/ai-policy.json":
    "get":
      "tags":
        - "Discovery"
      "summary": "AI policy"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/.well-known/trust.json":
    "get":
      "tags":
        - "Discovery"
      "summary": "Trust policy"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/.well-known/security.txt":
    "get":
      "tags":
        - "Discovery"
      "summary": "Security contact"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/api/network/graph":
    "get":
      "tags":
        - "Discovery"
      "summary": "Public pointer to the canonical PlatPhorm network graph"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/api/v1/network/graph":
    "get":
      "tags":
        - "Discovery"
      "summary": "Public pointer to the canonical PlatPhorm network graph"
      "x-platphorm-public-safe": true
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
  "/api/v1/events":
    "get":
      "tags":
        - "Webhooks"
      "summary": "List webhook events"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
    "post":
      "tags":
        - "Webhooks"
      "summary": "Create webhook event"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody":
        "required": true
        "content":
          "application/json":
            "schema":
              "$ref": "#/components/schemas/WebhookEventInput"
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/events/{id}":
    "get":
      "tags":
        - "Webhooks"
      "summary": "Get webhook event"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
    "delete":
      "tags":
        - "Webhooks"
      "summary": "Delete webhook event"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/events/{id}/send":
    "post":
      "tags":
        - "Webhooks"
      "summary": "Send existing event to an endpoint"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/events/{id}/validate":
    "post":
      "tags":
        - "Webhooks"
      "summary": "Validate event payload against pasted schema"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/endpoints":
    "get":
      "tags":
        - "Webhooks"
      "summary": "List webhook endpoints with redaction"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
    "post":
      "tags":
        - "Webhooks"
      "summary": "Register webhook endpoint"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody":
        "required": true
        "content":
          "application/json":
            "schema":
              "$ref": "#/components/schemas/EndpointRegistrationInput"
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/endpoints/{id}":
    "get":
      "tags":
        - "Webhooks"
      "summary": "Get webhook endpoint with redaction"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
    "put":
      "tags":
        - "Webhooks"
      "summary": "Update webhook endpoint"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody":
        "required": true
        "content":
          "application/json":
            "schema":
              "$ref": "#/components/schemas/EndpointRegistrationInput"
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
    "delete":
      "tags":
        - "Webhooks"
      "summary": "Delete webhook endpoint"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/deliveries":
    "get":
      "tags":
        - "Webhooks"
      "summary": "List deliveries with redaction"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/deliveries/{id}":
    "get":
      "tags":
        - "Webhooks"
      "summary": "Get delivery with redaction"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/deliveries/{id}/attempts":
    "get":
      "tags":
        - "Webhooks"
      "summary": "List delivery attempts with redaction"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/deliveries/{id}/replay":
    "post":
      "tags":
        - "Webhooks"
      "summary": "Replay delivery"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/deliveries/{id}/cancel":
    "post":
      "tags":
        - "Webhooks"
      "summary": "Cancel delivery"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/deliveries/{id}/trace":
    "get":
      "tags":
        - "Webhooks"
      "summary": "Delivery trace timeline"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/deliveries/{id}/report":
    "get":
      "tags":
        - "Webhooks"
      "summary": "Public-safe delivery report"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/delivery-jobs":
    "get":
      "tags":
        - "Delivery Jobs"
      "summary": "List delivery jobs or degraded async-job state"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
    "post":
      "tags":
        - "Delivery Jobs"
      "summary": "Create delivery job"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/delivery-jobs/{id}":
    "get":
      "tags":
        - "Delivery Jobs"
      "summary": "Get delivery job"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/delivery-jobs/{id}/events":
    "get":
      "tags":
        - "Delivery Jobs"
      "summary": "Get delivery job events"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/delivery-jobs/{id}/stream":
    "get":
      "tags":
        - "Delivery Jobs"
      "summary": "Get delivery job stream or degraded stream state"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/delivery-jobs/{id}/complete":
    "post":
      "tags":
        - "Delivery Jobs"
      "summary": "Complete delivery job"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/delivery-jobs/{id}/fail":
    "post":
      "tags":
        - "Delivery Jobs"
      "summary": "Fail delivery job"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/delivery-jobs/{id}/cancel":
    "post":
      "tags":
        - "Delivery Jobs"
      "summary": "Cancel delivery job"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/contracts":
    "get":
      "tags":
        - "Contracts"
      "summary": "List contracts"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
    "post":
      "tags":
        - "Contracts"
      "summary": "Create contract"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody":
        "required": true
        "content":
          "application/json":
            "schema":
              "$ref": "#/components/schemas/ContractInput"
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/contracts/{id}":
    "get":
      "tags":
        - "Contracts"
      "summary": "Get contract"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
    "put":
      "tags":
        - "Contracts"
      "summary": "Update contract"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody":
        "required": true
        "content":
          "application/json":
            "schema":
              "$ref": "#/components/schemas/ContractInput"
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
    "delete":
      "tags":
        - "Contracts"
      "summary": "Delete contract"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/contracts/validate":
    "post":
      "tags":
        - "Contracts"
      "summary": "Validate pasted schema and payload locally"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/contracts/{id}/validate":
    "post":
      "tags":
        - "Contracts"
      "summary": "Validate payload against contract"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/contracts/{id}/test":
    "post":
      "tags":
        - "Contracts"
      "summary": "Run persistent contract test"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/contracts/{id}/generate-payload":
    "post":
      "tags":
        - "Contracts"
      "summary": "Generate sample payload"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/contracts/{id}/generate-negative-payload":
    "post":
      "tags":
        - "Contracts"
      "summary": "Generate negative test payload"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/contracts/{id}/send-to-spec":
    "post":
      "tags":
        - "Integrations"
      "summary": "Handoff contract to Spec or return local export"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/contracts/{id}/send-to-evals":
    "post":
      "tags":
        - "Integrations"
      "summary": "Handoff contract to Evals or return local export"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/contracts/{id}/send-to-sandbox":
    "post":
      "tags":
        - "Integrations"
      "summary": "Handoff contract to Sandbox or return local export"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/signatures/generate":
    "post":
      "tags":
        - "Signatures"
      "summary": "Generate HMAC signature"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody":
        "required": true
        "content":
          "application/json":
            "schema":
              "$ref": "#/components/schemas/SignatureGenerateInput"
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/signatures/verify":
    "post":
      "tags":
        - "Signatures"
      "summary": "Verify HMAC signature"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody":
        "required": true
        "content":
          "application/json":
            "schema":
              "$ref": "#/components/schemas/SignatureVerifyInput"
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/signatures/explain":
    "post":
      "tags":
        - "Signatures"
      "summary": "Explain signature mismatch"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody":
        "required": true
        "content":
          "application/json":
            "schema":
              "$ref": "#/components/schemas/SignatureVerifyInput"
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/signatures/algorithms":
    "get":
      "tags":
        - "Signatures"
      "summary": "List supported signature algorithms"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/receive/{endpointSlug}":
    "post":
      "tags":
        - "Webhooks"
      "summary": "Receive inbound webhook"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/receive/{endpointSlug}/status":
    "get":
      "tags":
        - "Webhooks"
      "summary": "Inbound receiver status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/templates":
    "get":
      "tags":
        - "Webhooks"
      "summary": "List public-safe event templates"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/templates/{eventType}":
    "get":
      "tags":
        - "Webhooks"
      "summary": "Get public-safe event template"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/templates/generate":
    "post":
      "tags":
        - "Webhooks"
      "summary": "Generate event payload from template"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations":
    "get":
      "tags":
        - "Integrations"
      "summary": "List integration matrix"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/status":
    "get":
      "tags":
        - "Integrations"
      "summary": "Get integration status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/spec":
    "get":
      "tags":
        - "Integrations"
      "summary": "Spec integration status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/spec/validate-contract":
    "post":
      "tags":
        - "Integrations"
      "summary": "Validate contract through Spec handoff or local export"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/evals":
    "get":
      "tags":
        - "Integrations"
      "summary": "Evals integration status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/evals/create-suite":
    "post":
      "tags":
        - "Integrations"
      "summary": "Create Evals suite or local export"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/sandbox":
    "get":
      "tags":
        - "Integrations"
      "summary": "Sandbox integration status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/sandbox/generate-receiver-test":
    "post":
      "tags":
        - "Integrations"
      "summary": "Generate Sandbox receiver test or local export"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/agentui":
    "get":
      "tags":
        - "Integrations"
      "summary": "AgentUI integration status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/agentui/generate-form":
    "post":
      "tags":
        - "Integrations"
      "summary": "Generate AgentUI form or local export"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/monitor":
    "get":
      "tags":
        - "Integrations"
      "summary": "Monitor integration status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/monitor/publish-status":
    "post":
      "tags":
        - "Integrations"
      "summary": "Publish Monitor status"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/integrations/trace":
    "get":
      "tags":
        - "Integrations"
      "summary": "Trace integration status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/mcp":
    "get":
      "tags":
        - "Integrations"
      "summary": "MCP integration status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/api":
    "get":
      "tags":
        - "Integrations"
      "summary": "API Hub integration status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/cli":
    "get":
      "tags":
        - "Integrations"
      "summary": "CLI integration status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/docs":
    "get":
      "tags":
        - "Integrations"
      "summary": "Docs integration status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/integrations/sheets":
    "get":
      "tags":
        - "Integrations"
      "summary": "Sheets integration status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/reports/docs":
    "post":
      "tags":
        - "Reports"
      "summary": "Create Docs report"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/reports/sheets":
    "post":
      "tags":
        - "Reports"
      "summary": "Create Sheets report"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/reports/decks":
    "post":
      "tags":
        - "Reports"
      "summary": "Create Deck summary"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/reports/{id}":
    "get":
      "tags":
        - "Reports"
      "summary": "Get report or degraded report state"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/agent-policy":
    "get":
      "tags":
        - "Agent Policy"
      "summary": "Get agent policy"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/agent-policy/platforms":
    "get":
      "tags":
        - "Agent Policy"
      "summary": "List agent platform categories"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/agent-policy/platforms/{id}":
    "get":
      "tags":
        - "Agent Policy"
      "summary": "Get agent platform category"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/agent-policy/robots":
    "get":
      "tags":
        - "Agent Policy"
      "summary": "Get robots policy summary"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/agent-policy/summary":
    "get":
      "tags":
        - "Agent Policy"
      "summary": "Get agent policy summary"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/webhooks":
    "get":
      "tags":
        - "Webhooks"
      "summary": "Vercel webhook receiver status"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
    "post":
      "tags":
        - "Webhooks"
      "summary": "Receive Vercel webhook"
      "security":
        - 
          "platphormApiKeyHeader":
[]
        - 
          "platphormApiKeyBearer":
[]
      "x-platphorm-public-safe": false
      "x-platphorm-protected": true
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
        "401":
          "$ref": "#/components/responses/Unauthorized"
  "/api/v1/agent":
    "get":
      "tags":
        - "Agent"
      "summary": "List agent actions and safety classification"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
    "post":
      "tags":
        - "Agent"
      "summary": "Execute agent action"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody":
        "required": true
        "content":
          "application/json":
            "schema":
              "$ref": "#/components/schemas/AgentActionInput"
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/mcp":
    "get":
      "tags":
        - "MCP"
      "summary": "MCP descriptor"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
    "post":
      "tags":
        - "MCP"
      "summary": "JSON-RPC MCP endpoint"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody":
        "required": true
        "content":
          "application/json":
            "schema":
              "$ref": "#/components/schemas/McpRequest"
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
  "/api/v1/mcp":
    "get":
      "tags":
        - "MCP"
      "summary": "MCP descriptor alias"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody": null
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
    "post":
      "tags":
        - "MCP"
      "summary": "JSON-RPC MCP endpoint alias"
      "security": null
      "x-platphorm-public-safe": true
      "x-platphorm-protected": false
      "requestBody":
        "required": true
        "content":
          "application/json":
            "schema":
              "$ref": "#/components/schemas/McpRequest"
      "responses":
        "200":
          "description": "OK"
          "content":
            "application/json":
              "schema":
                "$ref": "#/components/schemas/ApiSuccess"
        "400":
          "$ref": "#/components/responses/ValidationError"
"x-platphorm":
  "publicSafeAccess":
    - "homepage, docs, FAQ, OpenAPI, llms, RSS, sitemap, robots, and well-known policy files"
    - "Lab shell, local-only payload generation, public templates, JSON/schema validation, and transient signature utilities"
    - "redacted event, endpoint, delivery, contract, integration, health, and route-compliance summaries when storage is available"
    - "read-only MCP introspection and public-safe MCP tools"
  "protectedActions":
    - "persistent endpoint registration, update, and deletion"
    - "persistent event creation that sends to registered endpoints"
    - "third-party delivery attempts, replay, cancel, retry, and async delivery job mutation"
    - "contract create, update, delete, persistent test runs, and protected handoffs to Spec, Evals, Sandbox, AgentUI, Monitor, Docs, Sheets, and Decks"
    - "raw delivery details, raw request headers, private payloads, private traces, private audits, registry mutation, and report publishing"
  "integrationIds":
    - "spec"
    - "evals"
    - "sandbox"
    - "agentui"
    - "monitor"
    - "trace"
    - "mcp"
    - "api"
    - "docs"
    - "sheets"
    - "decks"
    - "cli"
  "authPolicy":
    "allowed":
      - "Authorization: Bearer $PLATPHORM_API_KEY"
      - "X-PlatPhorm-API-Key: $PLATPHORM_API_KEY"
    "disallowedSummary": "Generic, service-specific, or neighboring-service key headers are not platform auth."
  "redactionPolicy":
    "rawSecretsPublic": false
    "rawEndpointUrlsPublic": false
    "rawPayloadsPublic": false
    "rawVercelJa4DigestPublic": false
  "capabilities":
    - 
      "id": "webhook-simulation"
      "publicSafe": true
      "protected": false
      "status": "working"
    - 
      "id": "signature-generation"
      "publicSafe": true
      "protected": false
      "status": "working"
    - 
      "id": "signature-verification"
      "publicSafe": true
      "protected": false
      "status": "working"
    - 
      "id": "endpoint-registration"
      "publicSafe": false
      "protected": true
      "status": "working"
    - 
      "id": "event-creation-listing"
      "publicSafe": true
      "protected": true
      "status": "working"
    - 
      "id": "delivery-tracking"
      "publicSafe": true
      "protected": false
      "status": "working"
    - 
      "id": "delivery-replay"
      "publicSafe": false
      "protected": true
      "status": "working"
    - 
      "id": "contract-creation"
      "publicSafe": false
      "protected": true
      "status": "working"
    - 
      "id": "payload-validation"
      "publicSafe": true
      "protected": false
      "status": "working"
    - 
      "id": "vercel-webhook-receiver"
      "publicSafe": false
      "protected": true
      "status": "working"
    - 
      "id": "mcp-integration"
      "publicSafe": true
      "protected": false
      "status": "working"
    - 
      "id": "agent-endpoint"
      "publicSafe": true
      "protected": true
      "status": "working"
    - 
      "id": "docs-openapi"
      "publicSafe": true
      "protected": false
      "status": "working"
    - 
      "id": "discovery-files"
      "publicSafe": true
      "protected": false
      "status": "working"