{
  "openapi": "3.1.0",
  "info": {
    "title": "Goodbase Public API",
    "version": "1.2.0",
    "description": "Goodbase public API for GoodOS apps. All public endpoints require an API key using X-Goodbase-API-Key or Authorization: Bearer."
  },
  "servers": [
    {
      "url": "https://base.goodos.app/api/v1",
      "description": "GoodOS Production Public API"
    }
  ],
  "security": [
    {
      "GoodOSApiKey": []
    },
    {
      "GoodOSBearer": []
    }
  ],
  "components": {
    "securitySchemes": {
      "GoodOSApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Goodbase-API-Key"
      },
      "GoodOSBearer": {
        "type": "http",
        "scheme": "bearer"
      },
      "GoodBaseSession": {
        "type": "apiKey",
        "in": "cookie",
        "name": "goodos_session"
      }
    },
    "schemas": {
      "ApiKeyContext": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "scopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "allowedAppIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "SuccessResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        },
        "required": [
          "success"
        ]
      },
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "const": false
          },
          "message": {
            "type": "string"
          },
          "detail": {
            "type": "string"
          }
        }
      }
    }
  },
  "paths": {
    "/api/goodspeech/v1/health": {
      "get": {
        "summary": "Check the GoodSpeech Kokoro engine",
        "description": "Reports whether the authenticated GoodSpeech user can reach the configured private Kokoro inference service.",
        "servers": [
          {
            "url": "https://base.goodos.app"
          }
        ],
        "security": [
          {
            "GoodBaseSession": []
          },
          {
            "GoodOSBearer": []
          },
          {
            "GoodOSApiKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Kokoro is configured and ready"
          },
          "401": {
            "description": "Authentication required"
          },
          "503": {
            "description": "Kokoro is not configured, still starting, or unavailable"
          }
        }
      }
    },
    "/api/goodspeech/v1/capabilities": {
      "get": {
        "summary": "List GoodSpeech tool capabilities",
        "description": "Reports the authenticated GoodSpeech capability contract, including GoodBase-backed Kokoro tools, privacy-preserving browser tools, available personas, and genuine engine issues.",
        "servers": [
          {
            "url": "https://base.goodos.app"
          }
        ],
        "security": [
          {
            "GoodBaseSession": []
          },
          {
            "GoodOSBearer": []
          },
          {
            "GoodOSApiKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Capability contract returned"
          },
          "401": {
            "description": "Authentication required"
          }
        }
      }
    },
    "/api/goodspeech/v1/speech": {
      "post": {
        "summary": "Generate speech through GoodBase",
        "description": "Authenticated GoodSpeech generation through the private Kokoro service. Provider credentials remain server-side and voice cloning is unavailable.",
        "servers": [
          {
            "url": "https://base.goodos.app"
          }
        ],
        "security": [
          {
            "GoodBaseSession": []
          },
          {
            "GoodOSBearer": []
          },
          {
            "GoodOSApiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["text", "voice"],
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2000
                  },
                  "voice": {
                    "type": "object"
                  },
                  "style": {
                    "type": "string"
                  },
                  "tone": {
                    "type": "string"
                  },
                  "intensity": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "contextualExpressiveness": {
                    "type": "boolean"
                  },
                  "language": {
                    "type": "string",
                    "enum": ["en-us", "en-gb", "es", "fr-fr", "hi", "it", "ja-jp", "pt-br", "zh-cn"],
                    "default": "en-us"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Base64-encoded audio generated successfully"
          },
          "400": {
            "description": "Invalid input"
          },
          "401": {
            "description": "Authentication required"
          },
          "429": {
            "description": "Per-user generation limit exceeded"
          },
          "502": {
            "description": "Speech provider unavailable"
          },
          "503": {
            "description": "Speech provider is not configured"
          }
        }
      }
    },
    "/api/goodspeech/v1/speech/stream": {
      "post": {
        "summary": "Stream synthesized speech as PCM",
        "description": "Authenticated sentence-level PCM streaming through the private Kokoro worker. Usage is reserved before synthesis and metered only after successful delivery.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }, { "GoodOSApiKey": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["text", "voice"],
                "properties": {
                  "text": { "type": "string", "minLength": 1, "maxLength": 2000 },
                  "voice": { "type": "object" },
                  "style": { "type": "string" },
                  "tone": { "type": "string" },
                  "intensity": { "type": "integer", "minimum": 0, "maximum": 100 },
                  "contextualExpressiveness": { "type": "boolean" },
                  "language": {
                    "type": "string",
                    "enum": ["en-us", "en-gb", "es", "fr-fr", "hi", "it", "ja-jp", "pt-br", "zh-cn"],
                    "default": "en-us"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Little-endian signed 16-bit mono PCM stream at 24 kHz",
            "content": { "audio/pcm": { "schema": { "type": "string", "format": "binary" } } }
          },
          "400": { "description": "Invalid input" },
          "401": { "description": "Authentication required" },
          "429": { "description": "Rate or monthly usage quota exceeded" },
          "502": { "description": "Speech provider unavailable" },
          "503": { "description": "Streaming provider is not configured" }
        }
      }
    },
    "/api/goodspeech/v1/transcriptions/health": {
      "get": {
        "summary": "Check private managed GoodSpeech transcription",
        "description": "Reports whether the authenticated user can reach the revision-pinned Faster-Whisper service. The on-device Whisper path remains available independently.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }, { "GoodOSApiKey": [] }],
        "responses": {
          "200": { "description": "Managed transcription is ready" },
          "401": { "description": "Authentication required" },
          "403": { "description": "GoodSpeech entitlement required" },
          "503": { "description": "Managed transcription is loading or unavailable" }
        }
      }
    },
    "/api/goodspeech/v1/transcriptions": {
      "post": {
        "summary": "Transcribe audio with private managed Faster-Whisper",
        "description": "Accepts a bounded audio or audio-bearing video upload, applies voice activity detection, automatic or explicit language selection, optional keyterm prompting and stereo speaker labels, and returns segment/word timestamps plus bounded email, URL, phone, money, date, and keyterm entities. Uploaded audio is processed transiently and is not retained.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }, { "GoodOSApiKey": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": ["file"],
                "properties": {
                  "file": { "type": "string", "format": "binary", "description": "Audio or audio-bearing video, up to 50 MB" },
                  "language": { "type": "string", "default": "auto", "description": "Automatic detection or an ISO language code" },
                  "diarization": { "type": "string", "enum": ["none", "channels"], "default": "none", "description": "Label Speaker 1 and Speaker 2 when they are recorded on separate stereo channels" },
                  "keyterms": { "type": "string", "maxLength": 500, "description": "Up to 20 comma- or newline-separated names, brands, places, or domain terms used as a private decoding prompt" }
                }
              }
            }
          }
        },
        "responses": {
          "201": { "description": "Transcript with detected language, segments, and word timestamps" },
          "400": { "description": "Invalid or empty input" },
          "401": { "description": "Authentication required" },
          "403": { "description": "GoodSpeech entitlement required" },
          "413": { "description": "Upload exceeds 50 MB" },
          "415": { "description": "Unsupported media type or invalid file signature" },
          "429": { "description": "Transcription rate limit exceeded" },
          "502": { "description": "Managed transcription engine rejected the request" },
          "503": { "description": "Managed transcription is not configured" }
        }
      }
    },
    "/api/goodspeech/v1/transcriptions/live": {
      "post": {
        "summary": "Transcribe a rolling private microphone chunk",
        "description": "Accepts an independently playable microphone chunk from a live session and returns ordered partial or final Faster-Whisper text with timestamps. Chunks are processed transiently and are never retained.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }, { "GoodOSApiKey": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": ["file", "sessionId", "sequence"],
                "properties": {
                  "file": { "type": "string", "format": "binary", "description": "Self-contained audio chunk, up to 8 MB" },
                  "language": { "type": "string", "default": "auto" },
                  "sessionId": { "type": "string", "minLength": 8, "maxLength": 80 },
                  "sequence": { "type": "integer", "minimum": 0, "maximum": 10000 },
                  "final": { "type": "boolean", "default": false },
                  "keyterms": { "type": "string", "maxLength": 500, "description": "Up to 20 comma- or newline-separated decoding hints" }
                }
              }
            }
          }
        },
        "responses": {
          "201": { "description": "Ordered partial or final transcript chunk with segment and word timestamps" },
          "400": { "description": "Invalid live session metadata or empty chunk" },
          "401": { "description": "Authentication required" },
          "403": { "description": "GoodSpeech entitlement required" },
          "413": { "description": "Chunk exceeds 8 MB" },
          "429": { "description": "Live transcription safety limit exceeded" },
          "502": { "description": "Managed transcription engine rejected the chunk" }
        }
      }
    },


    "/api/goodspeech/v1/podcasts": {
      "get": { "summary": "List owner-scoped RSS podcast feeds", "servers": [{ "url": "https://base.goodos.app" }], "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }, { "GoodOSApiKey": [] }], "responses": { "200": { "description": "Podcast feeds and public RSS URLs" }, "401": { "description": "Authentication required" } } },
      "post": { "summary": "Create a revocable public RSS podcast feed", "servers": [{ "url": "https://base.goodos.app" }], "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }, { "GoodOSApiKey": [] }], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["title"], "properties": { "title": { "type": "string", "maxLength": 120 }, "description": { "type": "string", "maxLength": 1000 }, "author": { "type": "string", "maxLength": 120 }, "language": { "type": "string", "maxLength": 20 } } } } } }, "responses": { "201": { "description": "RSS feed created" }, "400": { "description": "Invalid feed metadata" }, "401": { "description": "Authentication required" } } }
    },
    "/api/goodspeech/v1/podcasts/{feedId}/episodes": {
      "post": { "summary": "Publish an owned GoodSpeech audio asset as an RSS episode", "servers": [{ "url": "https://base.goodos.app" }], "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }, { "GoodOSApiKey": [] }], "parameters": [{ "in": "path", "name": "feedId", "required": true, "schema": { "type": "string", "format": "uuid" } }], "responses": { "201": { "description": "Episode published" }, "404": { "description": "Feed or audio asset not found" }, "415": { "description": "Asset is not audio" } } }
    },
    "/api/goodspeech/v1/podcasts/{feedId}": {
      "delete": { "summary": "Revoke a public RSS feed", "servers": [{ "url": "https://base.goodos.app" }], "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }, { "GoodOSApiKey": [] }], "parameters": [{ "in": "path", "name": "feedId", "required": true, "schema": { "type": "string", "format": "uuid" } }], "responses": { "200": { "description": "Feed revoked" }, "404": { "description": "Feed not found" } } }
    },
    "/api/goodspeech/v1/podcasts/public/{token}/feed.xml": {
      "get": { "summary": "Read a public RSS 2.0 podcast feed", "servers": [{ "url": "https://base.goodos.app" }], "security": [], "parameters": [{ "in": "path", "name": "token", "required": true, "schema": { "type": "string", "minLength": 43, "maxLength": 43 } }], "responses": { "200": { "description": "RSS 2.0 XML with podcast enclosures" }, "404": { "description": "Feed not found or revoked" } } }
    },
    "/api/goodspeech/v1/podcasts/public/{token}/episodes/{episodeId}/audio": {
      "get": { "summary": "Stream audio for a published RSS episode", "servers": [{ "url": "https://base.goodos.app" }], "security": [], "parameters": [{ "in": "path", "name": "token", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "episodeId", "required": true, "schema": { "type": "string", "format": "uuid" } }], "responses": { "200": { "description": "Published audio bytes" }, "302": { "description": "Short-lived storage redirect" }, "404": { "description": "Episode not found or feed revoked" } } }
    },

    "/api/goodspeech/v1/usage": {
      "get": {
        "summary": "Read the signed-in user's GoodSpeech usage",
        "description": "Returns the current UTC billing period, successful and failed synthesis counts, characters, audio bytes, latency, enforced limits, remaining allowance, and beta pricing status.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }, { "GoodOSApiKey": [] }],
        "responses": {
          "200": { "description": "Owner-scoped GoodSpeech usage snapshot" },
          "401": { "description": "Authentication required" },
          "403": { "description": "Tenant or application access denied" }
        }
      }
    },

    "/api/goodspeech/v1/usage/preferences": {
      "get": {
        "summary": "Read the user's GoodSpeech usage safeguards",
        "description": "Returns owner-scoped monthly request and character budgets, the warning threshold, and the workspace maximums those budgets cannot exceed.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }, { "GoodOSApiKey": [] }],
        "responses": {
          "200": { "description": "Owner-scoped usage safeguard preferences" },
          "401": { "description": "Authentication required" },
          "403": { "description": "Tenant, application, or read scope denied" }
        }
      },
      "patch": {
        "summary": "Update the user's GoodSpeech usage safeguards",
        "description": "Sets enforceable monthly budgets and the early-warning threshold without allowing a user to expand the workspace maximums.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }, { "GoodOSApiKey": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["requestBudget", "characterBudget", "warningPercent"],
                "properties": {
                  "requestBudget": { "type": "integer", "minimum": 1 },
                  "characterBudget": { "type": "integer", "minimum": 1 },
                  "warningPercent": { "type": "integer", "minimum": 50, "maximum": 95 }
                }
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Usage safeguards saved" },
          "400": { "description": "Budget or warning threshold is outside the allowed range" },
          "401": { "description": "Authentication required" },
          "403": { "description": "Tenant, application, or write scope denied" }
        }
      }
    },

    "/api/goodspeech/v1/status": {
      "get": {
        "summary": "Check public GoodSpeech production readiness",
        "description": "Returns release identity and the readiness of the private speech, video, and avatar engines without exposing provider credentials.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [],
        "responses": {
          "200": { "description": "Primary Kokoro speech and supported browser fallbacks are ready; optional accelerators may be unavailable" },
          "503": { "description": "The primary Kokoro speech engine is unavailable" }
        }
      }
    },
    "/api/goodspeech/v1/voices/": {
      "get": {
        "summary": "List the signed-in user's private GoodSpeech voices",
        "description": "Returns owner-scoped designed and consent-verified cloned voices plus the current cloning consent statement.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": { "200": { "description": "Private voice registry" }, "401": { "description": "Authentication required" }, "403": { "description": "GoodSpeech access required" } }
      }
    },
    "/api/goodspeech/v1/voices/status": {
      "get": {
        "summary": "Check the consent-gated private cloning engine",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": { "200": { "description": "Pinned cloning model and watermark are ready" }, "503": { "description": "Cloning engine is starting or unavailable" } }
      }
    },
    "/api/goodspeech/v1/voices/clone": {
      "post": {
        "summary": "Create a consent-verified private instant voice clone",
        "description": "Requires an adult rights holder, the exact displayed consent phrase, and a 5.5–30 second PCM WAV sample. The sample is stored privately and may be revoked and deleted.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": ["reference", "name", "consentStatement", "identityAttested", "rightsAttested", "adultAttested"], "properties": { "reference": { "type": "string", "format": "binary" }, "name": { "type": "string", "maxLength": 80 }, "consentStatement": { "type": "string" }, "identityAttested": { "type": "boolean" }, "rightsAttested": { "type": "boolean" }, "adultAttested": { "type": "boolean" } } } } } },
        "responses": { "201": { "description": "Private clone enrolled" }, "400": { "description": "Invalid sample or consent" }, "413": { "description": "Sample too large" }, "415": { "description": "PCM WAV required" }, "422": { "description": "Consent attestations failed" } }
      }
    },
    "/api/goodspeech/v1/voices/design": {
      "post": {
        "summary": "Save a selected prompt-designed GoodSpeech voice candidate",
        "description": "Recomputes the reproducible candidate set and saves the selected original blend and pace recipe.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["name", "prompt"], "properties": { "name": { "type": "string", "maxLength": 80 }, "prompt": { "type": "string", "minLength": 8, "maxLength": 1000 }, "language": { "type": "string" }, "candidateId": { "type": "string", "enum": ["candidate-1", "candidate-2", "candidate-3"], "description": "Optional for backward compatibility; defaults to candidate-1." } } } } } },
        "responses": { "201": { "description": "Designed voice saved" }, "400": { "description": "Invalid design prompt" } }
      }
    },
    "/api/goodspeech/v1/voices/design/candidates": {
      "post": {
        "summary": "Generate three reproducible prompt-designed voice candidates",
        "description": "Returns three selectable candidate recipes. English candidates are original model-embedding blends; other languages use the available native voices and bounded delivery variations.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["prompt"], "properties": { "prompt": { "type": "string", "minLength": 8, "maxLength": 1000 }, "language": { "type": "string" } } } } } },
        "responses": { "200": { "description": "Three deterministic candidate recipes" }, "422": { "description": "Invalid design prompt" }, "429": { "description": "Rate limit exceeded" } }
      }
    },
    "/api/goodspeech/v1/voices/design/preview": {
      "post": {
        "summary": "Generate a private WAV preview for a designed voice candidate",
        "description": "Synthesizes the selected reproducible candidate without saving a voice profile. The preview is quota-metered, audited, and not retained.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["prompt", "candidateId", "text"], "properties": { "prompt": { "type": "string", "minLength": 8, "maxLength": 1000 }, "language": { "type": "string" }, "candidateId": { "type": "string", "enum": ["candidate-1", "candidate-2", "candidate-3"] }, "text": { "type": "string", "maxLength": 1000 } } } } } },
        "responses": { "200": { "description": "Private candidate WAV", "content": { "audio/wav": { "schema": { "type": "string", "format": "binary" } } } }, "422": { "description": "Invalid candidate" }, "429": { "description": "Rate or quota exceeded" } }
      }
    },
    "/api/goodspeech/v1/voices/{voiceId}/speech": {
      "post": {
        "summary": "Generate watermarked speech with a private voice",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "voiceId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["text"], "properties": { "text": { "type": "string", "maxLength": 2000 } } } } } },
        "responses": { "200": { "description": "Watermarked WAV", "content": { "audio/wav": { "schema": { "type": "string", "format": "binary" } } } }, "404": { "description": "Voice not found" }, "410": { "description": "Voice revoked" }, "429": { "description": "Rate or quota exceeded" } }
      },
      "delete": {
        "summary": "Revoke a private voice and delete its reference sample",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "voiceId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "200": { "description": "Voice revoked and private sample deleted" }, "404": { "description": "Voice not found" } }
      }
    },
    "/api/goodspeech/v1/avatars/status": {
      "get": {
        "summary": "Check the open avatar renderer",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": {
          "200": { "description": "Avatar capability and fallback status" },
          "401": { "description": "Authentication required" }
        }
      }
    },
    "/api/goodspeech/v1/avatars/render": {
      "post": {
        "summary": "Render an approved self avatar",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": ["portrait", "audio", "consent"],
                "properties": {
                  "portrait": { "type": "string", "format": "binary" },
                  "audio": { "type": "string", "format": "binary" },
                  "name": { "type": "string", "maxLength": 80 },
                  "consent": { "type": "string", "enum": ["self"] }
                }
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Rendered avatar video" },
          "401": { "description": "Authentication required" },
          "422": { "description": "Consent or media validation failed" },
          "503": { "description": "High-fidelity avatar renderer is not configured" }
        }
      }
    },
    "/api/goodspeech/v1/video/models": {
      "get": {
        "summary": "List GoodMotion open video models",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": {
          "200": { "description": "Available models and worker health" },
          "401": { "description": "Authentication required" }
        }
      }
    },
    "/api/goodspeech/v1/video/jobs": {
      "post": {
        "summary": "Create an open-model video generation job",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": ["mode", "model", "prompt", "aspect", "resolution", "duration"],
                "properties": {
                  "mode": { "type": "string", "enum": ["text-to-video", "image-to-video"] },
                  "model": { "type": "string" },
                  "prompt": { "type": "string", "maxLength": 3000 },
                  "negativePrompt": { "type": "string", "maxLength": 1500 },
                  "aspect": { "type": "string", "enum": ["16:9", "9:16", "1:1"] },
                  "resolution": { "type": "string", "enum": ["480p", "720p"] },
                  "duration": { "type": "integer", "enum": [4, 5, 8] },
                  "startFrame": { "type": "string", "format": "binary" }
                }
              }
            }
          }
        },
        "responses": {
          "202": { "description": "Generation job accepted" },
          "401": { "description": "Authentication required" },
          "429": { "description": "Per-user generation limit exceeded" },
          "503": { "description": "GoodMotion is not configured" }
        }
      }
    },
    "/api/goodspeech/v1/video/jobs/{jobId}": {
      "get": {
        "summary": "Read a scoped GoodMotion job",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "jobId", "required": true, "schema": { "type": "string" } }],
        "responses": {
          "200": { "description": "Current job state" },
          "401": { "description": "Authentication required" },
          "404": { "description": "Job unavailable or expired" }
        }
      }
    },
    "/api/goodspeech/v1/video/jobs/{jobId}/content": {
      "get": {
        "summary": "Download a completed GoodMotion video",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "jobId", "required": true, "schema": { "type": "string" } }],
        "responses": {
          "200": { "description": "Generated MP4 video" },
          "401": { "description": "Authentication required" },
          "409": { "description": "Video is not ready" }
        }
      }
    },
    "/api/goodspeech/v1/library/bootstrap": {
      "get": {
        "summary": "Load the signed-in user's GoodSpeech workspace state, assets, and generation history",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": { "200": { "description": "Private cloud library" }, "401": { "description": "Authentication required" }, "403": { "description": "GoodSpeech entitlement required" } }
      }
    },
    "/api/goodspeech/v1/library/state": {
      "put": {
        "summary": "Durably save the signed-in user's GoodSpeech workspace state",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": { "200": { "description": "Workspace state saved" }, "401": { "description": "Authentication required" }, "413": { "description": "Workspace state too large" } }
      }
    },
    "/api/goodspeech/v1/library/assets": {
      "post": {
        "summary": "Upload a private GoodSpeech asset",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": ["file"], "properties": { "file": { "type": "string", "format": "binary" }, "source": { "type": "string" }, "metadata": { "type": "string" } } } } } },
        "responses": { "201": { "description": "Asset saved" }, "401": { "description": "Authentication required" }, "413": { "description": "Asset too large" }, "415": { "description": "Unsupported asset" } }
      }
    },
    "/api/goodspeech/v1/library/assets/{assetId}/content": {
      "get": {
        "summary": "Download an owned private GoodSpeech asset",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "assetId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "200": { "description": "Private asset content" }, "401": { "description": "Authentication required" }, "404": { "description": "Asset not found" } }
      },
      "delete": {
        "summary": "Delete an owned private GoodSpeech asset",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "assetId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "200": { "description": "Asset deleted" }, "401": { "description": "Authentication required" }, "404": { "description": "Asset not found" } }
      }
    },
    "/api/goodspeech/v1/library/history": {
      "post": {
        "summary": "Save generated speech and its production metadata to private history",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": ["file", "text"], "properties": { "file": { "type": "string", "format": "binary" }, "text": { "type": "string", "maxLength": 2000 }, "voice": { "type": "string" }, "voiceLabel": { "type": "string" }, "style": { "type": "string" }, "tone": { "type": "string" } } } } } },
        "responses": { "201": { "description": "Generation saved" }, "401": { "description": "Authentication required" }, "413": { "description": "Audio too large" } }
      }
    },
    "/api/goodspeech/v1/agents/bootstrap": {
      "get": {
        "summary": "Load owned voice agents and analytics",
        "description": "Returns owner-scoped agent configurations, grounded knowledge counts, automated test counts, conversation analytics, and realtime capabilities.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": { "200": { "description": "Voice agent workspace" }, "401": { "description": "Authentication required" }, "403": { "description": "GoodSpeech entitlement required" } }
      }
    },
    "/api/goodspeech/v1/agents": {
      "post": {
        "summary": "Create a governed GoodSpeech voice agent",
        "description": "Creates an owner-scoped voice agent with a bounded system prompt, approved Kokoro voice, language, retention period, and allowlisted tools.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["name", "systemPrompt", "greeting"], "properties": { "name": { "type": "string", "maxLength": 80 }, "systemPrompt": { "type": "string", "maxLength": 8000 }, "greeting": { "type": "string", "maxLength": 500 }, "voice": { "type": "string" }, "language": { "type": "string" }, "tools": { "type": "array", "items": { "type": "string", "enum": ["knowledge_search", "current_time", "usage_summary", "handoff"] } }, "retentionDays": { "type": "integer", "minimum": 0, "maximum": 365 } } } } } },
        "responses": { "201": { "description": "Agent created" }, "400": { "description": "Invalid agent configuration" }, "401": { "description": "Authentication required" } }
      }
    },
    "/api/goodspeech/v1/agents/{agentId}/knowledge": {
      "get": {
        "summary": "List an owned agent's knowledge sources",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "agentId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "200": { "description": "Knowledge inventory" }, "404": { "description": "Agent not found" } }
      },
      "post": {
        "summary": "Index a grounded knowledge source",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "agentId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "201": { "description": "Knowledge source indexed" }, "400": { "description": "Invalid or oversized source" }, "404": { "description": "Agent not found" } }
      }
    },
    "/api/goodspeech/v1/agents/{agentId}/sessions": {
      "post": {
        "summary": "Start a persistent voice agent session",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "agentId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "201": { "description": "Session started with the configured greeting and voice" }, "404": { "description": "Active agent not found" }, "429": { "description": "Rate limit exceeded" } }
      }
    },
    "/api/goodspeech/v1/agents/sessions/{sessionId}/turns": {
      "post": {
        "summary": "Run a grounded conversational turn",
        "description": "Persists the user and assistant messages, executes at most one allowlisted tool, emits citations, and records response latency.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "201": { "description": "Grounded response and voice settings" }, "400": { "description": "Invalid message" }, "404": { "description": "Session not found" }, "409": { "description": "Session already ended" } }
      }
    },
    "/api/goodspeech/v1/agents/sessions/{sessionId}/interrupt": {
      "post": {
        "summary": "Record realtime barge-in",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "200": { "description": "Last assistant message interrupted and session counter updated" }, "404": { "description": "Session not found" } }
      }
    },
    "/api/goodspeech/v1/agents/sessions/{sessionId}/complete": {
      "post": {
        "summary": "Complete a persistent voice agent session",
        "description": "Closes the owned session, records its outcome, and queues an agent.session.completed webhook event.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "sessionId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "outcome": { "type": "string", "enum": ["resolved", "unresolved", "handed_off"] } } } } } },
        "responses": { "200": { "description": "Session completed" }, "404": { "description": "Session not found" } }
      }
    },
    "/api/goodspeech/v1/webhooks": {
      "get": {
        "summary": "List owned GoodSpeech webhook endpoints",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": { "200": { "description": "Webhook endpoints, delivery counts, and supported event types" }, "401": { "description": "Authentication required" } }
      },
      "post": {
        "summary": "Create a signed GoodSpeech webhook endpoint",
        "description": "Registers an owner-scoped public HTTPS endpoint. The signing secret is encrypted at rest and returned only in this response.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["endpointUrl", "events"], "properties": { "endpointUrl": { "type": "string", "format": "uri" }, "description": { "type": "string", "maxLength": 240 }, "events": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": ["speech.completed", "voice.created", "voice.revoked", "agent.session.completed", "agent.handoff.requested", "studio.job.completed", "studio.job.failed", "webhook.test"] } } } } } } },
        "responses": { "201": { "description": "Webhook created with a one-time signing secret" }, "400": { "description": "Invalid endpoint or event selection" }, "409": { "description": "Endpoint already registered" }, "422": { "description": "Endpoint resolved to a blocked destination" } }
      }
    },
    "/api/goodspeech/v1/webhooks/{webhookId}": {
      "delete": {
        "summary": "Delete an owned GoodSpeech webhook endpoint",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "webhookId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "200": { "description": "Webhook and queued deliveries deleted" }, "404": { "description": "Webhook not found" } }
      }
    },
    "/api/goodspeech/v1/webhooks/{webhookId}/test": {
      "post": {
        "summary": "Queue a signed webhook verification event",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "webhookId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "202": { "description": "Verification delivery queued" }, "404": { "description": "Webhook not found" } }
      }
    },
    "/api/goodspeech/v1/governance/privacy": {
      "get": {
        "summary": "Read enforced GoodSpeech privacy and retention settings",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": { "200": { "description": "Zero-retention, residency, training, and retention policy" }, "401": { "description": "Authentication required" } }
      },
      "patch": {
        "summary": "Update GoodSpeech zero-retention and retention controls",
        "description": "Zero-retention immediately purges generated history and completed agent content. Explicit user assets remain until the owner deletes them.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "zeroRetention": { "type": "boolean" }, "generationRetentionDays": { "type": "integer", "enum": [0, 7, 30, 90, 365] }, "agentRetentionDays": { "type": "integer", "enum": [0, 7, 30, 90, 365] }, "residencyRegion": { "type": "string", "enum": ["us-west"] }, "modelTrainingEnabled": { "type": "boolean", "enum": [false] } } } } } },
        "responses": { "200": { "description": "Privacy controls enforced" }, "400": { "description": "Invalid retention selection" }, "409": { "description": "Requested residency or training policy is unavailable" } }
      }
    },
    "/api/goodspeech/v1/governance/privacy/purge": {
      "post": {
        "summary": "Purge retained generated content and agent transcripts",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": { "200": { "description": "Owned generated history, audio, and agent content purged" }, "401": { "description": "Authentication required" } }
      }
    },
    "/api/goodspeech/v1/governance/quality": {
      "get": {
        "summary": "Read measured GoodSpeech latency and reliability objectives",
        "description": "Returns owner-scoped 30-day p50 and p95 first-audio timing, average generation latency, failure rate, objective status, and recent private round-trip quality measurements.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": { "200": { "description": "Measured quality and SLO summary" }, "401": { "description": "Authentication required" } }
      }
    },
    "/api/goodspeech/v1/governance/quality/benchmark": {
      "post": {
        "summary": "Run a private TTS-to-STT quality benchmark",
        "description": "Synthesizes a fixed phrase with the selected managed voice, transcribes it privately, calculates word or character error rate, and stores the owner-scoped measurements in GoodBase. Temporary audio is never retained.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "language": { "type": "string", "enum": ["en-us", "en-gb", "es", "fr-fr", "hi", "it", "ja-jp", "pt-br", "zh-cn"], "default": "en-us" } } } } } },
        "responses": { "201": { "description": "Persisted round-trip quality measurement" }, "400": { "description": "Unsupported benchmark language" }, "401": { "description": "Authentication required" }, "429": { "description": "Benchmark rate limit exceeded" }, "502": { "description": "A managed speech engine rejected the benchmark" } }
      }
    },
    "/api/goodspeech/v1/governance/quality/suite": {
      "post": {
        "summary": "Run the private nine-language TTS-to-STT quality suite",
        "description": "Sequentially measures all nine managed GoodSpeech languages, stores one owner-scoped result per language, and returns pass coverage plus average intelligibility. Temporary audio is never retained.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }],
        "responses": { "201": { "description": "Nine-language suite results and coverage summary" }, "401": { "description": "Authentication required" }, "429": { "description": "Daily suite limit exceeded" }, "502": { "description": "One or more managed speech engines rejected the suite" } }
      }
    },
    "/api/goodspeech/v1/studio/jobs": {
      "get": {
        "summary": "List owned durable Studio rendering jobs",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": { "200": { "description": "Newest owner-scoped Studio jobs and progress" }, "401": { "description": "Authentication required" } }
      },
      "post": {
        "summary": "Queue a resumable long-form Studio render",
        "description": "Queues up to 24 clips and 18,000 characters. Completed clips are retained as private render parts so a worker retry resumes without regenerating them.",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } }],
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["projectName", "clips"], "properties": { "projectName": { "type": "string", "maxLength": 100 }, "clips": { "type": "array", "minItems": 1, "maxItems": 24, "items": { "type": "object", "required": ["text", "voice"], "properties": { "id": { "type": "string" }, "speaker": { "type": "string", "maxLength": 60 }, "text": { "type": "string", "maxLength": 2000 }, "voice": { "type": "string" }, "language": { "type": "string" }, "style": { "type": "string" }, "tone": { "type": "string" }, "intensity": { "type": "integer", "minimum": 0, "maximum": 100 } } } } } } } } },
        "responses": { "202": { "description": "Durable render queued or idempotently returned" }, "400": { "description": "Invalid project or idempotency key" }, "409": { "description": "Concurrency, idempotency, or zero-retention conflict" }, "413": { "description": "Project exceeds the long-form limit" } }
      }
    },
    "/api/goodspeech/v1/studio/jobs/{jobId}": {
      "get": {
        "summary": "Read a durable Studio job and clip progress",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "jobId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "200": { "description": "Owned Studio job, progress, and private output asset link" }, "404": { "description": "Job not found" } }
      }
    },
    "/api/goodspeech/v1/studio/jobs/{jobId}/cancel": {
      "post": {
        "summary": "Cancel an active Studio render",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "jobId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "200": { "description": "Cancellation recorded and private parts removed" }, "409": { "description": "Job is no longer active" } }
      }
    },
    "/api/goodspeech/v1/studio/jobs/{jobId}/retry": {
      "post": {
        "summary": "Retry a failed Studio render from completed parts",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "jobId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "200": { "description": "Failed render requeued" }, "409": { "description": "Job is not failed or zero retention is active" } }
      }
    },
    "/api/goodspeech/v1/agents/{agentId}/tests/{testId}/run": {
      "post": {
        "summary": "Run a durable grounded agent regression test",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "agentId", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "in": "path", "name": "testId", "required": true, "schema": { "type": "string", "format": "uuid" } }],
        "responses": { "200": { "description": "Test result and captured response" }, "404": { "description": "Agent or test not found" } }
      }
    },
    "/api/goodspeech/v1/collaboration/bootstrap": {
      "get": {
        "summary": "Load the tenant-scoped GoodSpeech collaboration workspace",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": {
          "200": { "description": "Teams, projects, members, and channels" },
          "401": { "description": "Authentication required" },
          "403": { "description": "GoodSpeech entitlement required" }
        }
      }
    },
    "/api/goodspeech/v1/collaboration/projects": {
      "get": {
        "summary": "List GoodSpeech projects",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": { "200": { "description": "Tenant-scoped projects" }, "401": { "description": "Authentication required" } }
      },
      "post": {
        "summary": "Create a GoodSpeech team project",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "responses": { "201": { "description": "Project created" }, "400": { "description": "Invalid project" }, "401": { "description": "Authentication required" } }
      }
    },
    "/api/goodspeech/v1/collaboration/channels/{channelId}/messages": {
      "get": {
        "summary": "List channel messages",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "channelId", "required": true, "schema": { "type": "string" } }],
        "responses": { "200": { "description": "Channel messages" }, "401": { "description": "Authentication required" } }
      },
      "post": {
        "summary": "Send a channel message",
        "servers": [{ "url": "https://base.goodos.app" }],
        "security": [{ "GoodBaseSession": [] }, { "GoodOSBearer": [] }],
        "parameters": [{ "in": "path", "name": "channelId", "required": true, "schema": { "type": "string" } }],
        "responses": { "201": { "description": "Message sent" }, "401": { "description": "Authentication required" }, "429": { "description": "Message rate limit exceeded" } }
      }
    },
    "/health": {
      "get": {
        "summary": "Public API health check",
        "description": "Requires scope: read:health",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "read:health",
        "responses": {
          "200": {
            "description": "Health response",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "service": "Goodbase Public API",
                  "status": "ok",
                  "apiKey": {
                    "id": "key_xxx",
                    "name": "Function Execute Key",
                    "type": "scoped",
                    "scopes": [
                      "read:health"
                    ]
                  },
                  "time": "2026-06-26T00:00:00.000Z"
                }
              }
            }
          },
          "401": {
            "description": "API key required"
          },
          "403": {
            "description": "Missing required scope"
          }
        }
      }
    },
    "/apps": {
      "get": {
        "summary": "List apps allowed for the API key",
        "description": "Requires scope: read:apps. App results are filtered by allowed_app_ids on the API key.",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "read:apps",
        "responses": {
          "200": {
            "description": "Allowed apps",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "data": {
                    "apps": [
                      {
                        "id": "goodfleet",
                        "name": "GoodFleet",
                        "domain": "fleet.goodos.app",
                        "status": "active",
                        "memberCount": 1
                      }
                    ]
                  }
                }
              }
            }
          },
          "401": {
            "description": "API key required"
          },
          "403": {
            "description": "Missing required scope"
          }
        }
      }
    },
    "/storage/buckets": {
      "get": {
        "summary": "List storage buckets",
        "description": "Requires scope: read:storage. Returns Storage V2 bucket metadata including provider/CDN fields when available.",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "read:storage",
        "responses": {
          "200": {
            "description": "Storage buckets"
          },
          "401": {
            "description": "API key required"
          },
          "403": {
            "description": "Missing required scope"
          }
        }
      }
    },
    "/storage/files": {
      "get": {
        "summary": "List storage files",
        "description": "Requires scope: read:storage. Returns Storage V2 file/object metadata including object keys, checksums, versions, and public/CDN URLs when available.",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "read:storage",
        "parameters": [
          {
            "name": "bucket",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Storage files"
          },
          "401": {
            "description": "API key required"
          },
          "403": {
            "description": "Missing required scope"
          }
        }
      }
    },
    "/functions/{slug}": {
      "get": {
        "summary": "Call an HTTP Edge Function using GET",
        "description": "Requires scope: execute:functions. Executes through the GoodOS Edge Functions V2 controlled runtime when V2 metadata is enabled.",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "execute:functions",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "health-check"
          }
        ],
        "responses": {
          "200": {
            "description": "Function execution result"
          },
          "401": {
            "description": "API key required"
          },
          "403": {
            "description": "Missing required scope"
          },
          "404": {
            "description": "Function not found"
          }
        },
        "x-goodos-runtime": "edge-functions-v2"
      },
      "post": {
        "summary": "Call an HTTP Edge Function using POST",
        "description": "Requires scope: execute:functions. Executes through the GoodOS Edge Functions V2 controlled runtime when V2 metadata is enabled.",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "execute:functions",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "health-check"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "example": {
                "source": "developer-docs",
                "message": "Testing GoodOS callable function"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Function execution result"
          },
          "401": {
            "description": "API key required"
          },
          "403": {
            "description": "Missing required scope"
          },
          "404": {
            "description": "Function not found"
          }
        },
        "x-goodos-runtime": "edge-functions-v2"
      }
    },
    "/db/tables": {
      "get": {
        "summary": "List published Database API tables",
        "description": "Requires scope: read:db",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "read:db",
        "responses": {
          "200": {
            "description": "Published tables"
          },
          "401": {
            "description": "API key required"
          },
          "403": {
            "description": "Missing required scope"
          }
        }
      }
    },
    "/db/{tableSlug}/rows": {
      "get": {
        "summary": "List rows from a published table",
        "description": "Requires scope: read:db",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "read:db",
        "parameters": [
          {
            "name": "tableSlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "apps"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Table rows"
          },
          "401": {
            "description": "API key required"
          },
          "403": {
            "description": "Missing required scope or table disabled"
          },
          "404": {
            "description": "Published table not found"
          }
        }
      },
      "post": {
        "summary": "Create a row in a write-enabled published table",
        "description": "Requires scope: write:db and table insert permission",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "write:db",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "title": "New demo item",
                "status": "active"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Row created"
          },
          "401": {
            "description": "API key required"
          },
          "403": {
            "description": "Missing required scope or table disabled"
          }
        }
      }
    },
    "/db/{tableSlug}/rows/{id}": {
      "get": {
        "summary": "Get one row from a published table",
        "description": "Requires scope: read:db",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "read:db",
        "parameters": [
          {
            "name": "tableSlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Table row"
          }
        }
      },
      "patch": {
        "summary": "Update a row in a write-enabled published table",
        "description": "Requires scope: write:db and table update permission",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "write:db",
        "parameters": [
          {
            "name": "tableSlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Row updated"
          }
        }
      },
      "delete": {
        "summary": "Delete or soft-delete a row in a write-enabled published table",
        "description": "Requires scope: write:db and table delete permission",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "write:db",
        "parameters": [
          {
            "name": "tableSlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Row deleted"
          }
        }
      }
    },
    "/storage/public/{bucketName}/{objectKey}": {
      "get": {
        "summary": "Read a public Storage V2 object",
        "description": "Public object delivery route for buckets marked public or public_read_enabled. This route is served from the root backend domain, not /api/v1.",
        "servers": [
          {
            "url": "https://base.goodos.app"
          }
        ],
        "parameters": [
          {
            "name": "bucketName",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "storage-v2-public"
          },
          {
            "name": "objectKey",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "v2-public-health.txt"
          }
        ],
        "responses": {
          "200": {
            "description": "Object file"
          },
          "403": {
            "description": "Bucket or path blocked"
          },
          "404": {
            "description": "Object not found"
          }
        }
      }
    },
    "/functions/{slug}/v2-runtime": {
      "get": {
        "summary": "Edge Functions V2 runtime metadata",
        "description": "Documentation marker for Edge Functions V2 runtime metadata returned under output._runtime.",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "execute:functions",
        "responses": {
          "200": {
            "description": "Runtime metadata is returned during function execution."
          }
        }
      }
    },
    "/realtime/channels": {
      "get": {
        "summary": "List Realtime V2 channels",
        "description": "Requires scope: read:realtime",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "read:realtime",
        "responses": {
          "200": {
            "description": "Realtime channels"
          }
        }
      }
    },
    "/realtime/events": {
      "get": {
        "summary": "List Realtime V2 messages",
        "description": "Requires scope: read:realtime",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "read:realtime",
        "parameters": [
          {
            "name": "channel",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Realtime messages"
          }
        }
      },
      "post": {
        "summary": "Publish a Realtime V2 message",
        "description": "Requires scope: publish:realtime",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "publish:realtime",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "channel": "system",
                "eventType": "demo.message",
                "message": "Hello Realtime V2",
                "payload": {
                  "ok": true
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Realtime message published"
          }
        }
      }
    },
    "/realtime/stream": {
      "get": {
        "summary": "Subscribe to Realtime V2 SSE stream",
        "description": "Requires scope: subscribe:realtime. Use X-GoodOS-API-Key header.",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "subscribe:realtime",
        "parameters": [
          {
            "name": "channel",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Server-Sent Events stream"
          }
        }
      }
    },
    "/realtime/ws": {
      "get": {
        "summary": "Realtime V2 WebSocket endpoint",
        "description": "Connect to wss://base.goodos.app/api/v1/realtime/ws?api_key=YOUR_KEY&channel=system with subscribe:realtime scope. Publish messages with publish:realtime scope.",
        "x-goodos-scope": "subscribe:realtime",
        "responses": {
          "101": {
            "description": "WebSocket upgrade"
          }
        }
      }
    },
    "/auth/session": {
      "get": {
        "summary": "Get Auth V2 session",
        "description": "Requires GoodOS session cookie or bearer token. Returns user, session, roles, and MFA factor state.",
        "responses": {
          "200": {
            "description": "Current Auth V2 session"
          },
          "401": {
            "description": "Authentication required"
          }
        }
      }
    },
    "/auth/roles": {
      "get": {
        "summary": "Get Auth V2 roles for current user",
        "description": "Requires authentication.",
        "responses": {
          "200": {
            "description": "Role matrix and current user roles"
          },
          "401": {
            "description": "Authentication required"
          }
        }
      }
    },
    "/auth/mfa/setup": {
      "post": {
        "summary": "Start TOTP MFA setup",
        "description": "Requires authentication. Returns QR code data URL and setup secret once.",
        "responses": {
          "200": {
            "description": "MFA setup started"
          }
        }
      }
    },
    "/auth/mfa/verify": {
      "post": {
        "summary": "Verify TOTP MFA factor",
        "description": "Requires authentication.",
        "responses": {
          "200": {
            "description": "MFA verified"
          }
        }
      }
    },
    "/auth/password-reset/request": {
      "post": {
        "summary": "Request password reset",
        "description": "Creates a password reset token if an active account exists.",
        "responses": {
          "200": {
            "description": "Password reset requested"
          }
        }
      }
    },
    "/auth/password-reset/complete": {
      "post": {
        "summary": "Complete password reset",
        "description": "Uses a reset token to set a new password.",
        "responses": {
          "200": {
            "description": "Password reset complete"
          }
        }
      }
    },
    "/billing/plans": {
      "get": {
        "summary": "List billing plans",
        "description": "Returns the public GoodOS billing plan catalog.",
        "responses": {
          "200": {
            "description": "Billing plans"
          }
        }
      }
    },
    "/usage": {
      "get": {
        "summary": "Get usage snapshot",
        "description": "Requires scope: read:usage. Returns usage, quotas, and current API key usage.",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "read:usage",
        "responses": {
          "200": {
            "description": "Usage snapshot"
          }
        }
      }
    },
    "/notifications": {
      "get": {
        "summary": "List notifications",
        "description": "Requires scope: read:notifications.",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "read:notifications",
        "responses": {
          "200": {
            "description": "Notifications and message center records"
          }
        }
      },
      "post": {
        "summary": "Create notification",
        "description": "Publishes an app-scoped notification into GoodBase. The same notification and read state are available to the app's own notification center and to the GoodOS master Notification Center. Requires scope: write:notifications and an API key authorized for the supplied appId.",
        "security": [
          {
            "GoodOSApiKey": []
          },
          {
            "GoodOSBearer": []
          }
        ],
        "x-goodos-scope": "write:notifications",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {
                "appId": "goodqr",
                "title": "System notice",
                "message": "Hello from GoodOS Notifications V2",
                "severity": "info",
                "category": "system",
                "channel": "in_app",
                "recipientUserId": "00000000-0000-0000-0000-000000000000",
                "actionUrl": "https://qr.goodos.app/notifications"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Notification created"
          }
        }
      }
    },
    "/admin/jobs-page-data": {
      "get": {
        "summary": "Admin Jobs V2 page data",
        "description": "Admin-only route for jobs, schedules, runs, locks, worker heartbeats, and queue items.",
        "responses": {
          "200": {
            "description": "Jobs V2 snapshot"
          },
          "401": {
            "description": "Authentication required"
          }
        }
      }
    },
    "/admin/jobs/{id}/run-safe": {
      "post": {
        "summary": "Run one job",
        "description": "Admin-only manual job execution.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Job run result"
          },
          "401": {
            "description": "Authentication required"
          }
        }
      }
    },
    "/admin/jobs/run-due-safe": {
      "post": {
        "summary": "Run due jobs",
        "description": "Admin-only route to process currently due jobs.",
        "responses": {
          "200": {
            "description": "Due jobs processed"
          },
          "401": {
            "description": "Authentication required"
          }
        }
      }
    },
    "/api/admin/secrets-v2-page-data": {
      "get": {
        "summary": "Secrets V2 page data",
        "tags": [
          "Admin",
          "Secrets V2"
        ],
        "responses": {
          "200": {
            "description": "Secret metadata snapshot"
          },
          "401": {
            "description": "Authorization required"
          }
        }
      }
    },
    "/api/admin/secrets/create-safe": {
      "post": {
        "summary": "Create or rotate secret",
        "tags": [
          "Admin",
          "Secrets V2"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "secretKey": {
                    "type": "string"
                  },
                  "secretValue": {
                    "type": "string"
                  },
                  "displayName": {
                    "type": "string"
                  },
                  "category": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Encrypted secret reference created or rotated"
          },
          "401": {
            "description": "Authorization required"
          }
        }
      }
    },
    "/api/admin/secrets/{key}/rotate-safe": {
      "post": {
        "summary": "Rotate secret by key",
        "tags": [
          "Admin",
          "Secrets V2"
        ],
        "parameters": [
          {
            "name": "key",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Secret rotated"
          },
          "401": {
            "description": "Authorization required"
          }
        }
      }
    },
    "/api/admin/secrets/{key}/resolve-test-safe": {
      "post": {
        "summary": "Resolve secret test",
        "tags": [
          "Admin",
          "Secrets V2"
        ],
        "parameters": [
          {
            "name": "key",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Secret resolution test without raw value"
          },
          "401": {
            "description": "Authorization required"
          }
        }
      }
    },
    "/api/enterprise/readiness-program": {
      "get": {
        "summary": "Enterprise readiness program",
        "description": "Returns live file and database evidence for the nine GoodOS enterprise control domains.",
        "tags": [
          "Enterprise"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Enterprise readiness assessment"
          },
          "401": {
            "description": "Authorization required"
          },
          "403": {
            "description": "Owner or administrator access required"
          }
        }
      }
    },
    "/api/data-platform/health": {
      "get": {
        "summary": "Automatic data-plane health",
        "tags": [
          "Data Platform"
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "PostgREST data plane is operational"
          },
          "503": {
            "description": "The data plane is degraded or unavailable"
          }
        }
      }
    },
    "/api/data-platform/token": {
      "post": {
        "summary": "Issue a short-lived session-bound data token",
        "tags": [
          "Data Platform"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Five-minute database access token"
          },
          "401": {
            "description": "A current GoodOS session is required"
          }
        }
      }
    },
    "/rest/v1/{resource}": {
      "parameters": [
        {
          "name": "resource",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "An explicitly published goodos_api table, view, or function"
        }
      ],
      "get": {
        "summary": "Query an automatically generated REST resource",
        "tags": [
          "Data Platform"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "RLS-filtered records"
          },
          "401": {
            "description": "Authorization required"
          },
          "403": {
            "description": "Database policy denied access"
          }
        }
      },
      "post": {
        "summary": "Insert into an automatically generated REST resource",
        "tags": [
          "Data Platform"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Record inserted"
          },
          "401": {
            "description": "Authorization required"
          },
          "403": {
            "description": "Database policy denied access"
          }
        }
      },
      "patch": {
        "summary": "Update an automatically generated REST resource",
        "tags": [
          "Data Platform"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Record updated"
          },
          "401": {
            "description": "Authorization required"
          },
          "403": {
            "description": "Database policy denied access"
          }
        }
      },
      "delete": {
        "summary": "Delete from an automatically generated REST resource",
        "tags": [
          "Data Platform"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Record deleted"
          },
          "401": {
            "description": "Authorization required"
          },
          "403": {
            "description": "Database policy denied access"
          }
        }
      }
    },
    "/api/settings/overview": {
      "get": {
        "summary": "Current user and business settings overview",
        "tags": [
          "Account Settings"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Profile, preferences, organization, workspace, sessions, and audit activity"
          },
          "401": {
            "description": "Authorization required"
          }
        }
      }
    },
    "/api/settings/profile": {
      "patch": {
        "summary": "Update current user profile",
        "tags": [
          "Account Settings"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "User profile updated"
          },
          "400": {
            "description": "Invalid profile data"
          },
          "401": {
            "description": "Authorization required"
          }
        }
      }
    },
    "/api/settings/avatar": {
      "post": {
        "summary": "Upload current user profile photo",
        "tags": [
          "Account Settings"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "avatar"
                ],
                "properties": {
                  "avatar": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Profile photo saved"
          },
          "413": {
            "description": "Profile photo is too large"
          },
          "415": {
            "description": "Unsupported image type"
          }
        }
      },
      "delete": {
        "summary": "Remove current user profile photo",
        "tags": [
          "Account Settings"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Profile photo removed"
          },
          "401": {
            "description": "Authorization required"
          }
        }
      }
    },
    "/api/settings/business-profile": {
      "patch": {
        "summary": "Update the current organization business profile",
        "tags": [
          "Account Settings"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Business profile updated"
          },
          "400": {
            "description": "Invalid business profile data"
          },
          "403": {
            "description": "Owner or administrator access required"
          }
        }
      }
    },
    "/api/settings/business-logo": {
      "post": {
        "summary": "Upload the current organization business logo",
        "tags": [
          "Account Settings"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "logo"
                ],
                "properties": {
                  "logo": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Business logo saved"
          },
          "403": {
            "description": "Owner or administrator access required"
          },
          "413": {
            "description": "Business logo is too large"
          },
          "415": {
            "description": "Unsupported image type"
          }
        }
      },
      "delete": {
        "summary": "Remove the current organization business logo",
        "tags": [
          "Account Settings"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Business logo removed"
          },
          "403": {
            "description": "Owner or administrator access required"
          }
        }
      }
    },
    "/api/settings/preferences": {
      "patch": {
        "summary": "Update current user preferences",
        "tags": [
          "Account Settings"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Preferences updated"
          },
          "400": {
            "description": "Invalid preference data"
          }
        }
      },
      "delete": {
        "summary": "Reset current user preferences",
        "tags": [
          "Account Settings"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Preferences reset to defaults"
          }
        }
      }
    },
    "/api/goodbase/v1/platform/overview": {
      "get": {
        "summary": "Goodbase Phase 6-10 platform overview",
        "tags": [
          "Goodbase Platform"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Queue, schedule, recovery, storage, and edge-runtime metrics"
          },
          "403": {
            "description": "Administrator access required"
          }
        }
      }
    },
    "/api/goodbase/v1/platform/queues": {
      "get": {
        "summary": "List durable queues and delivery metrics",
        "tags": [
          "Goodbase Queues"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Tenant queue inventory"
          }
        }
      },
      "post": {
        "summary": "Create a durable tenant queue",
        "tags": [
          "Goodbase Queues"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Queue created"
          },
          "400": {
            "description": "Invalid queue policy"
          }
        }
      }
    },
    "/api/goodbase/v1/platform/schedules": {
      "get": {
        "summary": "List schedules and recent run history",
        "tags": [
          "Goodbase Scheduling"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Tenant schedules"
          }
        }
      },
      "post": {
        "summary": "Create a queue, SQL, HTTPS, or edge-function schedule",
        "tags": [
          "Goodbase Scheduling"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Schedule created"
          },
          "400": {
            "description": "Invalid schedule"
          }
        }
      }
    },
    "/api/goodbase/v1/platform/recovery": {
      "get": {
        "summary": "Backup, PITR, WAL, and disaster-recovery status",
        "tags": [
          "Goodbase Recovery"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Recovery policies and available recovery window"
          }
        }
      }
    },
    "/api/goodbase/v1/platform/storage/uploads": {
      "post": {
        "summary": "Create a TUS or S3 multipart upload session",
        "tags": [
          "Goodbase Storage"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Resumable upload session created"
          },
          "400": {
            "description": "Invalid upload policy"
          }
        }
      }
    },
    "/api/goodbase/v1/platform/edge/functions": {
      "get": {
        "summary": "List isolated edge functions and immutable versions",
        "tags": [
          "Goodbase Edge Functions"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Tenant edge functions"
          }
        }
      },
      "post": {
        "summary": "Create an isolated edge function",
        "tags": [
          "Goodbase Edge Functions"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Function created"
          },
          "400": {
            "description": "Invalid runtime policy"
          }
        }
      }
    },
    "/api/auth/v3/passwordless/start": {
      "post": {
        "summary": "Start a single-use email OTP or magic-link sign-in",
        "tags": [
          "Goodbase Authentication"
        ],
        "security": [],
        "responses": {
          "202": {
            "description": "Generic challenge delivery response"
          },
          "429": {
            "description": "Authentication rate limit exceeded"
          }
        }
      }
    },
    "/api/auth/v3/passwordless/verify": {
      "post": {
        "summary": "Consume a passwordless challenge and create a session",
        "tags": [
          "Goodbase Authentication"
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Authenticated session"
          },
          "401": {
            "description": "Invalid, expired, reused, or locked challenge"
          }
        }
      }
    },
    "/api/goodbase/v1/developer/overview": {
      "get": {
        "summary": "Goodbase Phase 11-15 developer-platform overview",
        "tags": [
          "Goodbase Developer Platform"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Authentication, CLI, SDK, migration, and preview metrics"
          },
          "403": {
            "description": "Administrator access required"
          }
        }
      }
    },
    "/api/goodbase/v1/developer/auth/channels": {
      "get": {
        "summary": "List authentication channels, security policy, and hooks",
        "tags": [
          "Goodbase Authentication"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Tenant authentication configuration"
          }
        }
      }
    },
    "/api/goodbase/v1/developer/sdks": {
      "get": {
        "summary": "List supported SDK releases and compatibility",
        "tags": [
          "Goodbase SDKs"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "SDK release registry"
          }
        }
      }
    },
    "/api/goodbase/v1/developer/migrations": {
      "get": {
        "summary": "List checksum-locked migration plans and steps",
        "tags": [
          "Goodbase Migrations"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Tenant migration plans"
          }
        }
      }
    },
    "/api/goodbase/v1/developer/migrations/validate": {
      "post": {
        "summary": "Lint and register a migration plan without executing it",
        "tags": [
          "Goodbase Migrations"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Migration plan validated"
          },
          "400": {
            "description": "Invalid migration SQL"
          }
        }
      }
    },
    "/api/goodbase/v1/developer/previews": {
      "get": {
        "summary": "List isolated preview environments and resources",
        "tags": [
          "Goodbase Preview Environments"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Preview environment inventory"
          }
        }
      },
      "post": {
        "summary": "Queue an isolated preview environment",
        "tags": [
          "Goodbase Preview Environments"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "202": {
            "description": "Preview provisioning accepted"
          },
          "409": {
            "description": "Preview slug already exists"
          }
        }
      }
    },
    "/api/goodbase/v1/production/overview": {
      "get": {
        "summary": "Get Goodbase Phases 21-25 production readiness",
        "tags": ["Goodbase Production"],
        "security": [{"GoodOSBearer": []}],
        "responses": {"200": {"description": "Production verification, recovery, SDK, sync, and controller status"}, "401": {"description": "Authentication required"}, "403": {"description": "Administrator role required"}}
      }
    },
    "/api/goodbase/v1/production/verification/runs": {
      "get": {
        "summary": "List commit-bound production verification evidence",
        "tags": ["Goodbase Production"],
        "security": [{"GoodOSBearer": []}],
        "responses": {"200": {"description": "Verification run history"}}
      },
      "post": {
        "summary": "Run privileged production verification",
        "tags": ["Goodbase Production"],
        "security": [{"GoodOSBearer": []}],
        "responses": {"201": {"description": "All critical checks passed"}, "424": {"description": "One or more critical checks failed"}, "428": {"description": "Verified MFA required"}}
      }
    },
    "/api/goodbase/v1/production/recovery": {
      "get": {
        "summary": "Get backup, restore, PITR, and replica readiness",
        "tags": ["Goodbase Recovery"],
        "security": [{"GoodOSBearer": []}],
        "responses": {"200": {"description": "Recovery inventory and evidence"}}
      }
    },
    "/api/goodbase/v1/production/sync/collections/{collectionId}/changes": {
      "get": {
        "summary": "Resume an offline synchronization change feed",
        "tags": ["Goodbase Offline Sync"],
        "security": [{"GoodOSBearer": []}],
        "parameters": [{"name":"collectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"cursor","in":"query","schema":{"type":"integer","minimum":0}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000}}],
        "responses": {"200": {"description": "Ordered deduplicated changes and next cursor"}}
      }
    },
    "/api/goodbase/v1/production/sync/collections/{collectionId}/mutations": {
      "post": {
        "summary": "Apply durable idempotent offline mutations",
        "tags": ["Goodbase Offline Sync"],
        "security": [{"GoodOSBearer": []}],
        "parameters": [{"name":"collectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],
        "responses": {"200": {"description": "Applied mutations and conflicts"}, "400": {"description": "Invalid mutation batch"}}
      }
    },
    "/api/goodbase/v1/production/controllers": {
      "get": {
        "summary": "List verified production controllers",
        "tags": ["Goodbase Controllers"],
        "security": [{"GoodOSBearer": []}],
        "responses": {"200": {"description": "Controller health and capabilities"}}
      },
      "post": {
        "summary": "Register an HTTPS production controller",
        "tags": ["Goodbase Controllers"],
        "security": [{"GoodOSBearer": []}],
        "responses": {"201": {"description": "Unverified controller registered"}, "428": {"description": "Verified MFA required"}}
      }
    },
    "/api/goodbase/v1/enterprise/overview": {
      "get": {
        "summary": "Get Phase 16-20 enterprise overview",
        "tags": [
          "Goodbase Enterprise"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Enterprise platform metrics"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/logs": {
      "get": {
        "summary": "Search unified logs",
        "tags": [
          "Goodbase Observability"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Bounded unified log results"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/observability": {
      "get": {
        "summary": "Get observability controls",
        "tags": [
          "Goodbase Observability"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Saved queries, drains, policy, and SLOs"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/observability/saved-queries": {
      "post": {
        "summary": "Save a log query",
        "tags": [
          "Goodbase Observability"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Saved log query"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/observability/drains": {
      "post": {
        "summary": "Create a protected log drain",
        "tags": [
          "Goodbase Observability"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Created external log drain"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/management": {
      "get": {
        "summary": "List management controls",
        "tags": [
          "Goodbase Management"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Operations, scoped tokens, and integrations"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/management/tokens": {
      "post": {
        "summary": "Create a scoped management token",
        "tags": [
          "Goodbase Management"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Token secret returned once"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/management/operations": {
      "post": {
        "summary": "Queue an idempotent management operation",
        "tags": [
          "Goodbase Management"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "202": {
            "description": "Queued management operation"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/domains": {
      "get": {
        "summary": "List custom domains",
        "tags": [
          "Goodbase Domains"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Custom domain lifecycle records"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      },
      "post": {
        "summary": "Register a custom domain",
        "tags": [
          "Goodbase Domains"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "DNS verification instructions"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/domains/{id}/verify": {
      "post": {
        "summary": "Verify custom-domain DNS",
        "tags": [
          "Goodbase Domains"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "DNS verification result"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/domains/{id}/activate": {
      "post": {
        "summary": "Activate a certificate-ready domain",
        "tags": [
          "Goodbase Domains"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "202": {
            "description": "Queued domain activation"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/search/collections": {
      "get": {
        "summary": "List vector collections",
        "tags": [
          "Goodbase Search"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Vector collection inventory"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      },
      "post": {
        "summary": "Create a vector collection",
        "tags": [
          "Goodbase Search"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Created vector collection"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/search/collections/{id}/documents": {
      "post": {
        "summary": "Upsert and embed a search document",
        "tags": [
          "Goodbase Search"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "202": {
            "description": "Document and embedding queue state"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/search/collections/{id}/query": {
      "post": {
        "summary": "Run keyword, semantic, or hybrid search",
        "tags": [
          "Goodbase Search"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Ranked search results"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/infrastructure": {
      "get": {
        "summary": "Get regional infrastructure state",
        "tags": [
          "Goodbase Infrastructure"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Regions, nodes, capacity, failover, incidents, and limits"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/infrastructure/failover-plans/{id}/events": {
      "post": {
        "summary": "Queue a privileged failover event",
        "tags": [
          "Goodbase Infrastructure"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "202": {
            "description": "Queued failover test, failover, or failback"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/domains/{id}/deactivate": {
      "post": {
        "summary": "Deactivate a custom domain",
        "tags": [
          "Goodbase Domains"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "202": {
            "description": "Queued domain deactivation"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/search/collections/{id}/rebuild": {
      "post": {
        "summary": "Rebuild a managed search index",
        "tags": [
          "Goodbase Search"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "202": {
            "description": "Queued index rebuild"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/infrastructure/capacity-policies": {
      "put": {
        "summary": "Create or update an autoscaling policy",
        "tags": [
          "Goodbase Infrastructure"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "200": {
            "description": "Capacity policy"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/infrastructure/failover-plans": {
      "post": {
        "summary": "Create a failover plan",
        "tags": [
          "Goodbase Infrastructure"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Failover plan"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
    "/api/goodbase/v1/enterprise/infrastructure/incidents": {
      "post": {
        "summary": "Create a platform incident",
        "tags": [
          "Goodbase Infrastructure"
        ],
        "security": [
          {
            "GoodOSBearer": []
          }
        ],
        "responses": {
          "201": {
            "description": "Platform incident"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Required administrator role or management scope is missing"
          }
        }
      }
    },
      "/api/goodbase/v1/growth/auth/providers": {
        "get": {
          "summary": "List public consumer authentication providers",
          "tags": [
            "Goodbase Growth"
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/auth/anonymous": {
        "post": {
          "summary": "Create an anonymous upgradeable account",
          "tags": [
            "Goodbase Growth"
          ],
          "responses": {
            "201": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/auth/phone/start": {
        "post": {
          "summary": "Start phone OTP authentication",
          "tags": [
            "Goodbase Growth"
          ],
          "responses": {
            "202": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/auth/phone/verify": {
        "post": {
          "summary": "Verify phone OTP authentication",
          "tags": [
            "Goodbase Growth"
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/auth/anonymous/upgrade/start": {
        "post": {
          "summary": "Start anonymous account upgrade",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "202": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/auth/anonymous/upgrade/verify": {
        "post": {
          "summary": "Verify anonymous account upgrade",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/auth/identities": {
        "get": {
          "summary": "List linked sign-in identities",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/auth/identities/{id}": {
        "delete": {
          "summary": "Unlink a sign-in identity",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/attestation/challenge": {
        "post": {
          "summary": "Create an app attestation challenge",
          "tags": [
            "Goodbase Growth"
          ],
          "responses": {
            "201": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/attestation/exchange": {
        "post": {
          "summary": "Exchange a provider assertion for a short-lived attestation token",
          "tags": [
            "Goodbase Growth"
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/attestation/policies": {
        "get": {
          "summary": "List app attestation policies",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        },
        "post": {
          "summary": "Create or update an app attestation policy",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "201": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/messaging/devices": {
        "post": {
          "summary": "Register or rotate a messaging device",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "201": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/messaging/devices/{id}": {
        "delete": {
          "summary": "Revoke a messaging device",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/messaging/providers": {
        "get": {
          "summary": "List messaging providers",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        },
        "post": {
          "summary": "Configure a messaging provider",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "201": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/messaging/providers/{id}/verify": {
        "post": {
          "summary": "Verify a messaging provider",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/messaging/topics": {
        "post": {
          "summary": "Create a messaging topic",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "201": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/messaging/segments": {
        "post": {
          "summary": "Create a messaging segment",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "201": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/messaging/templates": {
        "post": {
          "summary": "Create or update a localized messaging template",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "201": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/messaging/campaigns": {
        "post": {
          "summary": "Schedule a messaging campaign",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "201": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/messaging/campaigns/{id}/queue": {
        "post": {
          "summary": "Queue an audience-aware messaging campaign",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "202": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/assurance/overview": {
        "get": {
          "summary": "Get release assurance status",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/assurance/runs": {
        "post": {
          "summary": "Run a commit-bound assurance suite",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "201": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/developer/assets": {
        "get": {
          "summary": "List published developer assets",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/imports/analyze": {
        "post": {
          "summary": "Analyze an import manifest without changing data",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "201": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/imports/{id}/apply": {
        "post": {
          "summary": "Queue a rollback-protected import",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "202": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/auth/provider-configs": {
        "get": {
          "summary": "List administrative authentication provider configuration",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/growth/auth/providers/{id}": {
        "patch": {
          "summary": "Configure and verify an authentication provider",
          "tags": [
            "Goodbase Growth"
          ],
          "security": [
            {
              "GoodOSBearer": []
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response"
            },
            "400": {
              "description": "Invalid request"
            },
            "401": {
              "description": "Authentication required"
            },
            "403": {
              "description": "Insufficient permission"
            }
          }
        }
      },
      "/api/goodbase/v1/product/status": {
        "get": {"summary":"Read public Goodbase service status","tags":["Goodbase Product Platform"],"security":[],"responses":{"200":{"description":"Public component and incident status"}}}
      },
      "/api/goodbase/v1/product/config/{appId}": {
        "get": {"summary":"Resolve typed Remote Config","tags":["Goodbase Product Platform"],"security":[],"responses":{"200":{"description":"Published configuration resolved for the client context"},"304":{"description":"Configuration is unchanged"}}}
      },
      "/api/goodbase/v1/product/analytics/events": {
        "post": {"summary":"Ingest consent-aware analytics events","tags":["Goodbase Product Platform"],"security":[{"GoodOSBearer":[]}],"responses":{"202":{"description":"Events accepted"},"400":{"description":"Invalid or missing consent"},"401":{"description":"Authentication required"}}}
      },
      "/api/goodbase/v1/product/telemetry/sessions": {
        "post": {"summary":"Record a consent-aware client session lifecycle event","tags":["Goodbase Product Platform"],"security":[{"GoodOSBearer":[]}],"responses":{"202":{"description":"Session lifecycle recorded"},"400":{"description":"Invalid lifecycle or consent"},"401":{"description":"Authentication required"}}}
      },
      "/api/goodbase/v1/product/telemetry/crashes": {
        "post": {"summary":"Capture a client crash occurrence","tags":["Goodbase Product Platform"],"security":[{"GoodOSBearer":[]}],"responses":{"202":{"description":"Crash accepted"},"400":{"description":"Invalid crash payload"}}}
      },
      "/api/goodbase/v1/product/telemetry/stability": {
        "get": {"summary":"Read crash-free user, session, release adoption, and issue-impact metrics","tags":["Goodbase Product Platform"],"security":[{"GoodOSBearer":[]}],"responses":{"200":{"description":"Release stability metrics"},"403":{"description":"Administrator role required"}}}
      },
      "/api/goodbase/v1/product/telemetry/privacy/requests": {
        "get": {"summary":"List auditable telemetry privacy requests","tags":["Goodbase Product Platform"],"security":[{"GoodOSBearer":[]}],"responses":{"200":{"description":"Telemetry privacy request history"},"403":{"description":"Administrator role required"}}},
        "post": {"summary":"Create an export or deletion request across telemetry stores","tags":["Goodbase Product Platform"],"security":[{"GoodOSBearer":[]}],"responses":{"201":{"description":"Privacy request queued"},"400":{"description":"Invalid identity or target store"},"428":{"description":"Privileged MFA required"}}}
      },
      "/api/goodbase/v1/product/telemetry/privacy/requests/{id}/process": {
        "post": {"summary":"Process a legal-hold-aware telemetry privacy request","tags":["Goodbase Product Platform"],"security":[{"GoodOSBearer":[]}],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Request completed or explicitly blocked"},"404":{"description":"Request not found"},"428":{"description":"Privileged MFA required"}}}
      },
      "/api/goodbase/v1/experience/telemetry/releases": {
        "post": {"summary":"Register an application release for native symbol processing","tags":["Goodbase Product Platform"],"security":[{"GoodOSBearer":[]}],"responses":{"201":{"description":"Release registered"},"400":{"description":"Invalid release identity"},"403":{"description":"Administrator role required"},"428":{"description":"Privileged MFA required"}}}
      },
      "/api/goodbase/v1/experience/telemetry/symbol-files": {
        "post": {"summary":"Upload dSYM, ProGuard/R8, NDK, Flutter, Unity, or Source Map symbols","tags":["Goodbase Product Platform"],"security":[{"GoodOSBearer":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["releaseId","symbolType","symbolFile"],"properties":{"releaseId":{"type":"string","format":"uuid"},"symbolType":{"type":"string","enum":["sourcemap","dsym","proguard","ndk","flutter","unity"]},"symbolFile":{"type":"string","format":"binary"},"metadata":{"type":"string"}}}}}},"responses":{"201":{"description":"Symbol artifact validated, checksummed, and activated"},"400":{"description":"Invalid symbol artifact"},"403":{"description":"Administrator role required"},"428":{"description":"Privileged MFA required"}}}
      },
      "/api/goodbase/v1/experience/telemetry/releases/{releaseId}/symbol-files": {
        "get": {"summary":"List verified symbol artifacts for a release","tags":["Goodbase Product Platform"],"security":[{"GoodOSBearer":[]}],"parameters":[{"in":"path","name":"releaseId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Release symbol inventory"},"403":{"description":"Administrator role required"}}}
      },
      "/api/internal/observability/alerts": {
        "post": {"summary":"Accept a timestamped, nonce-protected HMAC-signed Alertmanager webhook","tags":["Goodbase Observability"],"security":[],"parameters":[{"in":"header","name":"X-Goodbase-Timestamp","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-Goodbase-Nonce","required":true,"schema":{"type":"string"}},{"in":"header","name":"X-Goodbase-Signature","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Signed alerts accepted for durable delivery"},"401":{"description":"Signature invalid or expired"},"409":{"description":"Replay nonce detected"},"413":{"description":"Alert batch exceeds the bounded limit"}}}
      },
      "/api/goodbase/v1/production/observability/alerts": {
        "get": {"summary":"Read alert receipts, active instances, on-call policies, and delivery status","tags":["Goodbase Observability"],"security":[{"GoodOSBearer":[]}],"responses":{"200":{"description":"Auditable outbound alert delivery snapshot"},"403":{"description":"Administrator role required"}}}
      },
      "/api/goodbase/v1/production/observability/alerts/test": {
        "post": {"summary":"Run an end-to-end Goodbase outbound alert test","tags":["Goodbase Observability"],"security":[{"GoodOSBearer":[]}],"responses":{"202":{"description":"Test alert accepted and queued"},"428":{"description":"Privileged MFA required"}}}
      },
      "/api/goodbase/v1/product/experiments/{appId}/assignments": {
        "get": {"summary":"Resolve sticky experiment assignments","tags":["Goodbase Product Platform"],"security":[{"GoodOSBearer":[]}],"responses":{"200":{"description":"Stable assignments and variant payloads"}}}
      },
      "/api/goodbase/v1/product/overview": {
        "get": {"summary":"Read phases 31–38 operational state","tags":["Goodbase Product Platform"],"security":[{"GoodOSBearer":[]}],"responses":{"200":{"description":"Analytics, telemetry, experiment, distribution, CDN, regional and commercial metrics"},"403":{"description":"Administrator role required"}}}
      },
      "/api/goodscan/v1/health": {
        "get": {"summary":"Read public GoodScan service readiness","tags":["GoodScan"],"security":[],"responses":{"200":{"description":"GoodScan API and private storage readiness"}}}
      },
      "/api/goodscan/v1/workspace": {
        "get": {"summary":"Read the authenticated user's GoodScan assets, community gallery, analytics, devices, usage, and integrations","tags":["GoodScan"],"security":[{"GoodOSBearer":[]}],"responses":{"200":{"description":"Live GoodScan workspace snapshot"},"401":{"description":"Authentication required"},"403":{"description":"GoodScan application access required"}}}
      },
      "/api/goodscan/v1/device-pairings": {
        "post": {"summary":"Create a short-lived, one-time GoodScan desktop-to-phone pairing","tags":["GoodScan"],"security":[{"GoodOSBearer":[]}],"responses":{"201":{"description":"Pairing QR and status created"},"400":{"description":"Invalid desktop device"},"401":{"description":"Authentication required"},"403":{"description":"GoodScan application access required"},"429":{"description":"Pairing rate limit exceeded"}}}
      },
      "/api/goodscan/v1/device-pairings/{pairingId}": {
        "get": {"summary":"Read an owned GoodScan pairing status","tags":["GoodScan"],"security":[{"GoodOSBearer":[]}],"parameters":[{"in":"path","name":"pairingId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Pairing status"},"404":{"description":"Pairing not found"}}},
        "delete": {"summary":"Revoke an owned GoodScan pairing","tags":["GoodScan"],"security":[{"GoodOSBearer":[]}],"parameters":[{"in":"path","name":"pairingId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Pairing revoked"},"404":{"description":"Pairing not found"}}}
      },
      "/api/goodscan/v1/device-pairings/{pairingId}/claim": {
        "post": {"summary":"Claim a one-time GoodScan pairing from an authenticated phone","tags":["GoodScan"],"security":[{"GoodOSBearer":[]}],"parameters":[{"in":"path","name":"pairingId","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Phone paired"},"400":{"description":"Invalid device or secret"},"403":{"description":"Secret or account mismatch"},"409":{"description":"Pairing already used"},"410":{"description":"Pairing expired"},"429":{"description":"Claim rate limit exceeded"}}}
      },
      "/api/goodscan/v1/captures": {
        "post": {"summary":"Upload a validated GoodScan capture manifest and original media","tags":["GoodScan"],"security":[{"GoodOSBearer":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["manifest","sources"],"properties":{"manifest":{"type":"string","format":"binary"},"sources":{"type":"array","maxItems":500,"items":{"type":"string","format":"binary"}}}}}}},"responses":{"202":{"description":"Capture accepted and queued"},"400":{"description":"Invalid capture manifest"},"401":{"description":"Authentication required"},"403":{"description":"GoodScan application access required"},"413":{"description":"Capture limits exceeded"},"415":{"description":"Unsupported media type"},"429":{"description":"Upload rate limit exceeded"}}}
      },
      "/api/goodscan/v1/ai/capabilities": {
        "get": {"summary":"Report verified GoodScan AI generation providers and capabilities","tags":["GoodScan"],"security":[{"GoodOSBearer":[]}],"responses":{"200":{"description":"Honest provider capability status"},"401":{"description":"Authentication required"},"403":{"description":"GoodScan application access required"}}}
      },
      "/api/goodscan/v1/credits": {
        "get": {"summary":"Read the authenticated user's GoodScan credit balance, packs, purchases, and immutable usage ledger","tags":["GoodScan Billing"],"security":[{"GoodOSBearer":[]}],"responses":{"200":{"description":"GoodScan credit account summary"},"401":{"description":"Authentication required"},"403":{"description":"GoodScan application access required"}}}
      },
      "/api/goodscan/v1/credits/checkout-sessions": {
        "post": {"summary":"Create an idempotent Stripe-hosted checkout for a server-priced GoodScan credit pack","tags":["GoodScan Billing"],"security":[{"GoodOSBearer":[]}],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["productSku"],"properties":{"productSku":{"type":"string"}}}}}},"responses":{"201":{"description":"Checkout session created"},"400":{"description":"Invalid request or missing idempotency key"},"401":{"description":"Authentication required"},"402":{"description":"Payment required"},"403":{"description":"GoodScan application access required"},"503":{"description":"Stripe is not activated"}}}
      },
      "/api/goodscan/v1/credits/webhooks/stripe": {
        "post": {"summary":"Receive signature-verified, duplicate-safe Stripe events for GoodScan credit fulfillment and refunds","tags":["GoodScan Billing"],"security":[],"responses":{"200":{"description":"Verified event accepted"},"400":{"description":"Invalid webhook signature"},"500":{"description":"Verified event processing failed"},"503":{"description":"Webhook secret is not configured"}}}
      },
      "/api/goodscan/v1/ai/quote": {
        "post": {"summary":"Calculate the authoritative server-side credit cost for a GoodScan generation manifest","tags":["GoodScan Billing"],"security":[{"GoodOSBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["manifest"],"properties":{"manifest":{"type":"object"}}}}}},"responses":{"200":{"description":"Authoritative credit quote"},"400":{"description":"Invalid generation manifest"},"401":{"description":"Authentication required"},"403":{"description":"GoodScan application access required"}}}
      },
      "/api/goodscan/v1/ai/generations": {
        "post": {"summary":"Submit a metered GoodScan AI generation job when a verified provider is active","tags":["GoodScan"],"security":[{"GoodOSBearer":[]}],"responses":{"202":{"description":"Generation accepted and credits reserved"},"401":{"description":"Authentication required"},"402":{"description":"Insufficient credits"},"403":{"description":"GoodScan application access required"},"503":{"description":"Provider unavailable; no credits charged"}}}
      },
      "/api/goodbase/v1/ecosystem/overview": {
        "get": {"summary":"Read IaC, extension marketplace, and AI operational state","tags":["Goodbase Ecosystem"],"security":[{"GoodOSBearer":[]}],"responses":{"200":{"description":"Tenant ecosystem metrics"},"403":{"description":"Administrator role required"}}}
      },
      "/api/goodbase/v1/ecosystem/iac/stacks": {
        "get": {"summary":"List governed infrastructure stacks and runs","tags":["Goodbase IaC"],"security":[{"GoodOSBearer":[]}],"responses":{"200":{"description":"IaC stacks and recent runs"}}},
        "post": {"summary":"Register a locked Terraform or Pulumi stack","tags":["Goodbase IaC"],"security":[{"GoodOSBearer":[]}],"responses":{"201":{"description":"IaC stack registered"},"428":{"description":"Privileged MFA required"}}}
      },
      "/api/goodbase/v1/ecosystem/iac/stacks/{id}/runs": {
        "post": {"summary":"Queue an idempotent controller-backed IaC run","tags":["Goodbase IaC"],"security":[{"GoodOSBearer":[]}],"responses":{"202":{"description":"IaC run queued"},"409":{"description":"Rollback or state requirements are incomplete"},"503":{"description":"Verified controller unavailable"}}}
      },
      "/api/goodbase/v1/ecosystem/extensions": {
        "get": {"summary":"List signed extension packages and versions","tags":["Goodbase Extensions"],"security":[{"GoodOSBearer":[]}],"responses":{"200":{"description":"Extension catalog"}}},
        "post": {"summary":"Create a package for a verified publisher","tags":["Goodbase Extensions"],"security":[{"GoodOSBearer":[]}],"responses":{"201":{"description":"Draft extension package"}}}
      },
      "/api/goodbase/v1/ecosystem/extensions/{id}/install": {
        "post": {"summary":"Install a reviewed signed extension through a verified controller","tags":["Goodbase Extensions"],"security":[{"GoodOSBearer":[]}],"responses":{"202":{"description":"Extension installation queued"},"503":{"description":"Verified controller unavailable"}}}
      },
      "/api/goodbase/v1/ecosystem/extensions/installations/{id}/rollback": {
        "post": {"summary":"Roll back an extension through its verified controller and signed rollback manifest","tags":["Goodbase Extensions"],"security":[{"GoodOSBearer":[]}],"responses":{"202":{"description":"Extension rollback queued"},"409":{"description":"Installation has no verified rollback target"},"428":{"description":"Privileged MFA required"},"503":{"description":"Verified controller unavailable"}}}
      },
      "/api/goodbase/v1/ecosystem/ai/providers": {
        "get": {"summary":"List governed AI providers and models","tags":["Goodbase AI"],"security":[{"GoodOSBearer":[]}],"responses":{"200":{"description":"AI providers with secret references only"}}},
        "post": {"summary":"Register an unverified AI provider","tags":["Goodbase AI"],"security":[{"GoodOSBearer":[]}],"responses":{"201":{"description":"Provider registered pending live verification"}}}
      },
      "/api/goodbase/v1/ecosystem/ai/generate": {
        "post": {"summary":"Run an attested, quota and safety bounded AI generation","tags":["Goodbase AI"],"security":[{"GoodOSBearer":[]}],"responses":{"201":{"description":"Generation completed and metered"},"401":{"description":"Authentication or attestation required"},"429":{"description":"AI quota or rate limit exceeded"},"503":{"description":"Verified provider unavailable"}}}
      }
  }
}
