Addons

Workspaces can purchase addons to extend their base plan limits. Addons are additive to base plan capacity.

Available Addons

Extra Bandwidth

$10 per 100GB/month

Extend monthly bandwidth limit.

Min: 1 unit (100GB)
Max: 100 units (10TB)

Extra Storage

$20 per 100GB/month

Extend total storage capacity

Min: 1 unit (100GB)
Max: 100 units (10TB)

Build CPU

$15 per concurrent build/month

Add concurrent build capacity

Min: 1 unit
Max: 20 units

How Addons Work

Addons are additive to your base plan limits:

Total Capacity = Base Plan Limit + Addon Capacity

Examples

Storage Addon Example

Free Plan (10GB) + 2 Storage Addons (200GB) = 210GB Total
Pro Plan (100GB) + 5 Storage Addons (500GB) = 600GB Total

Bandwidth Addon Example

Pro Plan (1TB) + 5 Bandwidth Addons (500GB) = 1.5TB Total
Enterprise (10TB) + 10 Bandwidth Addons (1TB) = 11TB Total

Addon capacity is automatically included in feature limit calculations during enforcement checks.

Addon Management

List Available Addons

View all addons that can be purchased:

GET /v1/billing/addons

Response:

{
  "addons": [
    {
      "key": "extra_bandwidth",
      "name": "Extra Bandwidth",
      "description": "Add 100GB of monthly bandwidth",
      "unit": "100GB",
      "price_per_unit": 1000,
      "min_quantity": 1,
      "max_quantity": 100,
      "billing_type": "usage",
      "impact": {
        "feature_key": "max_bandwidth",
        "capacity_per_unit": 107374182400
      }
    }
  ]
}

List Active Addons

View addons currently active for your workspace:

GET /v1/workspaces/:workspaceId/billing/addons/active

Response:

{
  "addons": [
    {
      "id": "addon_abc123",
      "addon_key": "extra_storage",
      "quantity": 5,
      "total_capacity": 536870912000,
      "activated_at": "2025-01-01T00:00:00Z",
      "metadata": {
        "feature_key": "max_storage"
      }
    }
  ],
  "total_cost": 10000
}

Activate an Addon

Purchase and activate an addon:

POST /v1/workspaces/:workspaceId/billing/addons
Content-Type: application/json

{
  "addon_key": "extra_storage",
  "quantity": 5
}

Billing: Addons are billed monthly starting from activation date. Prorated charges apply for partial months.

Update Addon Quantity

Increase or decrease addon quantity:

PATCH /v1/workspaces/:workspaceId/billing/addons/:addonId/quantity
Content-Type: application/json

{
  "quantity": 10
}

Changes:

Increases take effect immediately
Decreases take effect at end of billing period

Deactivate Addon

Cancel an addon subscription:

DELETE /v1/workspaces/:workspaceId/billing/addons/:addonId

Addon remains active until the end of the current billing period.

Integration Example

Addons automatically integrate with feature enforcement:

func (es *EnforcementService) CheckFeatureAccess(
    ctx context.Context,
    workspaceID xid.ID,
    featureKey FeatureKey,
) (*FeatureAccessResult, error) {
    // Get base plan limit
    baseLimit, _ := es.GetBasePlanLimit(ctx, workspaceID, featureKey)
    
    // Add addon capacity
    addonCapacity, _ := es.calculateAddonCapacity(ctx, workspaceID, featureKey)
    
    // Total limit = base + addons
    totalLimit := baseLimit + addonCapacity
    
    // Get current usage
    currentUsage, _ := es.GetCurrentUsage(ctx, workspaceID, featureKey)
    
    // Check if can proceed
    canProceed := currentUsage < totalLimit
    
    return &FeatureAccessResult{
        CanProceed:    canProceed,
        CurrentUsage:  currentUsage,
        Limit:         totalLimit,
        BaseLimit:     baseLimit,
        AddonCapacity: addonCapacity,
    }, nil
}

Addon Pricing

Monthly Costs

Addon	Unit	Price	Example Cost (5 units)
Extra Bandwidth	100GB	$10/month	$50/month
Extra Storage	100GB	$20/month	$100/month
Build CPU	1 concurrent	$15/month	$75/month

Prorated Billing

Addons are prorated based on activation date:

Mid-cycle activation: Charged prorated amount for remaining days
Mid-cycle cancellation: Credit applied for unused days

Annual Discounts

Contact sales for annual addon commitments with discounted rates.

Use Cases

Seasonal Traffic Spikes

Add bandwidth addons during high-traffic periods and remove them when traffic normalizes:

Normal: Pro Plan (1TB bandwidth)
Peak Season: Pro + 10 Bandwidth Addons (2TB total)
Cost Impact: +$100/month during peak

Growing Package Library

Gradually add storage as your package library grows:

Start: Free Plan + 2 Storage Addons (210GB)
Growth: Free Plan + 5 Storage Addons (510GB)
Eventually: Upgrade to Pro Plan (100GB base)

CI/CD Pipelines

Add build CPU for faster parallel builds:

Standard: 1 concurrent build (included)
CI/CD: +3 Build CPU Addons = 4 concurrent builds
Cost: +$45/month
Benefit: 4x faster build times

FAQ

Can I add addons to any plan?

Yes, addons can be purchased on Free, Pro, and Enterprise plans.

Do addons roll over month-to-month?

Bandwidth and download limits reset monthly. Storage and build CPU are permanent capacity additions.

Can I temporary activate addons?

Yes, activate addons for as little as one billing period (monthly).

What happens if I exceed limits even with addons?

Operations are blocked with 402 Payment Required. You can either add more addons or upgrade your base plan.

Extra Bandwidth

Extra Storage

Build CPU

On this page