Quadrillion releases API

openapi: 3.1.0
info:
  title: Quadrillion Cloud account releases API
  description: Public cloud API service for cloud-safe backend endpoints
  version: 0.1.0
tags:
- name: releases
paths:
  /v1/releases/supported-platforms:
    get:
      tags:
      - releases
      summary: Get Supported Platforms
      description: "Get list of currently supported platform IDs.\n\nThis endpoint returns which platforms have releases available for download.\nThe frontend uses this to gray out unsupported platforms in the download UI.\n\nThis is public data for the marketing download page, so no authentication\nis required. CDN-friendly caching is enabled to reduce backend load.\n\nReturns:\n    SupportedPlatformsResponse with list of supported platform IDs\n\nExample:\n    GET /v1/releases/supported-platforms\n\n    Response:\n    {\n        \"supported\": [\n            \"macos-intel\",\n            \"macos-apple-silicon\",\n            \"windows-x64\",\n            \"linux-x64\"\n        ]\n    }"
      operationId: get_supported_platforms_v1_releases_supported_platforms_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SupportedPlatformsResponse'
  /v1/releases/{filename}:
    get:
      tags:
      - releases
      summary: Download Release
      description: "Get a presigned S3 URL and redirect the user's browser to download directly from S3.\n\nThis endpoint validates the file exists, generates a short-lived presigned\nURL (1 minute), and redirects the browser to download directly from S3\n(avoiding bandwidth costs on backend and Vercel).\n\nFiles are stored gzipped on S3 with Content-Encoding metadata (no extra .gz\nsuffix on the S3 key). Browsers and HTTP clients automatically decompress\nduring download, saving 30-60% bandwidth.\n\nArgs:\n    filename: Name of the release file to download\n    request: FastAPI request object (to access app state)\n\nReturns:\n    RedirectResponse to presigned S3 URL (browser downloads directly)\n\nExamples:\n    GET /v1/releases/qualia-v1.2.3-macos-apple-silicon.app\n\n    Response: 307 Redirect to https://bucket.s3.amazonaws.com/qualia-v1.2.3-macos-apple-silicon.app?X-Amz-..."
      operationId: download_release_v1_releases__filename__get
      parameters:
      - name: filename
        in: path
        required: true
        schema:
          type: string
          title: Filename
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SupportedPlatformsResponse:
      properties:
        supported:
          items:
            type: string
            enum:
            - macos-intel
            - macos-apple-silicon
            - windows-x64
            - windows-arm64
            - linux-x64
            - linux-arm64
          type: array
          title: Supported
      type: object
      required:
      - supported
      title: SupportedPlatformsResponse
      description: Response model for supported platforms endpoint.