{"openapi":"3.1.0","info":{"title":"SubcueAI Public API","version":"1.0.0","summary":"Read-only SubcueAI product information","description":"An unauthenticated REST API for discovering SubcueAI plans and current desktop releases. No user or interview data is exposed.","contact":{"name":"SubcueAI","url":"https://subcue.ai/developers","email":"contact@subcueai.com"},"license":{"name":"Proprietary","identifier":"LicenseRef-Proprietary"}},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","servers":[{"url":"https://subcue.ai","description":"Production"}],"security":[],"tags":[{"name":"Discovery","description":"API metadata and machine-readable entry points."},{"name":"Plans","description":"Public subscription plan and billing-cycle information."},{"name":"Releases","description":"Public desktop release information."}],"paths":{"/api/v1":{"get":{"operationId":"getApiIndex","summary":"Get the public API index","description":"Returns links to this documentation, the OpenAPI document, MCP endpoint, and public REST operations.","tags":["Discovery"],"responses":{"200":{"description":"Public API index.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiIndex"}}}},"400":{"description":"Malformed HTTP request."}}}},"/api/v1/plans":{"get":{"operationId":"getPlans","summary":"List subscription plans","description":"Returns current public plan prices, billing cycles, popularity flags, and monthly credit grants.","tags":["Plans"],"responses":{"200":{"description":"Current plans and billing cycles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlansResponse"}}}},"400":{"description":"Malformed HTTP request."},"502":{"description":"The product-data service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/releases/latest":{"get":{"operationId":"getLatestRelease","summary":"Get the latest desktop release","description":"Returns the latest release metadata for a supported desktop platform. A response with hasUpdate=false means no release is currently published for that platform.","tags":["Releases"],"parameters":[{"name":"platform","in":"query","required":false,"description":"Desktop platform. Defaults to macos.","schema":{"type":"string","enum":["macos","windows"],"default":"macos"}}],"responses":{"200":{"description":"Latest release lookup result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LatestReleaseResponse"}}}},"400":{"description":"The platform value is not supported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"The release service is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"ApiIndex":{"type":"object","additionalProperties":false,"required":["name","version","description","documentation","openapi","mcp","endpoints"],"properties":{"name":{"type":"string","const":"SubcueAI Public API"},"version":{"type":"string"},"description":{"type":"string"},"documentation":{"type":"string","format":"uri"},"openapi":{"type":"string","format":"uri"},"mcp":{"type":"string","format":"uri"},"endpoints":{"type":"object","additionalProperties":false,"required":["plans","latestRelease"],"properties":{"plans":{"type":"string","format":"uri"},"latestRelease":{"type":"string","format":"uri"}}}}},"BillingCycle":{"type":"object","additionalProperties":false,"required":["key","durationMonths","labelKey","savingBadge"],"properties":{"key":{"type":"string"},"durationMonths":{"type":"integer","minimum":1},"labelKey":{"type":"string"},"savingBadge":{"type":["string","null"]}}},"Plan":{"type":"object","additionalProperties":false,"required":["id","popular","prices","monthlyPrice","annualPrice","creditsMonthly"],"properties":{"id":{"type":"string"},"popular":{"type":"boolean"},"prices":{"type":"object","additionalProperties":{"type":"number","minimum":0}},"monthlyPrice":{"type":"number","minimum":0},"annualPrice":{"type":"number","minimum":0},"creditsMonthly":{"type":["integer","null"],"minimum":0}}},"PlansResponse":{"type":"object","additionalProperties":false,"required":["currency","cycles","plans"],"properties":{"currency":{"type":"string"},"cycles":{"type":"array","items":{"$ref":"#/components/schemas/BillingCycle"}},"plans":{"type":"array","items":{"$ref":"#/components/schemas/Plan"}}}},"Release":{"type":"object","additionalProperties":false,"required":["platform","version","changelog","downloadURL","size","date"],"properties":{"platform":{"type":"string","enum":["macos","windows"]},"version":{"type":"string"},"changelog":{"type":"string"},"downloadURL":{"type":"string","format":"uri"},"size":{"type":"string","description":"Installer size in bytes when known; otherwise an empty string."},"date":{"type":"string","description":"Release date supplied by SubcueAI."}}},"LatestReleaseResponse":{"oneOf":[{"type":"object","additionalProperties":false,"required":["hasUpdate"],"properties":{"hasUpdate":{"const":false}}},{"type":"object","additionalProperties":false,"required":["hasUpdate","forceUpdate","latest"],"properties":{"hasUpdate":{"const":true},"forceUpdate":{"type":"boolean"},"latest":{"$ref":"#/components/schemas/Release"}}}]},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"allowed":{"type":"array","items":{"type":"string"}}}}}},"externalDocs":{"description":"SubcueAI Developer Resources","url":"https://subcue.ai/developers"}}