openapi.yaml

components:
  schemas:
    analyticsv1.AnalyticsEvent:
      properties:
        timestamp:
          type: number
      type: object
    analyticsv1.CountryCount:
      properties:
        count:
          type: integer
        country:
          type: string
      type: object
    analyticsv1.DashboardPoint:
      properties:
        timestamp:
          type: string
        unique_users:
          type: integer
        views:
          type: integer
      type: object
    analyticsv1.DashboardStatsResponse:
      properties:
        points:
          items:
            $ref: '#/components/schemas/analyticsv1.DashboardPoint'
          type: array
          uniqueItems: false
      type: object
    analyticsv1.DateRange:
      properties:
        end:
          type: string
        start:
          type: string
      type: object
    analyticsv1.EventCount:
      properties:
        count:
          type: integer
        event_type:
          type: string
      type: object
    analyticsv1.FeedStats:
      properties:
        avg_time_per_visit_ms:
          type: number
        feed_id:
          type: string
        total_posts:
          type: integer
        total_views:
          type: integer
        total_watch_time_ms:
          type: number
        unique_viewers:
          type: integer
      type: object
    analyticsv1.FunnelAnalytics:
      properties:
        average_time_hours:
          type: number
        completed_users:
          type: integer
        completion_rate:
          type: number
        steps:
          items:
            $ref: '#/components/schemas/analyticsv1.FunnelStepResult'
          type: array
          uniqueItems: false
        total_users:
          type: integer
      type: object
    analyticsv1.FunnelRequest:
      properties:
        range:
          $ref: '#/components/schemas/analyticsv1.DateRange'
        steps:
          items:
            $ref: '#/components/schemas/analyticsv1.FunnelStep'
          type: array
          uniqueItems: false
        time_window:
          type: integer
      type: object
    analyticsv1.FunnelStep:
      properties:
        event_type:
          type: string
        filters:
          additionalProperties:
            type: string
          type: object
        name:
          type: string
        page_type:
          type: string
      type: object
    analyticsv1.FunnelStepResult:
      properties:
        conversion_rate:
          type: number
        dropoff_rate:
          type: number
        step_name:
          type: string
        user_count:
          type: integer
      type: object
    analyticsv1.GetPostStatsResponse:
      properties:
        post_id:
          type: string
        total_views:
          type: integer
        unique_viewers:
          type: integer
      type: object
    analyticsv1.HotSegment:
      properties:
        end_second:
          type: integer
        multiplier:
          type: number
        start_second:
          type: integer
      type: object
    analyticsv1.HotSegmentsResponse:
      properties:
        segments:
          items:
            $ref: '#/components/schemas/analyticsv1.HotSegment'
          type: array
          uniqueItems: false
      type: object
    analyticsv1.PostStats:
      properties:
        avg_watch_time_ms:
          type: number
        completion_rate:
          type: number
        completions:
          type: integer
        content_type:
          type: string
        feed_id:
          type: string
        post_id:
          type: string
        starts:
          type: integer
        total_views:
          type: integer
        total_watch_time_ms:
          type: integer
        unique_viewers:
          type: integer
        views_by_page:
          additionalProperties:
            type: integer
          type: object
      type: object
    analyticsv1.RealtimeStats:
      properties:
        active_users:
          type: integer
        events_per_minute:
          type: integer
        recent_events:
          items:
            $ref: '#/components/schemas/analyticsv1.RecentEvent'
          type: array
          uniqueItems: false
        timestamp:
          type: string
        top_countries:
          items:
            $ref: '#/components/schemas/analyticsv1.CountryCount'
          type: array
          uniqueItems: false
        top_events:
          items:
            $ref: '#/components/schemas/analyticsv1.EventCount'
          type: array
          uniqueItems: false
      type: object
    analyticsv1.RecentEvent:
      properties:
        content_id:
          type: string
        event_type:
          type: string
        timestamp:
          type: string
        user_id:
          type: string
      type: object
    analyticsv1.RetentionAnalytics:
      properties:
        cohorts:
          items:
            $ref: '#/components/schemas/analyticsv1.RetentionCohort'
          type: array
          uniqueItems: false
        period:
          type: string
      type: object
    analyticsv1.RetentionCohort:
      properties:
        cohort_date:
          type: string
        cohort_size:
          type: integer
        retention_data:
          items:
            type: number
          type: array
          uniqueItems: false
      type: object
    analyticsv1.TopFeedsResponse:
      properties:
        feeds:
          items:
            $ref: '#/components/schemas/analyticsv1.FeedStats'
          type: array
          uniqueItems: false
      type: object
    analyticsv1.TopPostsResponse:
      properties:
        posts:
          items:
            $ref: '#/components/schemas/analyticsv1.PostStats'
          type: array
          uniqueItems: false
      type: object
    analyticsv1.TopVideosResponse:
      properties:
        videos:
          items:
            $ref: '#/components/schemas/analyticsv1.VideoStats'
          type: array
          uniqueItems: false
      type: object
    analyticsv1.TrackEventsRequest:
      properties:
        country:
          type: string
        events:
          items:
            $ref: '#/components/schemas/analyticsv1.AnalyticsEvent'
          type: array
          uniqueItems: false
        user_id:
          type: string
      type: object
    analyticsv1.VideoHeatmap:
      properties:
        data:
          items:
            type: number
          type: array
          uniqueItems: false
        total_duration_ms:
          type: integer
        video_id:
          type: string
      type: object
    analyticsv1.VideoStats:
      properties:
        avg_watch_time_ms:
          type: number
        completion_rate:
          type: number
        completions:
          type: integer
        starts:
          type: integer
        total_views:
          type: integer
        total_watch_time_ms:
          type: number
        unique_viewers:
          type: integer
        video_id:
          type: string
        watches:
          type: integer
      type: object
    apikeysv1.ApiKey:
      properties:
        created_at:
          type: string
        expiring_at:
          type: string
        id:
          type: string
        last_used:
          type: string
        name:
          type: string
        org_id:
          type: string
        project_id:
          type: string
        project_name:
          type: string
        secret:
          type: string
      type: object
    apikeysv1.CreateApiKeyResponse:
      properties:
        api_key:
          $ref: '#/components/schemas/apikeysv1.ApiKey'
      type: object
    apikeysv1.DeleteApiKeyResponse:
      type: object
    apikeysv1.ListApiKeysResponse:
      properties:
        api_keys:
          items:
            $ref: '#/components/schemas/apikeysv1.ApiKey'
          type: array
          uniqueItems: false
        total:
          type: integer
      type: object
    apikeysv1.RotateApiKeyResponse:
      properties:
        api_key:
          $ref: '#/components/schemas/apikeysv1.ApiKey'
      type: object
    authv1.AcceptInvitationResponse:
      properties:
        message:
          type: string
        org_id:
          type: string
        org_name:
          type: string
        role:
          type: string
      type: object
    authv1.AuthMethod:
      enum:
      - 0
      - 1
      - 2
      type: integer
      x-enum-varnames:
      - AuthMethod_AUTH_METHOD_UNSPECIFIED
      - AuthMethod_AUTH_METHOD_PASSKEY
      - AuthMethod_AUTH_METHOD_TOTP
    authv1.AutoJoinSetting:
      properties:
        enabled:
          type: boolean
        present:
          type: boolean
      type: object
    authv1.BlogSubscriptionResponse:
      properties:
        subscribed:
          type: boolean
        subscribed_at:
          type: string
      type: object
    authv1.CheckMembershipResponse:
      properties:
        is_member:
          type: boolean
      type: object
    authv1.DomainResponse:
      properties:
        auto_join:
          type: boolean
        domain:
          type: string
        expires_at:
          type: string
        id:
          type: string
        message:
          type: string
        present:
          type: boolean
        status:
          type: string
        verification_token:
          type: string
        verified_at:
          type: string
      type: object
    authv1.EmailStatusResponse:
      properties:
        email:
          type: string
        has_email:
          type: boolean
        verified:
          type: boolean
      type: object
    authv1.GetInternalMembershipInfoResponse:
      properties:
        email:
          type: string
      type: object
    authv1.ListAttachmentsResponse:
      properties:
        attachments:
          items:
            $ref: '#/components/schemas/authv1.PolicyAttachment'
          type: array
          uniqueItems: false
      type: object
    authv1.ListMembershipsResponse:
      properties:
        memberships:
          items:
            $ref: '#/components/schemas/authv1.Membership'
          type: array
          uniqueItems: false
      type: object
    authv1.ListOrgMembersResponse:
      properties:
        members:
          items:
            $ref: '#/components/schemas/authv1.OrgMember'
          type: array
          uniqueItems: false
      type: object
    authv1.ListPasskeysResponse:
      properties:
        passkeys:
          items:
            $ref: '#/components/schemas/authv1.Passkey'
          type: array
          uniqueItems: false
      type: object
    authv1.ListPoliciesResponse:
      properties:
        policies:
          items:
            $ref: '#/components/schemas/authv1.Policy'
          type: array
          uniqueItems: false
      type: object
    authv1.ListProvidersResponse:
      properties:
        providers:
          items:
            $ref: '#/components/schemas/authv1.Provider'
          type: array
          uniqueItems: false
      type: object
    authv1.LoginResponse:
      properties:
        access_token:
          type: string
        authentication:
          description: |-
            authentication lists the 2FA methods the user has configured when
            status is "2fa_required". The public API renders these as lowercase
            strings: "passkey", "totp".
          items:
            $ref: '#/components/schemas/authv1.AuthMethod'
          type: array
          uniqueItems: false
        email:
          type: string
        expires_in:
          type: integer
        passkey_options:
          description: |-
            passkey_options is the WebAuthn PublicKeyCredentialRequestOptions as JSON,
            present only when "passkey" is one of the authentication methods.
          items:
            type: integer
          type: array
          uniqueItems: false
        refresh_token:
          type: string
        requires_action:
          type: string
        session_id:
          type: string
        status:
          description: '"ok" | "2fa_required" | "email_not_verified"'
          type: string
        token_type:
          type: string
      type: object
    authv1.MemberPoliciesResponse:
      properties:
        permissions:
          items:
            type: string
          type: array
          uniqueItems: false
        policies:
          items:
            $ref: '#/components/schemas/authv1.Policy'
          type: array
          uniqueItems: false
      type: object
    authv1.Membership:
      properties:
        id:
          type: string
        joined_at:
          type: string
        org_id:
          type: string
        organization_first_name:
          type: string
        organization_last_name:
          type: string
        organization_username:
          type: string
        role:
          type: string
        state:
          type: string
        user_id:
          type: string
      type: object
    authv1.MembershipMutation:
      properties:
        joined_at:
          type: string
        org_id:
          type: string
        org_name:
          type: string
        role:
          type: string
        state:
          type: string
        user_id:
          type: string
      type: object
    authv1.OTPStatusResponse:
      properties:
        created_at:
          type: string
        is_setup:
          type: boolean
        message:
          type: string
      type: object
    authv1.OrgMember:
      properties:
        first_name:
          type: string
        id:
          type: string
        invitation_expires_at:
          type: string
        joined_at:
          type: string
        last_name:
          type: string
        org_id:
          type: string
        role:
          type: string
        state:
          type: string
        user_id:
          type: string
        username:
          type: string
      type: object
    authv1.Passkey:
      properties:
        aaguid:
          type: string
        backup_state:
          type: boolean
        created_at:
          type: string
        credential_id:
          type: string
        id:
          type: string
        last_used_at:
          type: string
        name:
          type: string
        transports:
          items:
            type: string
          type: array
          uniqueItems: false
      type: object
    authv1.PasskeyBeginResponse:
      properties:
        options:
          items:
            type: integer
          type: array
          uniqueItems: false
        session_id:
          type: string
      type: object
    authv1.PasskeyRegisterFinishResponse:
      properties:
        name:
          type: string
        passkey_id:
          type: string
      type: object
    authv1.PermissionOffset:
      properties:
        name:
          type: string
        offset:
          type: integer
      type: object
    authv1.PermissionRegistryResponse:
      properties:
        permissions:
          items:
            $ref: '#/components/schemas/authv1.PermissionOffset'
          type: array
          uniqueItems: false
      type: object
    authv1.Policy:
      properties:
        created_at:
          type: string
        created_by:
          type: string
        description:
          type: string
        id:
          type: string
        name:
          type: string
        org_id:
          type: string
        permissions:
          items:
            type: string
          type: array
          uniqueItems: false
        updated_at:
          type: string
      type: object
    authv1.PolicyAttachment:
      properties:
        created_at:
          type: string
        id:
          type: string
        identity_id:
          type: string
        identity_type:
          type: string
        policy_id:
          type: string
      type: object
    authv1.Provider:
      properties:
        email_address:
          type: string
        first_name:
          type: string
        image_url:
          type: string
        last_name:
          type: string
        provider:
          type: string
        username:
          type: string
      type: object
    authv1.RegisterResponse:
      properties:
        email_verification_sent:
          type: boolean
        message:
          type: string
        user_id:
          type: string
        verification_id:
          type: string
      type: object
    authv1.ResendVerificationResponse:
      properties:
        code_sent:
          type: boolean
        message:
          type: string
        verification_id:
          type: string
      type: object
    authv1.SetupOTPResponse:
      properties:
        qr_code_url:
          type: string
        secret:
          type: string
      type: object
    authv1.StatusResponse:
      properties:
        status:
          type: string
      type: object
    authv1.TokenResponse:
      properties:
        access_token:
          type: string
        expires_in:
          type: integer
        refresh_token:
          type: string
        requires_action:
          type: string
        token_type:
          type: string
      type: object
    authv1.UpdateNameResponse:
      properties:
        first_name:
          type: string
        last_name:
          type: string
      type: object
    authv1.UpdateOrgNameResponse:
      properties:
        first_name:
          type: string
        last_name:
          type: string
      type: object
    authv1.UpdateOrgUsernameResponse:
      properties:
        username:
          type: string
      type: object
    authv1.UpdateUsernameResponse:
      properties:
        username:
          type: string
      type: object
    authv1.UserInfo:
      properties:
        active_org_id:
          type: string
        country_code:
          type: string
        email:
          type: string
        email_verified:
          type: boolean
        first_name:
          type: string
        id:
          type: string
        image_url:
          type: string
        language_code:
          type: string
        last_name:
          type: string
        username:
          type: string
      type: object
    authv1.VerificationSentResponse:
      properties:
        can_resend_at:
          type: string
        code_sent:
          type: boolean
        message:
          type: string
        verification_id:
          type: string
      type: object
    authv1.VerifyEmailResponse:
      properties:
        email:
          type: string
        message:
          type: string
        tokens:
          $ref: '#/components/schemas/authv1.TokenResponse'
        verified:
          type: boolean
      type: object
    billingv1.BandwidthUsage:
      properties:
        created_at:
          type: string
        data_source:
          type: string
        image_bandwidth_bytes:
          type: integer
        image_requests:
          type: integer
        org_id:
          type: string
        snapshot_date:
          type: string
        snapshot_type:
          type: string
        total_bandwidth_bytes:
          type: integer
        total_requests:
          type: integer
        unique_visitors:
          type: integer
        video_bandwidth_bytes:
          type: integer
        video_requests:
          type: integer
      type: object
    billingv1.BillingAddress:
      properties:
        city:
          type: string
        country:
          type: string
        email:
          type: string
        line1:
          type: string
        line2:
          type: string
        name:
          type: string
        phone:
          type: string
        postal_code:
          type: string
        state:
          type: string
      type: object
    billingv1.CreateSubscriptionResponse:
      properties:
        cancel_at_period_end:
          type: boolean
        current_period_end:
          type: string
        id:
          type: string
        org_id:
          type: string
        plan_id:
          type: string
        status:
          type: string
        stripe_customer_id:
          type: string
        stripe_subscription_id:
          type: string
      type: object
    billingv1.GetBandwidthUsageHistoryResponse:
      properties:
        total:
          type: integer
        usages:
          items:
            $ref: '#/components/schemas/billingv1.BandwidthUsage'
          type: array
          uniqueItems: false
      type: object
    billingv1.GetPlanResponse:
      properties:
        currency:
          type: string
        description:
          type: string
        id:
          type: string
        interval:
          type: string
        name:
          type: string
        price:
          type: string
      type: object
    billingv1.GetStorageUsageHistoryResponse:
      properties:
        total:
          type: integer
        usages:
          items:
            $ref: '#/components/schemas/billingv1.StorageUsage'
          type: array
          uniqueItems: false
      type: object
    billingv1.GetSubscriptionHistoryResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/billingv1.SubscriptionHistoryItem'
          type: array
          uniqueItems: false
      type: object
    billingv1.HostedCheckoutSessionResponse:
      properties:
        amount:
          type: number
        currency:
          type: string
        session_id:
          type: string
        session_url:
          type: string
        status:
          type: string
      type: object
    billingv1.Invoice:
      properties:
        amount:
          type: string
        created_at:
          type: string
        currency:
          type: string
        description:
          type: string
        due_date:
          type: string
        id:
          type: string
        org_id:
          type: string
        paid_at:
          type: string
        status:
          type: string
        subscription_id:
          type: string
      type: object
    billingv1.ListInvoicesResponse:
      properties:
        invoices:
          items:
            $ref: '#/components/schemas/billingv1.Invoice'
          type: array
          uniqueItems: false
      type: object
    billingv1.ListPaymentMethodsResponse:
      properties:
        payment_methods:
          items:
            $ref: '#/components/schemas/billingv1.PaymentMethod'
          type: array
          uniqueItems: false
      type: object
    billingv1.ListPlansResponse:
      properties:
        plans:
          items:
            $ref: '#/components/schemas/billingv1.Plan'
          type: array
          uniqueItems: false
      type: object
    billingv1.PaymentMethod:
      properties:
        created_at:
          type: string
        details:
          type: string
        id:
          type: string
        is_default:
          type: boolean
        org_id:
          type: string
        provider:
          type: string
        type:
          type: string
      type: object
    billingv1.PaymentMethodDetails:
      properties:
        brand:
          type: string
        exp_month:
          type: integer
        exp_year:
          type: integer
        id:
          type: string
        is_default:
          type: boolean
        last4:
          type: string
        type:
          type: string
      type: object
    billingv1.PaymentMethodIdResponse:
      properties:
        payment_method_id:
          type: string
        setup_intent_id:
          type: string
        status:
          type: string
      type: object
    billingv1.Plan:
      properties:
        currency:
          type: string
        description:
          type: string
        id:
          type: string
        interval:
          type: string
        interval_count:
          type: integer
        name:
          type: string
        plan_type:
          type: string
        price:
          type: string
        sort_order:
          type: integer
      type: object
    billingv1.PlanTaxCalculationResponse:
      properties:
        amount_total:
          type: integer
        base_amount:
          type: integer
        billing_address:
          $ref: '#/components/schemas/billingv1.BillingAddress'
        billing_cycle:
          type: string
        calculated_at:
          type: string
        calculation_id:
          type: string
        currency:
          type: string
        plan_id:
          type: string
        plan_name:
          type: string
        tax_amount_exclusive:
          type: integer
        tax_amount_inclusive:
          type: integer
        tax_percentage:
          type: number
      type: object
    billingv1.SalesLead:
      properties:
        company:
          type: string
        created_at:
          type: string
        email:
          type: string
        first_name:
          type: string
        id:
          type: string
        job_title:
          type: string
        last_name:
          type: string
        message:
          type: string
        org_id:
          type: string
        phone:
          type: string
        status:
          type: string
        user_id:
          type: string
        website:
          type: string
      type: object
    billingv1.SetupIntentResponse:
      properties:
        client_secret:
          type: string
        setup_intent_id:
          type: string
      type: object
    billingv1.StorageUsage:
      properties:
        image_file_count:
          type: integer
        image_storage_bytes:
          type: integer
        last_updated:
          type: string
        max_image_count:
          type: integer
        max_project_count:
          type: integer
        max_video_count:
          type: integer
        org_id:
          type: string
        project_count:
          type: integer
        snapshot_date:
          type: string
        total_file_count:
          type: integer
        total_storage_bytes:
          type: integer
        total_video_minutes:
          type: string
        video_file_count:
          type: integer
        video_storage_bytes:
          type: integer
      type: object
    billingv1.Subscription:
      properties:
        cancel_at_period_end:
          type: boolean
        currency:
          type: string
        current_period_end:
          type: string
        expiring_soon:
          type: boolean
        id:
          type: string
        org_id:
          type: string
        plan_id:
          type: string
        plan_name:
          type: string
        plan_type:
          type: string
        price:
          type: string
        status:
          type: string
        trials_ending_soon:
          type: boolean
      type: object
    billingv1.SubscriptionHistoryItem:
      properties:
        cancel_at_period_end:
          type: boolean
        created_at:
          type: string
        currency:
          type: string
        current_period_end:
          type: string
        end_date:
          type: string
        id:
          type: string
        org_id:
          type: string
        plan_id:
          type: string
        plan_name:
          type: string
        price:
          type: string
        start_date:
          type: string
        status:
          type: string
      type: object
    billingv1.UpgradeSubscriptionResponse:
      properties:
        client_secret:
          type: string
      type: object
    clientauthv1.ClientCredential:
      properties:
        alg:
          type: string
        client_id:
          type: string
        created_at:
          type: string
        id:
          type: string
        kid:
          type: string
        last_used_at:
          type: string
        name:
          type: string
        status:
          type: string
      type: object
    clientauthv1.CreateClientCredentialResponse:
      properties:
        client_secret:
          type: string
        credential:
          $ref: '#/components/schemas/clientauthv1.ClientCredential'
      type: object
    clientauthv1.ListClientCredentialsResponse:
      properties:
        credentials:
          items:
            $ref: '#/components/schemas/clientauthv1.ClientCredential'
          type: array
          uniqueItems: false
        total:
          type: integer
      type: object
    clientauthv1.MintClientTokenResponse:
      properties:
        access_token:
          type: string
        expires_at:
          type: string
        expires_in:
          type: integer
        token_type:
          type: string
      type: object
    clientauthv1.RevokeClientCredentialResponse:
      type: object
    feedsv1.DeleteFeedResponse:
      type: object
    feedsv1.Feed:
      properties:
        allow_images:
          type: boolean
        allow_videos:
          type: boolean
        created_at:
          type: string
        description:
          type: string
        has_comments:
          type: boolean
        has_likes:
          type: boolean
        has_shares:
          type: boolean
        id:
          type: string
        name:
          type: string
        project_id:
          type: string
        updated_at:
          type: string
      type: object
    feedsv1.ListFeedsResponse:
      properties:
        feeds:
          items:
            $ref: '#/components/schemas/feedsv1.Feed'
          type: array
          uniqueItems: false
        total:
          type: integer
      type: object
    gateway.addEmailBody:
      properties:
        email:
          type: string
      required:
      - email
      type: object
    gateway.attachPolicyBody:
      properties:
        identity_id:
          type: string
        identity_type:
          type: string
      required:
      - identity_id
      - identity_type
      type: object
    gateway.autoJoinBody:
      properties:
        enabled:
          type: boolean
      type: object
    gateway.billingAddressBody:
      properties:
        city:
          type: string
        country:
          type: string
        email:
          type: string
        line1:
          type: string
        line2:
          type: string
        name:
          type: string
        phone:
          type: string
        postal_code:
          type: string
        state:
          type: string
      type: object
    gateway.calculateTaxBody:
      properties:
        amount:
          type: number
        billing_address:
          $ref: '#/components/schemas/gateway.billingAddressBody'
        billing_cycle:
          type: string
        currency:
          type: string
        interval_count:
          type: integer
        line_items:
          items:
            $ref: '#/components/schemas/gateway.taxLineItemBody'
          type: array
          uniqueItems: false
        metadata:
          additionalProperties:
            type: string
          type: object
        plan_id:
          type: string
        plan_name:
          type: string
      type: object
    gateway.changeEmailBody:
      properties:
        new_email:
          type: string
      required:
      - new_email
      type: object
    gateway.chapterBody:
      properties:
        start_time_sec:
          type: number
        title:
          type: string
      required:
      - title
      type: object
    gateway.checkoutBody:
      properties:
        cancel_url:
          type: string
        stripe_price_id:
          type: string
        success_url:
          type: string
      type: object
    gateway.completeTrackItem:
      properties:
        id:
          type: string
        object_key:
          type: string
        size:
          type: integer
      required:
      - id
      - object_key
      type: object
    gateway.completeTrackUploadBody:
      properties:
        items:
          items:
            $ref: '#/components/schemas/gateway.completeTrackItem'
          minItems: 1
          type: array
          uniqueItems: false
      required:
      - items
      type: object
    gateway.completeUploadBody:
      properties:
        post_id:
          type: string
      required:
      - post_id
      type: object
    gateway.connectProviderBody:
      properties:
        provider:
          enum:
          - google
          - apple
          - microsoft
          - tgAuthResult
          type: string
        token:
          type: string
      required:
      - provider
      - token
      type: object
    gateway.contactSalesBody:
      properties:
        company:
          type: string
        email:
          type: string
        first_name:
          type: string
        job_title:
          type: string
        last_name:
          type: string
        message:
          type: string
        phone:
          type: string
        website:
          type: string
      required:
      - company
      - email
      - first_name
      - last_name
      - phone
      type: object
    gateway.createDomainBody:
      properties:
        domain:
          type: string
      required:
      - domain
      type: object
    gateway.createImageUploadBody:
      properties:
        format:
          type: string
        name:
          type: string
      required:
      - name
      type: object
    gateway.createPostBody:
      properties:
        creator_id:
          type: string
        description:
          type: string
        image_id:
          type: string
        type:
          enum:
          - video
          - image
          type: string
        video_id:
          type: string
      required:
      - type
      type: object
    gateway.createSubscriptionBody:
      properties:
        billing_address:
          $ref: '#/components/schemas/gateway.billingAddressBody'
        payment_method_id:
          type: string
        stripe_price_id:
          type: string
      type: object
    gateway.createVideoUploadBody:
      properties:
        image_format:
          type: string
        name:
          type: string
        video_quality:
          type: string
      required:
      - name
      type: object
    gateway.emailBody:
      properties:
        email:
          type: string
      required:
      - email
      type: object
    gateway.initTrackUploadBody:
      properties:
        items:
          items:
            $ref: '#/components/schemas/gateway.trackUploadItem'
          minItems: 1
          type: array
          uniqueItems: false
      required:
      - items
      type: object
    gateway.initUploadBody:
      properties:
        content_type:
          enum:
          - image
          - video
          type: string
        creator_id:
          type: string
        description:
          type: string
        file_name:
          type: string
        format:
          type: string
        image_format:
          type: string
        video_quality:
          type: string
      required:
      - content_type
      - file_name
      - format
      type: object
    gateway.inviteMemberBody:
      properties:
        role:
          enum:
          - admin
          - member
          type: string
        username:
          maxLength: 24
          minLength: 1
          type: string
      required:
      - role
      - username
      type: object
    gateway.membershipStateBody:
      properties:
        state:
          enum:
          - accepted
          - declined
          type: string
      required:
      - state
      type: object
    gateway.passkeyLoginFinishBody:
      properties:
        credential:
          items:
            type: integer
          type: array
          uniqueItems: false
        session_id:
          type: string
      required:
      - session_id
      type: object
    gateway.passkeyRegisterFinishBody:
      properties:
        credential:
          items:
            type: integer
          type: array
          uniqueItems: false
        name:
          maxLength: 64
          type: string
        session_id:
          type: string
      required:
      - session_id
      type: object
    gateway.passkeyVerifyBody:
      properties:
        credential:
          items:
            type: integer
          type: array
          uniqueItems: false
        session_id:
          type: string
      required:
      - session_id
      type: object
    gateway.policyBody:
      properties:
        description:
          type: string
        name:
          type: string
        permissions:
          items:
            type: string
          minItems: 1
          type: array
          uniqueItems: false
      required:
      - name
      - permissions
      type: object
    gateway.registerBody:
      properties:
        email:
          type: string
        password:
          minLength: 8
          type: string
        subscribe_to_blog:
          type: boolean
      required:
      - email
      - password
      type: object
    gateway.registerOrLoginBody:
      properties:
        email:
          type: string
        password:
          minLength: 8
          type: string
      required:
      - email
      - password
      type: object
    gateway.renamePasskeyBody:
      properties:
        name:
          maxLength: 64
          type: string
      required:
      - name
      type: object
    gateway.resendInviteBody:
      properties:
        user_id:
          type: string
      required:
      - user_id
      type: object
    gateway.resetPasswordBody:
      properties:
        new_password:
          minLength: 8
          type: string
        token:
          type: string
      required:
      - new_password
      - token
      type: object
    gateway.taxLineItemBody:
      properties:
        amount:
          type: integer
        reference:
          type: string
        tax_code:
          type: string
      type: object
    gateway.trackUploadItem:
      properties:
        file_name:
          type: string
        format:
          type: string
        label:
          type: string
        language_code:
          type: string
        size:
          type: integer
      required:
      - file_name
      - format
      - language_code
      type: object
    gateway.unsubscribeBlogByEmailBody:
      properties:
        email:
          type: string
        user_id:
          type: string
      required:
      - email
      - user_id
      type: object
    gateway.updateChaptersBody:
      properties:
        chapters:
          items:
            $ref: '#/components/schemas/gateway.chapterBody'
          type: array
          uniqueItems: false
      type: object
    gateway.updateInvoiceStatusBody:
      properties:
        status:
          type: string
      type: object
    gateway.updateNameBody:
      properties:
        full_name:
          maxLength: 30
          type: string
      required:
      - full_name
      type: object
    gateway.updateOrgNameBody:
      properties:
        full_name:
          maxLength: 30
          type: string
      required:
      - full_name
      type: object
    gateway.updateOrgUsernameBody:
      properties:
        username:
          maxLength: 24
          type: string
      required:
      - username
      type: object
    gateway.updateRoleBody:
      properties:
        role:
          enum:
          - admin
          - member
          type: string
      required:
      - role
      type: object
    gateway.updateUsernameBody:
      properties:
        username:
          maxLength: 24
          type: string
      required:
      - username
      type: object
    gateway.updateVisibilityBody:
      properties:
        visibility:
          enum:
          - public
          - unlisted
          - private
          type: string
      required:
      - visibility
      type: object
    gateway.upgradeSubscriptionBody:
      properties:
        stripe_price_id:
          type: string
      type: object
    gateway.upsertPaymentMethodBody:
      properties:
        payment_method_id:
          type: string
        set_as_default:
          type: boolean
      type: object
    gateway.verifyEmailBody:
      properties:
        code:
          type: string
        verification_id:
          type: string
      required:
      - code
      - verification_id
      type: object
    gateway.verifyOTPBody:
      properties:
        code:
          type: string
      required:
      - code
      type: object
    gateway.verifyTOTPLoginBody:
      properties:
        code:
          type: string
        session_id:
          type: string
      required:
      - code
      - session_id
      type: object
    imagesv1.DeleteResult:
      properties:
        deleted:
          type: boolean
        id:
          type: string
      type: object
    imagesv1.GetImageResponse:
      properties:
        attached_to_video:
          type: boolean
        file:
          $ref: '#/components/schemas/imagesv1.ImageFile'
        height:
          type: integer
        id:
          type: string
        thumbhash:
          type: string
        visibility:
          $ref: '#/components/schemas/imagesv1.Visibility'
        width:
          type: integer
      type: object
    imagesv1.ImageFile:
      properties:
        format:
          type: string
        id:
          type: string
        name:
          type: string
        project_id:
          type: string
        size:
          type: integer
        status:
          type: string
        url:
          type: string
      type: object
    imagesv1.ImageSummary:
      properties:
        created_at:
          type: string
        format:
          type: string
        height:
          type: integer
        id:
          type: string
        name:
          type: string
        size:
          type: integer
        thumbhash:
          type: string
        url:
          type: string
        visibility:
          $ref: '#/components/schemas/imagesv1.Visibility'
        width:
          type: integer
      type: object
    imagesv1.ImageUploadInit:
      properties:
        expires_at:
          type: string
        image_id:
          type: string
        upload_url:
          type: string
      type: object
    imagesv1.ListImagesResponse:
      properties:
        images:
          items:
            $ref: '#/components/schemas/imagesv1.ImageSummary'
          type: array
          uniqueItems: false
      type: object
    imagesv1.Visibility:
      enum:
      - 0
      - 1
      - 2
      - 3
      type: integer
      x-enum-varnames:
      - Visibility_VISIBILITY_UNSPECIFIED
      - Visibility_VISIBILITY_PUBLIC
      - Visibility_VISIBILITY_UNLISTED
      - Visibility_VISIBILITY_PRIVATE
    postsv1.DeleteResult:
      properties:
        deleted:
          type: boolean
        id:
          type: string
      type: object
    postsv1.ListPostsResponse:
      properties:
        posts:
          items:
            $ref: '#/components/schemas/postsv1.Post'
          type: array
          uniqueItems: false
        total:
          type: integer
      type: object
    postsv1.Post:
      properties:
        created_at:
          type: string
        creator_id:
          type: string
        description:
          type: string
        feed_id:
          type: string
        id:
          type: string
        image:
          $ref: '#/components/schemas/postsv1.PostImage'
        image_id:
          type: string
        type:
          type: string
        video:
          $ref: '#/components/schemas/postsv1.PostVideo'
        video_id:
          type: string
      type: object
    postsv1.PostFile:
      properties:
        format:
          type: string
        id:
          type: string
        name:
          type: string
        project_id:
          type: string
        size:
          type: integer
        status:
          type: string
        url:
          type: string
      type: object
    postsv1.PostImage:
      properties:
        attached_to_video:
          type: boolean
        file:
          $ref: '#/components/schemas/postsv1.PostFile'
        height:
          type: integer
        id:
          type: string
        thumbhash:
          type: string
        width:
          type: integer
      type: object
    postsv1.PostUploadInit:
      properties:
        content_id:
          type: string
        content_upload_url:
          type: string
        post_id:
          type: string
        poster_id:
          type: string
        poster_upload_url:
          type: string
        upload_expires:
          type: integer
      type: object
    postsv1.PostVideo:
      properties:
        bitrate:
          type: integer
        codec:
          type: string
        duration:
          type: number
        file:
          $ref: '#/components/schemas/postsv1.PostFile'
        framerate:
          type: string
        hdr:
          type: boolean
        height:
          type: integer
        id:
          type: string
        poster:
          $ref: '#/components/schemas/postsv1.PostImage'
        width:
          type: integer
      type: object
    projectsv1.ListProjectsResponse:
      properties:
        projects:
          items:
            $ref: '#/components/schemas/projectsv1.Project'
          type: array
          uniqueItems: false
      type: object
    projectsv1.Project:
      properties:
        created_at:
          type: string
        custom_domain:
          type: string
        id:
          type: string
        name:
          type: string
        org_id:
          type: string
        regions:
          items:
            type: string
          type: array
          uniqueItems: false
        updated_at:
          type: string
        video_quality:
          type: string
      type: object
    sqlc.VideoQuality:
      enum:
      - basic
      - shorts
      - pro
      type: string
      x-enum-varnames:
      - VideoQualityBasic
      - VideoQualityShorts
      - VideoQualityPro
    types.CreateAPIKeyRequest:
      properties:
        expiring_at:
          type: string
        name:
          type: string
        project_id:
          type: string
      required:
      - name
      - project_id
      type: object
    types.CreateClientCredentialRequest:
      properties:
        alg:
          type: string
        name:
          type: string
      required:
      - name
      type: object
    types.CreateFeedRequest:
      properties:
        allow_images:
          type: boolean
        allow_videos:
          type: boolean
        description:
          type: string
        has_comments:
          type: boolean
        has_likes:
          type: boolean
        has_shares:
          type: boolean
        name:
          type: string
        project_id:
          type: string
      required:
      - name
      - project_id
      type: object
    types.CreateProjectRequest:
      properties:
        name:
          example: My Project
          type: string
        regions:
          example:
          - iso
          - eu
          items:
            type: string
          type: array
          uniqueItems: false
        video_quality:
          $ref: '#/components/schemas/sqlc.VideoQuality'
          example: basic
      required:
      - name
      type: object
    types.CustomDomainRequest:
      properties:
        custom_domain:
          example: docs.example.com
          type: string
      required:
      - custom_domain
      type: object
    types.ExchangeRequest:
      properties:
        api_key:
          type: string
      required:
      - api_key
      type: object
    types.MintClientTokenRequest:
      properties:
        client_id:
          type: string
        client_secret:
          type: string
        project_id:
          type: string
        subject:
          type: string
        ttl_minutes:
          type: integer
      required:
      - client_id
      - client_secret
      - subject
      type: object
    types.MoveProjectRequest:
      properties:
        target_organization_id:
          example: OR98234j23
          type: string
      required:
      - target_organization_id
      type: object
    types.RefreshRequest:
      properties:
        refresh_token:
          type: string
      required:
      - refresh_token
      type: object
    types.TokenResponse:
      properties:
        access_token:
          type: string
        expires_at:
          type: string
        expires_in:
          type: integer
        refresh_token:
          type: string
        token_type:
          type: string
      type: object
    types.UpdateFeedRequest:
      properties:
        allow_images:
          type: boolean
        allow_videos:
          type: boolean
        description:
          type: string
        has_comments:
          type: boolean
        has_likes:
          type: boolean
        has_shares:
          type: boolean
        name:
          type: string
      required:
      - name
      type: object
    types.UpdateProjectNameRequest:
      properties:
        name:
          example: New Project Name
          type: string
      required:
      - name
      type: object
    types.UpdateVideoQualityRequest:
      properties:
        video_quality:
          $ref: '#/components/schemas/sqlc.VideoQuality'
          example: shorts
      required:
      - video_quality
      type: object
    videosv1.AudioTrack:
      properties:
        codec:
          type: string
        id:
          type: string
        label:
          type: string
        language_code:
          type: string
        video_id:
          type: string
      type: object
    videosv1.Chapter:
      properties:
        start_time_sec:
          type: number
        title:
          type: string
      type: object
    videosv1.DeleteResult:
      properties:
        deleted:
          type: boolean
        id:
          type: string
      type: object
    videosv1.GetVideoResponse:
      properties:
        bitrate:
          type: integer
        codec:
          type: string
        duration:
          type: number
        framerate:
          type: string
        hdr:
          type: boolean
        height:
          type: integer
        id:
          type: string
        visibility:
          $ref: '#/components/schemas/videosv1.Visibility'
        width:
          type: integer
      type: object
    videosv1.Language:
      properties:
        code:
          type: string
        name:
          type: string
      type: object
    videosv1.ListAudioTracksResponse:
      properties:
        audio_tracks:
          items:
            $ref: '#/components/schemas/videosv1.AudioTrack'
          type: array
          uniqueItems: false
      type: object
    videosv1.ListLanguagesResponse:
      properties:
        languages:
          items:
            $ref: '#/components/schemas/videosv1.Language'
          type: array
          uniqueItems: false
      type: object
    videosv1.ListSubtitlesResponse:
      properties:
        subtitles:
          items:
            $ref: '#/components/schemas/videosv1.Subtitle'
          type: array
          uniqueItems: false
      type: object
    videosv1.ListVideosResponse:
      properties:
        videos:
          items:
            $ref: '#/components/schemas/videosv1.VideoSummary'
          type: array
          uniqueItems: false
      type: object
    videosv1.Subtitle:
      properties:
        format:
          type: string
        id:
          type: string
        label:
          type: string
        language_code:
          type: string
        video_id:
          type: string
        vtt_path:
          type: string
      type: object
    videosv1.TrackUploadInit:
      properties:
        expires_at:
          type: string
        targets:
          items:
            $ref: '#/components/schemas/videosv1.TrackUploadTarget'
          type: array
          uniqueItems: false
      type: object
    videosv1.TrackUploadTarget:
      properties:
        id:
          type: string
        language_code:
          type: string
        object_key:
          type: string
        upload_url:
          type: string
      type: object
    videosv1.UploadAck:
      properties:
        count:
          type: integer
        ok:
          type: boolean
      type: object
    videosv1.UploadVideoThumbnailResponse:
      properties:
        thumbnail_url:
          type: string
      type: object
    videosv1.VideoChapters:
      properties:
        chapters:
          items:
            $ref: '#/components/schemas/videosv1.Chapter'
          type: array
          uniqueItems: false
        video_id:
          type: string
      type: object
    videosv1.VideoSummary:
      properties:
        codec:
          type: string
        created_at:
          type: string
        duration:
          type: number
        height:
          type: integer
        id:
          type: string
        name:
          type: string
        size:
          type: integer
        visibility:
          $ref: '#/components/schemas/videosv1.Visibility'
        width:
          type: integer
      type: object
    videosv1.VideoUploadInit:
      properties:
        expires_at:
          type: string
        poster_id:
          type: string
        poster_upload_url:
          type: string
        video_id:
          type: string
        video_upload_url:
          type: string
      type: object
    videosv1.Visibility:
      enum:
      - 0
      - 1
      - 2
      - 3
      type: integer
      x-enum-varnames:
      - Visibility_VISIBILITY_UNSPECIFIED
      - Visibility_VISIBILITY_PUBLIC
      - Visibility_VISIBILITY_UNLISTED
      - Visibility_VISIBILITY_PRIVATE
  securitySchemes:
    Bearer:
      in: header
      name: X-API-Key
      type: apiKey
