specification: FinOps Framework
specificationVersion: '1.0'
schema: https://www.finops.org/framework/
alignedWith:
  framework: FinOps Foundation Framework
  frameworkUrl: https://www.finops.org/framework/
  dataSpec: FOCUS
  dataSpecVersion: '1.3'
  dataSpecUrl: https://focus.finops.org/focus-specification/v1-3/
provider: Convex
providerId: convex
publisherName: Convex, Inc.
serviceCategory: Backend-as-a-Service
created: '2026-05-04'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-04, not harvested from the provider. See roadmap#35.
method: generated
modified: '2026-05-05'
reconciled: true
tags:
  - Backend
  - Database
  - Functions
  - Real-Time
  - Reactive
  - Serverless
  - TypeScript
  - FinOps
  - Cost Management
  - FOCUS
description: FOCUS-aligned FinOps for Convex - per-developer subscription seats on the Professional
  tier plus pay-as-you-go meters for function calls, database/file/search storage, database I/O, action
  compute (GB-hours), search queries, and egress. Business/Enterprise tiers add a monthly minimum and
  optional CPU-time pricing.
sources:
  - https://www.convex.dev/pricing
  - https://docs.convex.dev/production/state/limits
  - https://focus.finops.org/focus-specification/v1-3/
billingModel:
  pricingCategory: Subscription + Pay-As-You-Go
  billingFrequency: Monthly
  billingCurrency: USD
  chargeCategories:
    - Usage
    - Purchase
    - Tax
    - Adjustment
    - Refund
    - Credit
  chargeFrequency: Recurring
focusColumns:
  ServiceName: Convex
  ServiceCategory: Backend-as-a-Service
  ProviderName: Convex
  PublisherName: Convex, Inc.
  InvoiceIssuerName: Convex, Inc.
  PricingCategory: Usage-Based
  BillingCurrency: USD
  ChargeCategory: Usage
meters:
  - name: developer_seats
    description: Developer seats on the Professional plan ($25/seat/month)
    unit: seat
    aggregation: max
    dimensions:
      - plan
      - team
  - name: function_calls
    description: Convex function (query / mutation / action) invocations
    unit: request
    aggregation: sum
    dimensions:
      - deployment
      - function
      - environment
  - name: database_storage
    description: Document database storage consumed
    unit: GB-month
    aggregation: avg
    dimensions:
      - deployment
      - environment
  - name: database_io
    description: Database I/O bandwidth (read + write payload)
    unit: GB
    aggregation: sum
    dimensions:
      - deployment
      - operation
      - environment
  - name: file_storage
    description: File storage consumed
    unit: GB-month
    aggregation: avg
    dimensions:
      - deployment
      - environment
  - name: search_storage
    description: Search index storage consumed
    unit: GB-month
    aggregation: avg
    dimensions:
      - deployment
      - index
      - environment
  - name: search_queries
    description: Search query throughput measured in query-GB
    unit: query-GB
    aggregation: sum
    dimensions:
      - deployment
      - index
      - environment
  - name: action_compute
    description: Action compute time billed in GB-hours
    unit: GB-hour
    aggregation: sum
    dimensions:
      - deployment
      - function
      - runtime
      - environment
  - name: data_egress
    description: Outbound bytes returned to clients
    unit: GB
    aggregation: sum
    dimensions:
      - deployment
      - environment
principles:
  - name: Visibility
    description: Use the Convex dashboard usage views and per-deployment metrics to track function
      calls, action compute (GB-hours), storage, and egress. Export usage from the Management API
      and join to FOCUS-aligned billing exports for per-team allocation.
  - name: Allocation
    description: Allocate cost by deployment, environment (dev / preview / prod), and team. Tag deployments
      using project naming conventions; the Management API exposes deployment-level usage that can be
      broken down by environment and function.
  - name: Optimization
    description: Move long-running or third-party-fanout work into actions (avoid the 1s mutation budget),
      cache reactive query results on the client, narrow document scans with indexes (32k scan ceiling),
      keep file/search storage tidy, and consider the CPU-time pricing model on Business/Enterprise
      for compute-heavy workloads.
  - name: Accountability
    description: Set monthly soft quotas and overage budgets per deployment/environment; designate
      a Convex billing owner per project; alert on action GB-hours and database I/O spikes that historically
      drive overage.
maintainers:
  - FN: API Evangelist
    email: info@apievangelist.com