Billing

On this page

PlansMonthly usage capsMetered pricing (Pro)Metered pricing (Scale)UpgradingManaging your subscriptionBilling statusCurrent period usageUsage breakdown (Scale)Invoice historyUsage reportingUsage alertsPayment failureDowngradingCustom limit overrides

fold.run offers three plans: Free for getting started, Pro for production teams, and Scale for high-volume deployments.

Plans

Feature Free Pro Scale
Functions 10 100 1,000
Rate limit 100 req/min 10,000 req/min 100,000 req/min
Storage 50 MB 1 GB 50 GB
CPU per request 50 ms 200 ms 500 ms
Subrequests per request 10 50 200
Team members 3 Unlimited Unlimited
Workspaces 1 5 Unlimited
Custom domains No Yes Required
AI code generation No Yes Yes
AI error diagnosis No Yes Yes

Monthly usage caps

Each plan includes monthly caps on activations, CPU time, and AI tokens. Behavior when a cap is reached depends on your plan.

Metric Free Pro Scale
Activations 10,000 1,000,000 100,000,000
CPU time 500,000 ms (~8 min) 50,000,000 ms (~14 hrs) 5,000,000,000 ms (~1,400 hrs)
AI tokens 0 (not available) 5,000,000 100,000,000
Overage mode Hard — requests blocked Soft — overage billed Soft — overage billed

Free plan: When you hit a monthly cap, requests to your functions are rejected with a 429 USAGE_LIMIT_EXCEEDED error until the next billing period.

Pro and Scale plans: Usage beyond the included caps is metered and charged automatically. Requests are never blocked.

Metered pricing (Pro)

Usage beyond the monthly included caps is charged at these rates:

Metric Included Overage rate
Activations 1,000,000 $0.10 per 1,000
CPU time 50,000,000 ms $1.00 per 1,000,000 ms
AI tokens 5,000,000 $10.00 per 1,000,000

Metered pricing (Scale)

Scale includes higher caps and lower per-unit overage rates:

Metric Included Overage rate
Activations 100,000,000 $0.05 per 1,000
CPU time 5,000,000,000 ms $0.50 per 1,000,000 ms
AI tokens 100,000,000 $5.00 per 1,000,000

Usage is reported daily to Stripe and appears on your next invoice. Billing is at the account level, not per workspace. All workspaces share your plan's limits. View per-workspace usage from the Workspace Usage page or via fold workspace usage.

Upgrading

Via the dashboard

Go to app.fold.run/console/billing and click Upgrade to Pro or Upgrade to Scale. You'll be redirected to a secure checkout page to enter payment details.

Note: Upgrading to Scale requires an active custom domain on your account. Set one up first via Domains.

Via the API

# Create a checkout session for Pro
curl -X POST https://api.fold.run/billing/checkout \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "plan": "pro" }'

# Create a checkout session for Scale
curl -X POST https://api.fold.run/billing/checkout \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "plan": "scale" }'

The response includes a checkout_url — redirect to it to complete payment.

Free trial

You can start a trial before being charged:

curl -X POST https://api.fold.run/billing/checkout \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "trial_days": 14 }'

Trial length can be 1 to 30 days.

Managing your subscription

Access the customer portal to update payment methods, view invoices, or cancel:

curl -X POST https://api.fold.run/billing/portal \
  -H "Authorization: Bearer YOUR_TOKEN"

This returns a portal_url you can visit in your browser.

Billing status

Check your current plan and billing status:

curl "https://api.fold.run/billing" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response:

{
  "tenant_id": "my-tenant",
  "plan": "pro",
  "status": "active",
  "stripe_customer_id": "cus_...",
  "created_at": "2026-03-01T00:00:00.000Z",
  "grace_days_remaining": null
}

For past-due organizations, grace_days_remaining shows how many days remain before automatic downgrade (see "Payment failure" below).

Current period usage

View your usage against monthly caps, with cost breakdown and projections:

curl "https://api.fold.run/billing/current-period" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response:

{
  "plan": "pro",
  "period_start": "2026-03-01",
  "period_end": "2026-04-01",
  "days_elapsed": 15,
  "days_remaining": 16,
  "usage": {
    "activations": 520000,
    "cpu_ms": 12000000,
    "ai_tokens": 1200000
  },
  "limits": {
    "monthly_activations": 1000000,
    "monthly_cpu_ms": 50000000,
    "monthly_ai_tokens": 5000000,
    "overage_mode": "soft"
  },
  "projected": {
    "activations": 1073000,
    "cpu_ms": 24800000,
    "ai_tokens": 2480000
  },
  "costs": {
    "activations": 52.00,
    "cpu_ms": 12.00,
    "ai_tokens": 12.00,
    "total": 76.00,
    "projected_total": 156.80
  }
}

On the Free plan, costs is null.

Usage breakdown (Scale)

Scale organizations can view per-function usage for cost visibility and capacity planning:

curl "https://api.fold.run/billing/usage-breakdown" \
  -H "Authorization: Bearer YOUR_TOKEN"

Invoice history

View your recent invoices:

curl "https://api.fold.run/billing/invoices" \
  -H "Authorization: Bearer YOUR_TOKEN"

Returns up to 12 invoices with amount, status, period, and a link to the hosted invoice.

Usage reporting

The platform reports your daily usage (activations, CPU time, AI tokens) automatically. Usage appears on your next invoice and is visible in real time on the Usage page in the dashboard.

Usage alerts

Set up alerts to get notified when usage crosses a threshold. Go to Alert Rules in the dashboard to create, view, and delete alerts.

Field Type Description
metric string activations, errors, or cpu_ms
threshold number Alert when this value is exceeded
period string daily (default) or monthly
notify_email string Email address for notifications
notify_webhook string Webhook URL for notifications

At least one of notify_email or notify_webhook is required.

The platform also sends automatic overage warnings at 80% and 100% of your monthly caps.

Payment failure

If a payment fails, your subscription enters a past_due state. You have a 7-day grace period to update your payment method. During this period your functions continue running on your current plan limits.

After the grace period expires, your account is automatically downgraded to Free plan limits.

Update payment via the customer portal (see "Managing your subscription" above).

Downgrading

Cancel your subscription from the dashboard at Billing, or through the customer portal (see "Managing your subscription" above).

Cancellation takes effect at the end of the current billing period — you keep your current limits until then.

Before cancelling, the platform checks that your current usage fits within Free plan limits:

  • Functions: must be 10 or fewer
  • Workspaces: must be 1 (default only)
  • Team members: must be 3 or fewer
  • Storage: must be 50 MB or less

If any check fails, you'll see a list of what to reduce first.

Custom limit overrides

Contact us for custom per-organization limits that override the default plan caps — for example, more functions, higher rate limits, or larger monthly caps. Custom overrides are applied on top of your plan and visible in the dashboard.

PreviousTeamsNextAccount management