externalDocs:
  description: ""
  url: ""
info:
  description: Customer-facing API gateway. Requests are proxied to gRPC backends.
  title: RIXL API Gateway
  version: "1.0"
openapi: 3.1.0
paths:
  /analytics/v1/dashboard:
    get:
      description: Returns time-bucketed dashboard statistics
      parameters:
      - description: Start time (RFC3339)
        in: query
        name: start_time
        required: true
        schema:
          type: string
      - description: End time (RFC3339)
        in: query
        name: end_time
        required: true
        schema:
          type: string
      - description: Bucket interval (1m, 1h, 1d)
        in: query
        name: interval
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/analyticsv1.DashboardStatsResponse'
          description: OK
      security:
      - Bearer: []
      summary: Dashboard analytics
      tags:
      - Analytics
  /analytics/v1/events:
    post:
      description: Ingest a batch of analytics events for the authenticated organization
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/analyticsv1.TrackEventsRequest'
              description: Analytics events
              summary: request
        description: Analytics events
        required: true
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Track analytics events
      tags:
      - Analytics
  /analytics/v1/feeds/{feedId}/stats:
    get:
      description: Returns aggregated statistics for a feed over a date range
      parameters:
      - description: Feed ID
        in: path
        name: feedId
        required: true
        schema:
          type: string
      - description: Start date (inclusive)
        in: query
        name: start
        schema:
          type: string
      - description: End date (inclusive)
        in: query
        name: end
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/analyticsv1.FeedStats'
          description: OK
      security:
      - Bearer: []
      summary: Get feed statistics
      tags:
      - Analytics
  /analytics/v1/funnels:
    post:
      description: Calculate funnel conversion across a sequence of steps
      parameters:
      - description: Start date (inclusive)
        in: query
        name: start
        schema:
          type: string
      - description: End date (inclusive)
        in: query
        name: end
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/analyticsv1.FunnelRequest'
              description: Funnel definition
              summary: request
        description: Funnel definition
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/analyticsv1.FunnelAnalytics'
          description: OK
      security:
      - Bearer: []
      summary: Funnel analytics
      tags:
      - Analytics
  /analytics/v1/posts/{postId}/stats:
    get:
      description: Returns aggregated statistics for a post
      parameters:
      - description: Post ID
        in: path
        name: postId
        required: true
        schema:
          type: string
      - description: Start date (inclusive)
        in: query
        name: start
        schema:
          type: string
      - description: End date (inclusive)
        in: query
        name: end
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/analyticsv1.GetPostStatsResponse'
          description: OK
      security:
      - Bearer: []
      summary: Get post statistics
      tags:
      - Analytics
  /analytics/v1/realtime:
    get:
      description: Returns real-time analytics snapshot
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/analyticsv1.RealtimeStats'
          description: OK
      security:
      - Bearer: []
      summary: Realtime analytics
      tags:
      - Analytics
  /analytics/v1/retention:
    get:
      description: Returns retention cohorts over a date range
      parameters:
      - description: Cohort period (day, week, month)
        in: query
        name: period
        schema:
          type: string
      - description: Start date (inclusive)
        in: query
        name: start
        schema:
          type: string
      - description: End date (inclusive)
        in: query
        name: end
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/analyticsv1.RetentionAnalytics'
          description: OK
      security:
      - Bearer: []
      summary: Retention analytics
      tags:
      - Analytics
  /analytics/v1/top/feeds:
    get:
      description: Returns the top feeds over a date range
      parameters:
      - description: Maximum number of results
        in: query
        name: limit
        schema:
          type: string
      - description: Start date (inclusive)
        in: query
        name: start
        schema:
          type: string
      - description: End date (inclusive)
        in: query
        name: end
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/analyticsv1.TopFeedsResponse'
          description: OK
      security:
      - Bearer: []
      summary: Get top feeds
      tags:
      - Analytics
  /analytics/v1/top/posts:
    get:
      description: Returns the top posts over a date range
      parameters:
      - description: Maximum number of results
        in: query
        name: limit
        schema:
          type: string
      - description: Filter by feed
        in: query
        name: feed_id
        schema:
          type: string
      - description: Start date (inclusive)
        in: query
        name: start
        schema:
          type: string
      - description: End date (inclusive)
        in: query
        name: end
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/analyticsv1.TopPostsResponse'
          description: OK
      security:
      - Bearer: []
      summary: Get top posts
      tags:
      - Analytics
  /analytics/v1/top/videos:
    get:
      description: Returns the top videos over a date range
      parameters:
      - description: Maximum number of results
        in: query
        name: limit
        schema:
          type: string
      - description: Start date (inclusive)
        in: query
        name: start
        schema:
          type: string
      - description: End date (inclusive)
        in: query
        name: end
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/analyticsv1.TopVideosResponse'
          description: OK
      security:
      - Bearer: []
      summary: Get top videos
      tags:
      - Analytics
  /analytics/v1/videos/{videoId}/heatmap:
    get:
      description: Returns the engagement heatmap for a video
      parameters:
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      - description: Number of buckets
        in: query
        name: buckets
        schema:
          type: string
      - description: Start date (inclusive)
        in: query
        name: start
        schema:
          type: string
      - description: End date (inclusive)
        in: query
        name: end
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/analyticsv1.VideoHeatmap'
          description: OK
      security:
      - Bearer: []
      summary: Get video heatmap
      tags:
      - Analytics
  /analytics/v1/videos/{videoId}/hot-segments:
    get:
      description: Returns the most engaging segments of a video
      parameters:
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      - description: Start date (inclusive)
        in: query
        name: start
        schema:
          type: string
      - description: End date (inclusive)
        in: query
        name: end
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/analyticsv1.HotSegmentsResponse'
          description: OK
      security:
      - Bearer: []
      summary: Get hot segments
      tags:
      - Analytics
  /analytics/v1/videos/{videoId}/stats:
    get:
      description: Returns aggregated statistics for a video over a date range
      parameters:
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      - description: Start date (inclusive)
        in: query
        name: start
        schema:
          type: string
      - description: End date (inclusive)
        in: query
        name: end
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/analyticsv1.VideoStats'
          description: OK
      security:
      - Bearer: []
      summary: Get video statistics
      tags:
      - Analytics
  /auth/v1/blog/subscribe:
    post:
      description: Subscribes the authenticated user to the blog newsletter.
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Subscribe to the blog
      tags:
      - Auth / Blog
  /auth/v1/blog/subscription:
    get:
      description: Returns whether the authenticated user is subscribed to the blog
        newsletter.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.BlogSubscriptionResponse'
          description: OK
      security:
      - Bearer: []
      summary: Get blog subscription status
      tags:
      - Auth / Blog
  /auth/v1/blog/unsubscribe:
    post:
      description: Unsubscribes the authenticated user from the blog newsletter.
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Unsubscribe from the blog
      tags:
      - Auth / Blog
  /auth/v1/blog/unsubscribe/email:
    post:
      description: Unsubscribes a recipient using the user id and email from an email-footer
        link. No authentication required.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.unsubscribeBlogByEmailBody'
              description: Unsubscribe request
              summary: request
        description: Unsubscribe request
        required: true
      responses:
        "204":
          description: No Content
      summary: Unsubscribe from the blog by email
      tags:
      - Auth / Blog
  /auth/v1/email/verify:
    post:
      description: Verifies a user's email address using a verification id and the
        code sent to them.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.verifyEmailBody'
              description: Verification id and code
              summary: request
        description: Verification id and code
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.VerifyEmailResponse'
          description: OK
      summary: Verify email with a code
      tags:
      - Auth / Email
  /auth/v1/email/verify/resend:
    post:
      description: Resends the email verification message to the given email address.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.emailBody'
              description: Email address
              summary: request
        description: Email address
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.ResendVerificationResponse'
          description: OK
      summary: Resend email verification
      tags:
      - Auth / Email
  /auth/v1/invitations/{token}/accept:
    post:
      description: Accepts the organization invitation identified by the provided
        token.
      parameters:
      - description: Invitation token
        in: path
        name: token
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.AcceptInvitationResponse'
          description: OK
      summary: Accept an organization invitation
      tags:
      - Auth / Memberships
  /auth/v1/invitations/{token}/decline:
    post:
      description: Declines the organization invitation identified by the provided
        token.
      parameters:
      - description: Invitation token
        in: path
        name: token
        required: true
        schema:
          type: string
      responses:
        "204":
          description: No Content
      summary: Decline an organization invitation
      tags:
      - Auth / Memberships
  /auth/v1/login:
    post:
      description: Authenticates a user by email and password and issues access and
        refresh tokens.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.registerOrLoginBody'
              description: Credentials
              summary: request
        description: Credentials
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.LoginResponse'
          description: OK
      summary: Log in with email and password
      tags:
      - Auth / Authentication
  /auth/v1/logout:
    post:
      description: Revokes the current access token so it can no longer be used.
      parameters:
      - description: 'Access token as: Bearer <token>'
        in: header
        name: Authorization
        schema:
          type: string
      responses:
        "204":
          description: No Content
      summary: Log out (revoke the current access token)
      tags:
      - Auth / Authentication
  /auth/v1/memberships/{orgId}/active:
    put:
      description: Sets the specified membership as the authenticated user's currently
        active organization.
      parameters:
      - description: Membership/organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.MembershipMutation'
          description: OK
      security:
      - Bearer: []
      summary: Set the active membership
      tags:
      - Auth / Memberships
  /auth/v1/memberships/{orgId}/check:
    get:
      description: Checks whether the authenticated user is a member of the specified
        organization and returns their membership status.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.CheckMembershipResponse'
          description: OK
      security:
      - Bearer: []
      summary: Check the current user's membership in an organization
      tags:
      - Auth / Memberships
  /auth/v1/memberships/{orgId}/domain:
    delete:
      description: Removes the custom domain from the organization and clears its
        verification.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Remove a custom domain
      tags:
      - Auth / Custom Domains
    get:
      description: Returns the current custom domain and its verification status for
        the organization.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.DomainResponse'
          description: OK
      security:
      - Bearer: []
      summary: Get custom domain status
      tags:
      - Auth / Custom Domains
    post:
      description: Registers a custom domain for the organization and issues verification
        details to prove ownership.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.createDomainBody'
              description: Domain
              summary: request
        description: Domain
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.DomainResponse'
          description: Created
      security:
      - Bearer: []
      summary: Create a custom domain verification
      tags:
      - Auth / Custom Domains
  /auth/v1/memberships/{orgId}/domain/auto-join:
    get:
      description: Returns whether users with a matching verified domain email are
        automatically added to the organization.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.AutoJoinSetting'
          description: OK
      security:
      - Bearer: []
      summary: Get domain auto-join setting
      tags:
      - Auth / Custom Domains
    put:
      description: Enables or disables automatically adding users with a matching
        verified domain email to the organization.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.autoJoinBody'
              description: Auto-join enabled
              summary: request
        description: Auto-join enabled
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.AutoJoinSetting'
          description: OK
      security:
      - Bearer: []
      summary: Set domain auto-join setting
      tags:
      - Auth / Custom Domains
  /auth/v1/memberships/{orgId}/domain/verification:
    post:
      description: Verifies the organization's pending custom domain and returns its
        updated verification status.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.DomainResponse'
          description: OK
      security:
      - Bearer: []
      summary: Check a custom domain verification
      tags:
      - Auth / Custom Domains
  /auth/v1/memberships/{orgId}/info:
    get:
      description: Returns the authenticated user's membership info (email) for an
        organization, with permission-denied when not a member.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.GetInternalMembershipInfoResponse'
          description: OK
      security:
      - Bearer: []
      summary: Get the caller's membership info in an organization
      tags:
      - Auth / Memberships
  /auth/v1/memberships/{orgId}/leave:
    delete:
      description: Removes the authenticated user's own membership from the organization.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.StatusResponse'
          description: OK
      security:
      - Bearer: []
      summary: Leave an organization
      tags:
      - Auth / Memberships
  /auth/v1/memberships/{orgId}/members:
    get:
      description: Returns a paginated list of the members belonging to the specified
        organization.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Limit
        in: query
        name: limit
        schema:
          type: integer
      - description: Offset
        in: query
        name: offset
        schema:
          type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.ListOrgMembersResponse'
          description: OK
      security:
      - Bearer: []
      summary: List members of an organization
      tags:
      - Auth / Memberships
  /auth/v1/memberships/{orgId}/members/{userId}:
    delete:
      description: Removes the specified member from the organization.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Member user ID
        in: path
        name: userId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.StatusResponse'
          description: OK
      security:
      - Bearer: []
      summary: Remove a member from an organization
      tags:
      - Auth / Memberships
  /auth/v1/memberships/{orgId}/members/{userId}/policies:
    get:
      description: Returns all authorization policies attached to the specified organization
        member.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Member user ID
        in: path
        name: userId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.MemberPoliciesResponse'
          description: OK
      security:
      - Bearer: []
      summary: List a member's policies
      tags:
      - Auth / Policies
  /auth/v1/memberships/{orgId}/members/{userId}/role:
    put:
      description: Updates the specified member's role within the organization.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Member user ID
        in: path
        name: userId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.updateRoleBody'
              description: Role
              summary: request
        description: Role
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.MembershipMutation'
          description: OK
      security:
      - Bearer: []
      summary: Update a member's role
      tags:
      - Auth / Memberships
  /auth/v1/memberships/{orgId}/members/invite:
    post:
      description: Invites the user with the given username to the organization with
        the specified role.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.inviteMemberBody'
              description: Invitation
              summary: request
        description: Invitation
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.MembershipMutation'
          description: Created
      security:
      - Bearer: []
      summary: Invite a member to an organization
      tags:
      - Auth / Memberships
  /auth/v1/memberships/{orgId}/members/invite/resend:
    post:
      description: Resends the pending organization invitation to the specified member.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.resendInviteBody'
              description: Member to resend to
              summary: request
        description: Member to resend to
        required: true
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Resend an invitation
      tags:
      - Auth / Memberships
  /auth/v1/memberships/{orgId}/membership/state:
    put:
      description: Accepts or declines the authenticated user's pending invitation
        to the organization. Used from inside the dashboard; the public token flow
        is /auth/v1/invitations/{token}/accept|decline.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.membershipStateBody'
              description: New membership state
              summary: request
        description: New membership state
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.MembershipMutation'
          description: OK
      security:
      - Bearer: []
      summary: Accept or decline a pending membership
      tags:
      - Auth / Memberships
  /auth/v1/memberships/{orgId}/name:
    put:
      description: Updates the display name of the specified organization.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.updateOrgNameBody'
              description: New name
              summary: request
        description: New name
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.UpdateOrgNameResponse'
          description: OK
      security:
      - Bearer: []
      summary: Update an organization's name
      tags:
      - Auth / Memberships
  /auth/v1/memberships/{orgId}/policies:
    get:
      description: Returns all authorization policies defined in the organization.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.ListPoliciesResponse'
          description: OK
      security:
      - Bearer: []
      summary: List policies
      tags:
      - Auth / Policies
    post:
      description: Creates a new authorization policy in the organization with the
        given name, description, and permissions.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.policyBody'
              description: Policy
              summary: request
        description: Policy
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.Policy'
          description: Created
      security:
      - Bearer: []
      summary: Create a policy
      tags:
      - Auth / Policies
  /auth/v1/memberships/{orgId}/policies/{policyId}:
    delete:
      description: Deletes an authorization policy from the organization by its ID.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Policy ID
        in: path
        name: policyId
        required: true
        schema:
          type: string
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Delete a policy
      tags:
      - Auth / Policies
    get:
      description: Returns the details of a single authorization policy in the organization
        by its ID.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Policy ID
        in: path
        name: policyId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.Policy'
          description: OK
      security:
      - Bearer: []
      summary: Get a policy
      tags:
      - Auth / Policies
    put:
      description: Updates an existing authorization policy's name, description, and
        permissions.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Policy ID
        in: path
        name: policyId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.policyBody'
              description: Policy
              summary: request
        description: Policy
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.Policy'
          description: OK
      security:
      - Bearer: []
      summary: Update a policy
      tags:
      - Auth / Policies
  /auth/v1/memberships/{orgId}/policies/{policyId}/attachments:
    get:
      description: Returns all identities that the given policy is attached to within
        the organization.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Policy ID
        in: path
        name: policyId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.ListAttachmentsResponse'
          description: OK
      security:
      - Bearer: []
      summary: List policy attachments
      tags:
      - Auth / Policies
    post:
      description: Attaches the given policy to an identity so the policy's permissions
        apply to that identity.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Policy ID
        in: path
        name: policyId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.attachPolicyBody'
              description: Identity
              summary: request
        description: Identity
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.PolicyAttachment'
          description: Created
      security:
      - Bearer: []
      summary: Attach a policy to an identity
      tags:
      - Auth / Policies
  /auth/v1/memberships/{orgId}/policies/{policyId}/attachments/{attachmentId}:
    delete:
      description: Detaches a policy from an identity by removing the specified attachment.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Policy ID
        in: path
        name: policyId
        required: true
        schema:
          type: string
      - description: Attachment ID
        in: path
        name: attachmentId
        required: true
        schema:
          type: string
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Detach a policy
      tags:
      - Auth / Policies
  /auth/v1/memberships/{orgId}/username:
    put:
      description: Updates the unique username handle of the specified organization.
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.updateOrgUsernameBody'
              description: New username
              summary: request
        description: New username
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.UpdateOrgUsernameResponse'
          description: OK
      security:
      - Bearer: []
      summary: Update an organization's username
      tags:
      - Auth / Memberships
  /auth/v1/memberships/active:
    get:
      description: Returns a paginated list of the organizations in which the authenticated
        user holds an active membership.
      parameters:
      - description: Limit
        in: query
        name: limit
        schema:
          type: integer
      - description: Offset
        in: query
        name: offset
        schema:
          type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.ListMembershipsResponse'
          description: OK
      security:
      - Bearer: []
      summary: List the current user's active memberships
      tags:
      - Auth / Memberships
  /auth/v1/memberships/pending:
    get:
      description: Returns a paginated list of the authenticated user's pending organization
        membership invitations that have not yet been accepted.
      parameters:
      - description: Limit
        in: query
        name: limit
        schema:
          type: integer
      - description: Offset
        in: query
        name: offset
        schema:
          type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.ListMembershipsResponse'
          description: OK
      security:
      - Bearer: []
      summary: List the current user's pending memberships
      tags:
      - Auth / Memberships
  /auth/v1/passkey/login/begin:
    post:
      description: Begins a passkey login by returning a session_id and WebAuthn challenge
        options for the client to sign.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.PasskeyBeginResponse'
          description: session_id and WebAuthn options
      summary: Begin passkey login
      tags:
      - Auth / Passkeys
  /auth/v1/passkey/login/finish:
    post:
      description: Completes a passkey login by verifying the signed WebAuthn credential
        against the session and returning authentication tokens.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.passkeyLoginFinishBody'
              description: session_id and WebAuthn credential
              summary: request
        description: session_id and WebAuthn credential
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.TokenResponse'
          description: OK
      summary: Finish passkey login
      tags:
      - Auth / Passkeys
  /auth/v1/password/reset:
    post:
      description: Sends a password reset email containing a reset token to the given
        email address.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.emailBody'
              description: Email address
              summary: request
        description: Email address
        required: true
      responses:
        "204":
          description: No Content
      summary: Send a password reset email
      tags:
      - Auth / Authentication
  /auth/v1/password/reset/confirm:
    post:
      description: Resets the user's password using a valid reset token and the supplied
        new password.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.resetPasswordBody'
              description: Reset token and new password
              summary: request
        description: Reset token and new password
        required: true
      responses:
        "204":
          description: No Content
      summary: Reset password with a token
      tags:
      - Auth / Authentication
  /auth/v1/policies/permissions:
    get:
      description: Returns the registered permission names and their bit offsets.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.PermissionRegistryResponse'
          description: OK
      security:
      - Bearer: []
      summary: List the permission registry
      tags:
      - Auth / Policies
  /auth/v1/providers:
    get:
      description: Returns the list of social providers connected to the authenticated
        user's account.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.ListProvidersResponse'
          description: OK
      security:
      - Bearer: []
      summary: List connected social providers
      tags:
      - Auth / User
  /auth/v1/providers/{provider}:
    delete:
      description: Disconnects the named social provider from the authenticated user's
        account.
      parameters:
      - description: Provider name
        in: path
        name: provider
        required: true
        schema:
          type: string
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Disconnect a social provider
      tags:
      - Auth / User
  /auth/v1/providers/connect:
    post:
      description: Connects a social provider to the authenticated user's account
        using the supplied provider token.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.connectProviderBody'
              description: Provider token
              summary: request
        description: Provider token
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.TokenResponse'
          description: OK
      security:
      - Bearer: []
      summary: Connect a social provider
      tags:
      - Auth / User
  /auth/v1/register:
    post:
      description: Registers a new user account from an email and password and starts
        email verification.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.registerBody'
              description: Credentials
              summary: request
        description: Credentials
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.RegisterResponse'
          description: Created
      summary: Register with email and password
      tags:
      - Auth / Authentication
  /auth/v1/token:
    post:
      description: Exchanges a valid refresh token for a new access token.
      parameters:
      - description: 'Refresh token as: <type> <token>'
        in: header
        name: Authorization
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.TokenResponse'
          description: OK
      summary: Refresh access token
      tags:
      - Auth / Authentication
  /auth/v1/userinfo:
    get:
      description: Returns the profile information of the authenticated user.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.UserInfo'
          description: OK
      security:
      - Bearer: []
      summary: Get current user info
      tags:
      - Auth / User
  /auth/v1/users/current:
    get:
      description: Returns the profile information of the authenticated user.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.UserInfo'
          description: OK
      security:
      - Bearer: []
      summary: Get current user info
      tags:
      - Auth / User
  /auth/v1/users/current/emails:
    post:
      description: |-
        Adds an email address to the authenticated account and sends a verification
        code to it. The address becomes active only once it has been verified via
        `POST /auth/v1/email/verify`. Subject to rate limiting per account.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.addEmailBody'
              description: Email address to add
              summary: request
        description: Email address to add
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.VerificationSentResponse'
          description: Verification code sent to the new address
      security:
      - Bearer: []
      summary: Add an email address
      tags:
      - Auth / Email
  /auth/v1/users/current/emails/change:
    put:
      description: |-
        Starts changing the authenticated account's email address. A verification
        code is sent to the new address; the change is applied only after the code
        is confirmed via `POST /auth/v1/email/verify`. Subject to rate limiting per account.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.changeEmailBody'
              description: New email address
              summary: request
        description: New email address
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.VerificationSentResponse'
          description: Verification code sent to the new address
      security:
      - Bearer: []
      summary: Change the account email
      tags:
      - Auth / Email
  /auth/v1/users/current/emails/status:
    get:
      description: |-
        Returns the authenticated account's current email address together with
        whether an email is set and whether it has been verified.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.EmailStatusResponse'
          description: Current email and verification status
      security:
      - Bearer: []
      summary: Get email status
      tags:
      - Auth / Email
  /auth/v1/users/current/name:
    patch:
      description: Updates the authenticated user's full name to the provided value.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.updateNameBody'
              description: New name
              summary: request
        description: New name
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.UpdateNameResponse'
          description: OK
      security:
      - Bearer: []
      summary: Update the current user's name
      tags:
      - Auth / User
  /auth/v1/users/current/passkeys:
    get:
      description: Returns all passkeys registered to the authenticated user.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.ListPasskeysResponse'
          description: OK
      security:
      - Bearer: []
      summary: List the current user's passkeys
      tags:
      - Auth / Passkeys
  /auth/v1/users/current/passkeys/{id}:
    delete:
      description: Deletes the authenticated user's passkey identified by the path
        ID.
      parameters:
      - description: Passkey ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Delete a passkey
      tags:
      - Auth / Passkeys
    patch:
      description: Renames the authenticated user's passkey identified by the path
        ID to the supplied name.
      parameters:
      - description: Passkey ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.renamePasskeyBody'
              description: New name
              summary: request
        description: New name
        required: true
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Rename a passkey
      tags:
      - Auth / Passkeys
  /auth/v1/users/current/passkeys/register/begin:
    post:
      description: Begins registering a new passkey for the authenticated user by
        returning a session_id and WebAuthn creation options.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.PasskeyBeginResponse'
          description: session_id and WebAuthn options
      security:
      - Bearer: []
      summary: Begin passkey registration
      tags:
      - Auth / Passkeys
  /auth/v1/users/current/passkeys/register/finish:
    post:
      description: Completes passkey registration by verifying the signed WebAuthn
        credential and storing it under the given name for the authenticated user.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.passkeyRegisterFinishBody'
              description: session_id, name and WebAuthn credential
              summary: request
        description: session_id, name and WebAuthn credential
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.PasskeyRegisterFinishResponse'
          description: Created
      security:
      - Bearer: []
      summary: Finish passkey registration
      tags:
      - Auth / Passkeys
  /auth/v1/users/current/totp/delete:
    delete:
      description: Disables TOTP two-factor authentication for the authenticated user
        and removes their stored TOTP secret.
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Disable TOTP
      tags:
      - Auth / TOTP
  /auth/v1/users/current/totp/setup:
    post:
      description: Begins TOTP setup for the authenticated user by generating and
        returning a provisioning secret and QR code that have not yet been enabled.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.SetupOTPResponse'
          description: OK
      security:
      - Bearer: []
      summary: Begin TOTP setup
      tags:
      - Auth / TOTP
  /auth/v1/users/current/totp/status:
    get:
      description: Returns whether the authenticated user currently has TOTP two-factor
        authentication enabled.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.OTPStatusResponse'
          description: OK
      security:
      - Bearer: []
      summary: Get TOTP status
      tags:
      - Auth / TOTP
  /auth/v1/users/current/totp/verify:
    post:
      description: Verifies the submitted TOTP code against the user's pending setup
        secret and, if valid, enables TOTP two-factor authentication and returns refreshed
        tokens.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.verifyOTPBody'
              description: TOTP code
              summary: request
        description: TOTP code
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.TokenResponse'
          description: OK
      security:
      - Bearer: []
      summary: Verify and enable TOTP
      tags:
      - Auth / TOTP
  /auth/v1/users/current/username:
    patch:
      description: Updates the authenticated user's username to the provided value.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.updateUsernameBody'
              description: New username
              summary: request
        description: New username
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.UpdateUsernameResponse'
          description: OK
      security:
      - Bearer: []
      summary: Update the current user's username
      tags:
      - Auth / User
  /auth/v1/verify-passkey:
    post:
      description: Completes the passkey step of a password login's 2FA challenge.
        Verifies the signed WebAuthn assertion against the challenge stored in the
        login session (from POST /auth/v1/login with status "2fa_required") and returns
        authentication tokens.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.passkeyVerifyBody'
              description: session_id and WebAuthn credential
              summary: request
        description: session_id and WebAuthn credential
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.TokenResponse'
          description: OK
      summary: Verify passkey as 2FA after password login
      tags:
      - Auth / Passkeys
  /auth/v1/verify-totp:
    post:
      description: Verifies the submitted TOTP code for a pending login session and,
        if valid, completes authentication and returns access tokens.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.verifyTOTPLoginBody'
              description: TOTP code and login session id
              summary: request
        description: TOTP code and login session id
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authv1.TokenResponse'
          description: OK
      summary: Verify TOTP during login
      tags:
      - Auth / TOTP
  /billing/v1/address:
    get:
      description: Returns the organization's billing address
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.BillingAddress'
          description: OK
      security:
      - Bearer: []
      summary: Get billing address
      tags:
      - Billing / Payments
    post:
      description: Create or update the organization's billing address
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.billingAddressBody'
              description: Billing address
              summary: request
        description: Billing address
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.BillingAddress'
          description: OK
      security:
      - Bearer: []
      summary: Set billing address
      tags:
      - Billing / Payments
  /billing/v1/bandwidth-usage:
    get:
      description: Returns the organization's bandwidth usage.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.BandwidthUsage'
          description: OK
      security:
      - Bearer: []
      summary: Get bandwidth usage
      tags:
      - Billing / Usage
  /billing/v1/bandwidth-usage/history:
    get:
      description: Returns the organization's bandwidth usage history
      parameters:
      - description: Number of days of history
        in: query
        name: days
        schema:
          type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.GetBandwidthUsageHistoryResponse'
          description: OK
      security:
      - Bearer: []
      summary: Bandwidth usage history
      tags:
      - Billing / Usage
  /billing/v1/bandwidth-usage/refresh:
    post:
      description: Recalculate and persist the organization's bandwidth usage
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.BandwidthUsage'
          description: OK
      security:
      - Bearer: []
      summary: Refresh bandwidth usage
      tags:
      - Billing / Usage
  /billing/v1/checkout:
    post:
      description: Create a Stripe hosted checkout session
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.checkoutBody'
              description: Checkout request
              summary: request
        description: Checkout request
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.HostedCheckoutSessionResponse'
          description: OK
      security:
      - Bearer: []
      summary: Create checkout session
      tags:
      - Billing / Payments
  /billing/v1/contact-sales:
    post:
      description: Submits a sales contact request for the organization.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.contactSalesBody'
              description: Contact sales request
              summary: request
        description: Contact sales request
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.SalesLead'
          description: Created
      security:
      - Bearer: []
      summary: Contact sales
      tags:
      - Billing / Subscriptions
  /billing/v1/invoices:
    get:
      description: Returns the organization's invoices.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.ListInvoicesResponse'
          description: OK
      security:
      - Bearer: []
      summary: List invoices
      tags:
      - Billing / Invoices
  /billing/v1/invoices/{invoiceId}/status:
    put:
      description: Updates the status of an invoice (admin).
      parameters:
      - description: Invoice ID
        in: path
        name: invoiceId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.updateInvoiceStatusBody'
              description: New status
              summary: request
        description: New status
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.Invoice'
          description: OK
      security:
      - Bearer: []
      summary: Update invoice status
      tags:
      - Billing / Invoices
  /billing/v1/jobs/cleanup-bandwidth-snapshots:
    post:
      description: Trigger the cleanup of old bandwidth usage records
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Cleanup old bandwidth snapshots
      tags:
      - Billing / Usage
  /billing/v1/jobs/daily-bandwidth-calculation:
    post:
      description: Trigger the daily bandwidth usage calculation job for all organizations
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Run daily bandwidth calculation
      tags:
      - Billing / Usage
  /billing/v1/jobs/monthly-bandwidth-calculation:
    post:
      description: Trigger the monthly bandwidth usage calculation job for all organizations
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Run monthly bandwidth calculation
      tags:
      - Billing / Usage
  /billing/v1/payment-methods:
    get:
      description: Returns the organization's payment methods.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.ListPaymentMethodsResponse'
          description: OK
      security:
      - Bearer: []
      summary: List payment methods
      tags:
      - Billing / Payments
    post:
      description: Attach a payment method to the organization
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.upsertPaymentMethodBody'
              description: Payment method request
              summary: request
        description: Payment method request
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.PaymentMethodDetails'
          description: OK
      security:
      - Bearer: []
      summary: Add or update payment method
      tags:
      - Billing / Payments
  /billing/v1/payment-methods/{paymentMethodId}:
    delete:
      description: Remove a payment method from the organization
      parameters:
      - description: Payment method ID
        in: path
        name: paymentMethodId
        required: true
        schema:
          type: string
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Delete payment method
      tags:
      - Billing / Payments
  /billing/v1/payment-methods/from-payment-intent:
    get:
      description: Returns the payment method ID associated with a payment intent
      parameters:
      - description: Payment intent ID
        in: query
        name: payment_intent_id
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.PaymentMethodIdResponse'
          description: OK
      security:
      - Bearer: []
      summary: Resolve payment method from payment intent
      tags:
      - Billing / Payments
  /billing/v1/payment-methods/from-setup-intent:
    get:
      description: Returns the payment method ID associated with a setup intent
      parameters:
      - description: Setup intent ID
        in: query
        name: setup_intent_id
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.PaymentMethodIdResponse'
          description: OK
      security:
      - Bearer: []
      summary: Resolve payment method from setup intent
      tags:
      - Billing / Payments
  /billing/v1/plans:
    get:
      description: Returns the available billing plans.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.ListPlansResponse'
          description: OK
      summary: List billing plans
      tags:
      - Billing / Plans
  /billing/v1/plans/{planId}:
    get:
      description: Returns a single billing plan by ID.
      parameters:
      - description: Plan ID
        in: path
        name: planId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.GetPlanResponse'
          description: OK
      summary: Get a billing plan
      tags:
      - Billing / Plans
  /billing/v1/setup-intent:
    post:
      description: Create a Stripe setup intent for adding a payment method
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.SetupIntentResponse'
          description: OK
      security:
      - Bearer: []
      summary: Create setup intent
      tags:
      - Billing / Payments
  /billing/v1/storage-usage:
    get:
      description: Returns the organization's storage usage.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.StorageUsage'
          description: OK
      security:
      - Bearer: []
      summary: Get storage usage
      tags:
      - Billing / Usage
  /billing/v1/storage-usage/history:
    get:
      description: Returns the organization's storage usage history
      parameters:
      - description: Number of days of history
        in: query
        name: days
        schema:
          type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.GetStorageUsageHistoryResponse'
          description: OK
      security:
      - Bearer: []
      summary: Storage usage history
      tags:
      - Billing / Usage
  /billing/v1/storage-usage/refresh:
    post:
      description: Recalculate and persist the organization's storage usage
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.StorageUsage'
          description: OK
      security:
      - Bearer: []
      summary: Refresh storage usage
      tags:
      - Billing / Usage
  /billing/v1/subscription:
    get:
      description: Returns the current organization subscription.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.Subscription'
          description: OK
      security:
      - Bearer: []
      summary: Get current subscription
      tags:
      - Billing / Subscriptions
    post:
      description: Create a subscription for the authenticated organization
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.createSubscriptionBody'
              description: Subscription request
              summary: request
        description: Subscription request
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.CreateSubscriptionResponse'
          description: OK
      security:
      - Bearer: []
      summary: Create subscription
      tags:
      - Billing / Subscriptions
  /billing/v1/subscription/cancel:
    put:
      description: Cancel the organization's subscription at the end of the current
        period
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Cancel subscription
      tags:
      - Billing / Subscriptions
  /billing/v1/subscription/history:
    get:
      description: Returns the organization's subscription history.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.GetSubscriptionHistoryResponse'
          description: OK
      security:
      - Bearer: []
      summary: Get subscription history
      tags:
      - Billing / Subscriptions
  /billing/v1/subscription/reactivate:
    put:
      description: Reactivate a subscription scheduled for cancellation
      responses:
        "204":
          description: No Content
      security:
      - Bearer: []
      summary: Reactivate subscription
      tags:
      - Billing / Subscriptions
  /billing/v1/subscription/upgrade:
    post:
      description: Upgrade the organization's subscription to a new plan
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.upgradeSubscriptionBody'
              description: Upgrade request
              summary: request
        description: Upgrade request
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.UpgradeSubscriptionResponse'
          description: OK
      security:
      - Bearer: []
      summary: Upgrade subscription
      tags:
      - Billing / Subscriptions
  /billing/v1/tax/calculate:
    post:
      description: Calculate tax for a plan purchase
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.calculateTaxBody'
              description: Tax calculation request
              summary: request
        description: Tax calculation request
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingv1.PlanTaxCalculationResponse'
          description: OK
      security:
      - Bearer: []
      summary: Calculate tax
      tags:
      - Billing / Payments
  /billing/webhooks/stripe:
    post:
      description: Receives Stripe webhook events. The raw payload and signature are
        forwarded to the billing service for verification and processing.
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        "204":
          description: No Content
      summary: Stripe webhook
      tags:
      - Billing / Webhooks
  /media/v1/images/{imageId}:
    get:
      description: Returns a single image by ID.
      parameters:
      - description: Image ID
        in: path
        name: imageId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/imagesv1.GetImageResponse'
          description: OK
      summary: Get an image
      tags:
      - Media / Images
  /media/v1/languages:
    get:
      description: Returns the language codes supported for audio tracks and subtitles.
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.ListLanguagesResponse'
          description: OK
      summary: List supported languages
      tags:
      - Media / Languages
  /media/v1/projects/{projectId}/images:
    get:
      description: Returns the images in a project.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/imagesv1.ListImagesResponse'
          description: OK
      security:
      - Bearer: []
      summary: List images
      tags:
      - Media / Images
  /media/v1/projects/{projectId}/images/{imageId}:
    delete:
      description: Deletes an image from a project.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Image ID
        in: path
        name: imageId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/imagesv1.DeleteResult'
          description: OK
      security:
      - Bearer: []
      summary: Delete an image
      tags:
      - Media / Images
    get:
      description: Returns a single image within a project, including private media.
        Requires project access.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Image ID
        in: path
        name: imageId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/imagesv1.GetImageResponse'
          description: OK
      security:
      - Bearer: []
      summary: Get an image (project-scoped)
      tags:
      - Media / Images
  /media/v1/projects/{projectId}/images/{imageId}/upload/complete:
    post:
      description: Finalizes a previously initiated image upload.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Image ID
        in: path
        name: imageId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/imagesv1.GetImageResponse'
          description: OK
      security:
      - Bearer: []
      summary: Complete an image upload
      tags:
      - Media / Images
  /media/v1/projects/{projectId}/images/{imageId}/visibility:
    put:
      description: Updates an image's visibility (public, unlisted, or private). Requires
        project access.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Image ID
        in: path
        name: imageId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.updateVisibilityBody'
              description: Visibility
              summary: request
        description: Visibility
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/imagesv1.GetImageResponse'
          description: OK
      security:
      - Bearer: []
      summary: Set an image's visibility
      tags:
      - Media / Images
  /media/v1/projects/{projectId}/images/upload:
    post:
      description: Initiates an image upload and returns upload details.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.createImageUploadBody'
              description: Image upload details
              summary: request
        description: Image upload details
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/imagesv1.ImageUploadInit'
          description: Created
      security:
      - Bearer: []
      summary: Create an image upload
      tags:
      - Media / Images
  /media/v1/projects/{projectId}/videos:
    get:
      description: Returns the videos belonging to a project.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.ListVideosResponse'
          description: OK
      security:
      - Bearer: []
      summary: List videos in a project
      tags:
      - Media / Videos
  /media/v1/projects/{projectId}/videos/{videoId}:
    delete:
      description: Deletes a video from a project.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.DeleteResult'
          description: OK
      security:
      - Bearer: []
      summary: Delete a video
      tags:
      - Media / Videos
    get:
      description: Returns a single video within a project, including private media.
        Requires project access.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.GetVideoResponse'
          description: OK
      security:
      - Bearer: []
      summary: Get a video (project-scoped)
      tags:
      - Media / Videos
  /media/v1/projects/{projectId}/videos/{videoId}/audio-tracks:
    delete:
      description: Deletes all audio tracks for a video.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.DeleteResult'
          description: OK
      security:
      - Bearer: []
      summary: Delete all audio tracks
      tags:
      - Media / Audio Tracks
    get:
      description: Returns a video's audio tracks within a project, including for
        private media. Requires project access.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.ListAudioTracksResponse'
          description: OK
      security:
      - Bearer: []
      summary: List audio tracks (project-scoped)
      tags:
      - Media / Audio Tracks
  /media/v1/projects/{projectId}/videos/{videoId}/audio-tracks/{trackId}:
    delete:
      description: Deletes a single audio track from a video.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      - description: Audio track ID
        in: path
        name: trackId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.DeleteResult'
          description: OK
      security:
      - Bearer: []
      summary: Delete an audio track
      tags:
      - Media / Audio Tracks
  /media/v1/projects/{projectId}/videos/{videoId}/audio-tracks/language/{lang}:
    delete:
      description: Deletes all audio tracks for a video in a given language.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      - description: Language code
        in: path
        name: lang
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.DeleteResult'
          description: OK
      security:
      - Bearer: []
      summary: Delete audio tracks by language
      tags:
      - Media / Audio Tracks
  /media/v1/projects/{projectId}/videos/{videoId}/audio-tracks/upload:
    post:
      description: Initiates one or more audio track uploads for a video.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.initTrackUploadBody'
              description: Audio tracks to upload
              summary: request
        description: Audio tracks to upload
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.TrackUploadInit'
          description: Created
      security:
      - Bearer: []
      summary: Initiate audio track uploads
      tags:
      - Media / Audio Tracks
  /media/v1/projects/{projectId}/videos/{videoId}/audio-tracks/upload/complete:
    post:
      description: Finalizes previously initiated audio track uploads.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.completeTrackUploadBody'
              description: Uploaded audio tracks
              summary: request
        description: Uploaded audio tracks
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.UploadAck'
          description: OK
      security:
      - Bearer: []
      summary: Complete audio track uploads
      tags:
      - Media / Audio Tracks
  /media/v1/projects/{projectId}/videos/{videoId}/chapters:
    delete:
      description: Removes every chapter from a video.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.VideoChapters'
          description: OK
      security:
      - Bearer: []
      summary: Delete all video chapters
      tags:
      - Media / Chapters
    get:
      description: Returns the chapters of a video.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.VideoChapters'
          description: OK
      security:
      - Bearer: []
      summary: Get video chapters
      tags:
      - Media / Chapters
    put:
      description: Replaces the chapters of a video.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.updateChaptersBody'
              description: Chapters to set
              summary: request
        description: Chapters to set
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.VideoChapters'
          description: OK
      security:
      - Bearer: []
      summary: Update video chapters
      tags:
      - Media / Chapters
  /media/v1/projects/{projectId}/videos/{videoId}/chapters/{startTimeSec}:
    delete:
      description: Removes one chapter identified by its start time (seconds).
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      - description: Chapter start time (seconds)
        in: path
        name: startTimeSec
        required: true
        schema:
          type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.VideoChapters'
          description: OK
      security:
      - Bearer: []
      summary: Delete a single video chapter
      tags:
      - Media / Chapters
  /media/v1/projects/{projectId}/videos/{videoId}/subtitles:
    delete:
      description: Deletes all subtitles for a video.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.DeleteResult'
          description: OK
      security:
      - Bearer: []
      summary: Delete all subtitles
      tags:
      - Media / Subtitles
    get:
      description: Returns a video's subtitles within a project, including for private
        media. Requires project access.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.ListSubtitlesResponse'
          description: OK
      security:
      - Bearer: []
      summary: List subtitles (project-scoped)
      tags:
      - Media / Subtitles
  /media/v1/projects/{projectId}/videos/{videoId}/subtitles/{subtitleId}:
    delete:
      description: Deletes a single subtitle from a video.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      - description: Subtitle ID
        in: path
        name: subtitleId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.DeleteResult'
          description: OK
      security:
      - Bearer: []
      summary: Delete a subtitle
      tags:
      - Media / Subtitles
  /media/v1/projects/{projectId}/videos/{videoId}/subtitles/language/{lang}:
    delete:
      description: Deletes all subtitles for a video in a given language.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      - description: Language code
        in: path
        name: lang
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.DeleteResult'
          description: OK
      security:
      - Bearer: []
      summary: Delete subtitles by language
      tags:
      - Media / Subtitles
  /media/v1/projects/{projectId}/videos/{videoId}/subtitles/upload:
    post:
      description: Initiates one or more subtitle uploads for a video.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.initTrackUploadBody'
              description: Subtitles to upload
              summary: request
        description: Subtitles to upload
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.TrackUploadInit'
          description: Created
      security:
      - Bearer: []
      summary: Initiate subtitle uploads
      tags:
      - Media / Subtitles
  /media/v1/projects/{projectId}/videos/{videoId}/subtitles/upload/complete:
    post:
      description: Finalizes previously initiated subtitle uploads.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.completeTrackUploadBody'
              description: Uploaded subtitles
              summary: request
        description: Uploaded subtitles
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.UploadAck'
          description: OK
      security:
      - Bearer: []
      summary: Complete subtitle uploads
      tags:
      - Media / Subtitles
  /media/v1/projects/{projectId}/videos/{videoId}/thumbnail:
    put:
      description: Replaces the thumbnail image for an existing video.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      requestBody:
        content:
          multipart/form-data:
            schema:
              properties:
                thumbnail:
                  description: Thumbnail image file
                  format: binary
                  type: string
              required:
              - thumbnail
              type: object
        description: Thumbnail image file
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.UploadVideoThumbnailResponse'
          description: OK
      security:
      - Bearer: []
      summary: Update video thumbnail
      tags:
      - Media / Videos
  /media/v1/projects/{projectId}/videos/{videoId}/upload/complete:
    post:
      description: Finalizes a previously initiated video upload.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.GetVideoResponse'
          description: OK
      security:
      - Bearer: []
      summary: Complete a video upload
      tags:
      - Media / Videos
  /media/v1/projects/{projectId}/videos/{videoId}/visibility:
    put:
      description: Updates a video's visibility (public, unlisted, or private). Requires
        project access.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.updateVisibilityBody'
              description: Visibility
              summary: request
        description: Visibility
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.GetVideoResponse'
          description: OK
      security:
      - Bearer: []
      summary: Set a video's visibility
      tags:
      - Media / Videos
  /media/v1/projects/{projectId}/videos/upload:
    post:
      description: Initiates a video upload and returns upload details.
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.createVideoUploadBody'
              description: Video upload details
              summary: request
        description: Video upload details
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.VideoUploadInit'
          description: Created
      security:
      - Bearer: []
      summary: Create a video upload
      tags:
      - Media / Videos
  /media/v1/videos/{videoId}:
    get:
      description: Returns a single video by ID.
      parameters:
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.GetVideoResponse'
          description: OK
      summary: Get a video
      tags:
      - Media / Videos
  /media/v1/videos/{videoId}/audio-tracks:
    get:
      description: Returns the audio tracks associated with a video.
      parameters:
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.ListAudioTracksResponse'
          description: OK
      summary: List audio tracks for a video
      tags:
      - Media / Audio Tracks
  /media/v1/videos/{videoId}/subtitles:
    get:
      description: Returns the subtitles associated with a video.
      parameters:
      - description: Video ID
        in: path
        name: videoId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/videosv1.ListSubtitlesResponse'
          description: OK
      summary: List subtitles for a video
      tags:
      - Media / Subtitles
  /organization/{orgId}/projects:
    get:
      description: Get all projects for a specific organization
      operationId: listProjectsByOrgid
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/projectsv1.ListProjectsResponse'
          description: OK
      security:
      - Bearer: []
      summary: List organization projects
      tags:
      - Projects
    post:
      description: Create a new project under the given organization with specified
        video quality
      operationId: createProjectsByOrgid
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/types.CreateProjectRequest'
              description: Project creation payload
              summary: request
        description: Project creation payload
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/projectsv1.Project'
          description: Created
      security:
      - Bearer: []
      summary: Create project
      tags:
      - Projects
  /organization/{orgId}/projects/{projectId}:
    delete:
      description: Soft delete a project (marks it as deleted)
      operationId: deleteProjects
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/projectsv1.Project'
          description: OK
      security:
      - Bearer: []
      summary: Delete project (soft)
      tags:
      - Projects
    get:
      description: Retrieve a specific project under an organization
      operationId: getProjects
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/projectsv1.Project'
          description: OK
      security:
      - Bearer: []
      summary: Get project
      tags:
      - Projects
  /organization/{orgId}/projects/{projectId}/custom-domain:
    delete:
      description: Remove the custom domain from a specific project
      operationId: deleteCustomDomainByProjectid
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/projectsv1.Project'
          description: OK
      security:
      - Bearer: []
      summary: Remove custom domain
      tags:
      - Projects
    put:
      description: Set or update a custom domain for a specific project
      operationId: updateCustomDomainByProjectid
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/types.CustomDomainRequest'
              description: Custom domain details
              summary: request
        description: Custom domain details
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/projectsv1.Project'
          description: OK
      security:
      - Bearer: []
      summary: Set or update custom domain
      tags:
      - Projects
  /organization/{orgId}/projects/{projectId}/move:
    post:
      description: Move a project from one organization to another (if user has access
        to both)
      operationId: createMoveByProjectid
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/types.MoveProjectRequest'
              description: Target organization ID
              summary: request
        description: Target organization ID
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/projectsv1.Project'
          description: OK
      security:
      - Bearer: []
      summary: Move project to another organization
      tags:
      - Projects
  /organization/{orgId}/projects/{projectId}/name:
    patch:
      description: Update the name of a specific project
      operationId: patchNameByProjectid
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/types.UpdateProjectNameRequest'
              description: New project name
              summary: request
        description: New project name
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/projectsv1.Project'
          description: OK
      security:
      - Bearer: []
      summary: Update project name
      tags:
      - Projects
  /organization/{orgId}/projects/{projectId}/video-quality:
    patch:
      description: Update the default video quality setting for a project
      operationId: patchVideoQualityByProjectid
      parameters:
      - description: Organization ID
        in: path
        name: orgId
        required: true
        schema:
          type: string
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/types.UpdateVideoQualityRequest'
              description: New video quality setting
              summary: request
        description: New video quality setting
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/projectsv1.Project'
          description: OK
      security:
      - Bearer: []
      summary: Update project video quality
      tags:
      - Projects
  /platform/api-keys:
    get:
      description: Get all API keys for a specific organization
      operationId: listApiKeysByOrgid
      parameters:
      - description: Pagination limit
        in: query
        name: limit
        schema:
          type: integer
      - description: Pagination offset
        in: query
        name: offset
        schema:
          type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apikeysv1.ListApiKeysResponse'
          description: OK
      security:
      - Bearer: []
      summary: List organization API keys
      tags:
      - Credentials / API Keys
    post:
      description: Create a new API key for a project in the authenticated organization
      operationId: createApiKeyByOrgid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/types.CreateAPIKeyRequest'
              description: API key creation request
              summary: request
        description: API key creation request
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apikeysv1.CreateApiKeyResponse'
          description: OK
      security:
      - Bearer: []
      summary: Create API key
      tags:
      - Credentials / API Keys
  /platform/api-keys/{keyId}:
    delete:
      description: Delete an API key owned by the authenticated organization
      operationId: deleteApiKeyByKeyid
      parameters:
      - description: API key ID
        in: path
        name: keyId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apikeysv1.DeleteApiKeyResponse'
          description: OK
      security:
      - Bearer: []
      summary: Delete API key
      tags:
      - Credentials / API Keys
  /platform/api-keys/{keyId}/rotate:
    post:
      description: Rotate an API key, returning a new secret
      operationId: rotateApiKeyByKeyid
      parameters:
      - description: API key ID
        in: path
        name: keyId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apikeysv1.RotateApiKeyResponse'
          description: OK
      security:
      - Bearer: []
      summary: Rotate API key
      tags:
      - Credentials / API Keys
  /platform/auth/refresh:
    post:
      description: Trades a refresh token for a fresh access/refresh pair.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/types.RefreshRequest'
              description: Refresh token request
              summary: request
        description: Refresh token request
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/types.TokenResponse'
          description: OK
      summary: Refresh a platform access token
      tags:
      - Platform Auth
  /platform/auth/token:
    post:
      description: Trades an API key (`<keyId>_<secret>`) for a short-lived platform
        access token plus a refresh token.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/types.ExchangeRequest'
              description: API key exchange request
              summary: request
        description: API key exchange request
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/types.TokenResponse'
          description: OK
      summary: Exchange an API key for a platform access token
      tags:
      - Platform Auth
  /platform/clientauth/credentials:
    get:
      description: List client credentials for the specified organization
      operationId: listCredentialsByOrgid
      parameters:
      - description: Pagination limit
        in: query
        name: limit
        schema:
          type: integer
      - description: Pagination offset
        in: query
        name: offset
        schema:
          type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/clientauthv1.ListClientCredentialsResponse'
          description: OK
      security:
      - Bearer: []
      summary: List client credentials
      tags:
      - Credentials / Client Credentials
    post:
      description: Create a new client credential for the authenticated organization
      operationId: createCredentialByOrgid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/types.CreateClientCredentialRequest'
              description: Client credential creation request
              summary: request
        description: Client credential creation request
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/clientauthv1.CreateClientCredentialResponse'
          description: OK
      security:
      - Bearer: []
      summary: Create client credential
      tags:
      - Credentials / Client Credentials
  /platform/clientauth/credentials/{credentialId}/revoke:
    post:
      description: Revoke a client credential owned by the authenticated organization
      operationId: revokeCredentialByCredentialid
      parameters:
      - description: Client credential ID
        in: path
        name: credentialId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/clientauthv1.RevokeClientCredentialResponse'
          description: OK
      security:
      - Bearer: []
      summary: Revoke client credential
      tags:
      - Credentials / Client Credentials
  /platform/clientauth/token:
    post:
      description: Exchange client_id/client_secret for a short-lived access token.
        The request subject is an opaque client-defined label and is not treated as
        authoritative user identity for authorization.
      operationId: createToken
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/types.MintClientTokenRequest'
              description: Mint client token request
              summary: request
        description: Mint client token request
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/clientauthv1.MintClientTokenResponse'
          description: OK
      summary: Mint client access token
      tags:
      - Credentials / Client Credentials
  /posts/v1/feeds/{feedId}:
    get:
      description: Public, unauthenticated listing of posts in a feed, with pagination.
      operationId: listPublicPosts
      parameters:
      - description: Feed ID
        in: path
        name: feedId
        required: true
        schema:
          type: string
      - description: Page size
        in: query
        name: limit
        schema:
          type: integer
      - description: Page offset
        in: query
        name: offset
        schema:
          type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/postsv1.ListPostsResponse'
          description: OK
      summary: List posts in a feed
      tags:
      - Posts
  /posts/v1/feeds/{feedId}/{postId}:
    get:
      description: Public, unauthenticated retrieval of a single post by ID.
      operationId: getPublicPost
      parameters:
      - description: Feed ID
        in: path
        name: feedId
        required: true
        schema:
          type: string
      - description: Post ID
        in: path
        name: postId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/postsv1.Post'
          description: OK
      summary: Get a post
      tags:
      - Posts
  /posts/v1/feeds/{feedId}/creators/{creatorId}:
    get:
      description: Public, unauthenticated listing of posts in a feed by a specific
        creator, with pagination.
      operationId: listPublicPostsByCreator
      parameters:
      - description: Feed ID
        in: path
        name: feedId
        required: true
        schema:
          type: string
      - description: Creator ID
        in: path
        name: creatorId
        required: true
        schema:
          type: string
      - description: Page size
        in: query
        name: limit
        schema:
          type: integer
      - description: Page offset
        in: query
        name: offset
        schema:
          type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/postsv1.ListPostsResponse'
          description: OK
      summary: List posts by creator
      tags:
      - Posts
  /posts/v1/projects/{projectId}/feeds/{feedId}/posts:
    get:
      description: List posts in a feed
      operationId: listPosts
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Feed ID
        in: path
        name: feedId
        required: true
        schema:
          type: string
      - description: Page size
        in: query
        name: limit
        schema:
          type: integer
      - description: Page offset
        in: query
        name: offset
        schema:
          type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/postsv1.ListPostsResponse'
          description: OK
      security:
      - Bearer: []
      summary: List posts
      tags:
      - Posts
    post:
      description: Create a new post in a feed
      operationId: createPost
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Feed ID
        in: path
        name: feedId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.createPostBody'
              description: Post to create
              summary: request
        description: Post to create
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/postsv1.Post'
          description: Created
      security:
      - Bearer: []
      summary: Create a post
      tags:
      - Posts
  /posts/v1/projects/{projectId}/feeds/{feedId}/posts/{postId}:
    delete:
      description: Delete a post by ID
      operationId: deletePost
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Feed ID
        in: path
        name: feedId
        required: true
        schema:
          type: string
      - description: Post ID
        in: path
        name: postId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/postsv1.DeleteResult'
          description: OK
      security:
      - Bearer: []
      summary: Delete a post
      tags:
      - Posts
    get:
      description: Get a single post by ID
      operationId: getPost
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Feed ID
        in: path
        name: feedId
        required: true
        schema:
          type: string
      - description: Post ID
        in: path
        name: postId
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/postsv1.Post'
          description: OK
      security:
      - Bearer: []
      summary: Get a post
      tags:
      - Posts
  /posts/v1/projects/{projectId}/feeds/{feedId}/posts/creators/{creatorId}:
    get:
      description: List posts in a feed authored by a specific creator
      operationId: listPostsByCreator
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Feed ID
        in: path
        name: feedId
        required: true
        schema:
          type: string
      - description: Creator ID
        in: path
        name: creatorId
        required: true
        schema:
          type: string
      - description: Page size
        in: query
        name: limit
        schema:
          type: integer
      - description: Page offset
        in: query
        name: offset
        schema:
          type: integer
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/postsv1.ListPostsResponse'
          description: OK
      security:
      - Bearer: []
      summary: List posts by creator
      tags:
      - Posts
  /posts/v1/projects/{projectId}/feeds/{feedId}/posts/upload/complete:
    post:
      description: Finalize a media upload and publish the post
      operationId: completePostUpload
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Feed ID
        in: path
        name: feedId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.completeUploadBody'
              description: Upload completion request
              summary: request
        description: Upload completion request
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/postsv1.Post'
          description: OK
      security:
      - Bearer: []
      summary: Complete a post upload
      tags:
      - Posts
  /posts/v1/projects/{projectId}/feeds/{feedId}/posts/upload/init:
    post:
      description: Begin a media upload and create a draft post
      operationId: initPostUpload
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Feed ID
        in: path
        name: feedId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/gateway.initUploadBody'
              description: Upload initialization request
              summary: request
        description: Upload initialization request
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/postsv1.PostUploadInit'
          description: Created
      security:
      - Bearer: []
      summary: Initialize a post upload
      tags:
      - Posts
  /projects/{projectId}/feeds:
    get:
      description: Lists all feeds for the active project with pagination.
      operationId: listFeeds
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Limit
        example: 25
        in: query
        name: limit
        schema:
          default: 25
          maximum: 100
          minimum: 1
          type: integer
      - description: Offset
        example: 0
        in: query
        name: offset
        schema:
          default: 0
          minimum: 0
          type: integer
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/feedsv1.ListFeedsResponse'
          description: OK
      security:
      - Bearer: []
      summary: List feeds
      tags:
      - Feeds
    post:
      description: Creates a new feed under the active project.
      operationId: createFeed
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/types.CreateFeedRequest'
              description: Feed details
              summary: request
        description: Feed details
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/feedsv1.Feed'
          description: Created
      security:
      - Bearer: []
      summary: Create a feed
      tags:
      - Feeds
  /projects/{projectId}/feeds/{feedId}:
    delete:
      description: Deletes a feed in the active project.
      operationId: deleteFeed
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Feed ID
        example: F4edRI23XL
        in: path
        name: feedId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/feedsv1.DeleteFeedResponse'
          description: OK
      security:
      - Bearer: []
      summary: Delete a feed
      tags:
      - Feeds
    get:
      description: Retrieves a feed by ID under the active project.
      operationId: getFeed
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Feed ID
        example: F4edRI23XL
        in: path
        name: feedId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/feedsv1.Feed'
          description: OK
      security:
      - Bearer: []
      summary: Get a feed
      tags:
      - Feeds
    put:
      description: Updates an existing feed in the active project.
      operationId: updateFeed
      parameters:
      - description: Project ID
        in: path
        name: projectId
        required: true
        schema:
          type: string
      - description: Feed ID
        example: F4edRI23XL
        in: path
        name: feedId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/types.UpdateFeedRequest'
              description: Updated feed details
              summary: request
        description: Updated feed details
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/feedsv1.Feed'
          description: OK
      security:
      - Bearer: []
      summary: Update a feed
      tags:
      - Feeds
