Skip to main content
AgentRuntime runs two related programs:
  1. Referrals (/referrals) — Self-service for promoters who share codes with friends
  2. Friend referral credits — Bonus workspace credits when a new workspace is created with a code at signup
  3. Affiliates (Settings) — Maintainer-only ops for platform operators (feature-flagged)
Referrals nav requires enablePlatformReferrals. Settings → Affiliates requires enableSettingsAffiliates. If you do not see these items, the program is off for your deployment — see Feature availability.

​
Referrals (promoter self-service)

Open Referrals in the Console sidebar (/referrals).

​
Join the program

If you are not registered yet, click Get my referral code. This creates your promoter profile once.

​
Share your code

After joining you receive:
Referral codes are for new workspaces, not team invites. Friends must sign up and create their own workspace — not accept an invite to yours.
Copy hint shown in the Console: Friends enter referral code “YOUR_CODE” at checkout when paying for AgentRuntime.

​
Earnings dashboard

The Referrals page shows:
  • Pending and total earned (USD minor units / cents until payout)
  • Confirmed commissions and paid out totals
  • Recent commissions table — filter by pending, confirmed, paid, cancelled
Cash commissions apply when referred customers complete qualifying Stripe payments with your code on the payment intent.

​
Friend referral credits (workspace creation)

Separate from cash commissions, a referral code can grant bonus credits to both parties when a friend creates a new workspace:
  1. Friend opens signup with your code (link or manual entry during onboarding)
  2. After workspace creation, the platform redeems the friend referral
  3. Both referee and referrer receive bonus workspace credits (amounts depend on current program policy)
If redemption fails, workspace creation still succeeds — only the bonus credits are skipped.

​
Affiliates (Settings — operators)

Settings → Affiliates is for platform maintainers, not everyday promoters:
  • Review affiliate status, commission rates, and payout policy
  • Set affiliate status (active, suspended, revoked)
  • Create payout batches and view batch history
Promoters should use Referrals in the sidebar. Platform-wide ledger operations live in sysadmin tooling.
This tab is labeled maintainer-only in the Console. Tenant admins see it only when enableSettingsAffiliates is on.

​
Billing integration

Referral bonuses and commissions are independent — a friend can receive signup credits while your cash commission accrues only on their later payments.

​
API (automation)

Affiliate endpoints are primarily for Console and sysadmin clients. Promoters interact through /referrals. For custom integrations, contact support for current API access.

​
Troubleshooting