servers:
- url: /
tags:
  - name: Auth / Authentication
    x-displayName: Authentication
    description: Login, registration, token refresh, logout, and password reset.
  - name: Auth / User
    x-displayName: User
    description: Current user profile, username, and connected social providers.
  - name: Auth / Email
    x-displayName: Email
    description: Email verification, additional addresses, and email changes.
  - name: Auth / TOTP
    x-displayName: TOTP
    description: Time-based one-time password (2FA) management.
  - name: Auth / Passkeys
    x-displayName: Passkeys
    description: WebAuthn passkey registration and login.
  - name: Auth / Memberships
    x-displayName: Memberships
    description: Organization memberships and invitations.
  - name: Auth / Policies
    x-displayName: Policies
    description: Access policies and attachments.
  - name: Auth / Custom Domains
    x-displayName: Custom Domains
    description: Custom domain verification and auto-join.
  - name: Auth / Blog
    x-displayName: Blog
    description: Blog subscription management.
  - name: Billing / Plans
    x-displayName: Plans
    description: Available subscription plans and their pricing.
  - name: Billing / Subscriptions
    x-displayName: Subscriptions
    description: Subscription lifecycle - create, change, and cancel.
  - name: Billing / Invoices
    x-displayName: Invoices
    description: Invoice history and details.
  - name: Billing / Usage
    x-displayName: Usage
    description: Metered usage and quota consumption.
  - name: Billing / Payments
    x-displayName: Payments
    description: Payment methods and payment processing.
  - name: Billing / Webhooks
    x-displayName: Webhooks
    description: Incoming billing provider webhook events.
  - name: Media / Videos
    x-displayName: Videos
    description: Video upload, processing, and playback.
  - name: Media / Images
    x-displayName: Images
    description: Image upload, optimization, and delivery.
  - name: Media / Audio Tracks
    x-displayName: Audio Tracks
    description: Alternate audio tracks for videos.
  - name: Media / Subtitles
    x-displayName: Subtitles
    description: Subtitle and caption tracks.
  - name: Media / Chapters
    x-displayName: Chapters
    description: Video chapter markers.
  - name: Media / Languages
    x-displayName: Languages
    description: Supported languages for tracks and subtitles.
  - name: Credentials / API Keys
    x-displayName: API Keys
    description: API key creation, rotation, and revocation.
  - name: Credentials / Client Credentials
    x-displayName: Client Credentials
    description: OAuth2 client credentials for service-to-service authentication.
x-tagGroups:
  - name: Auth
    tags:
      - Auth / Authentication
      - Auth / User
      - Auth / Email
      - Auth / TOTP
      - Auth / Passkeys
      - Auth / Memberships
      - Auth / Policies
      - Auth / Custom Domains
      - Auth / Blog
  - name: Projects
    tags:
      - Projects
  - name: Media
    tags:
      - Media / Videos
      - Media / Images
      - Media / Audio Tracks
      - Media / Subtitles
      - Media / Chapters
      - Media / Languages
  - name: Feeds
    tags:
      - Feeds
      - Posts
  - name: Billing
    tags:
      - Billing / Plans
      - Billing / Subscriptions
      - Billing / Invoices
      - Billing / Usage
      - Billing / Payments
      - Billing / Webhooks
  - name: Credentials
    tags:
      - Credentials / API Keys
      - Credentials / Client Credentials
  - name: Analytics
    tags:
      - Analytics
  - name: Platform
    tags:
      - Platform Auth