Skip to main content

Team, Billing & API Keys

Everything you need to manage your organization: invite teammates, control access, handle billing, and generate API keys for CI/CD pipelines.


Team Management​

Inviting Members (Admin Only)​

  1. Go to Settings → Team Members.
  2. Click Invite Member.
  3. Enter the email address and select a role:
RolePermissions
AdminFull access — billing, settings, invitations, AI features configuration
DeveloperRun tests, view results, manage own profile
ViewerRead-only access to test results

Managing Roles​

  • Change role: Use the role dropdown in the member list.
  • Remove member: Click the trash icon.

API Keys (CI/CD Integration)​

API keys authenticate CI/CD pipelines without sharing personal credentials.

Generating a Key​

  1. Go to Settings → Profile → API Access.
  2. Click Generate New Key.
  3. Enter a label (e.g., "GitHub Actions").
  4. Copy the key immediately — it is only shown once.

Using the Key​

curl -H "x-api-key: pk_live_..." https://api.agnox.dev/api/executions

Billing & Plans​

Manage your subscription in Settings → Billing & Plans.

Plan Comparison​

FeatureFreeStarterTeamBusinessEnterprise
Price$0/mo$29/mo$99/mo$299/moCustom
Test Runs/Month502501,0002,500Unlimited
Projects13UnlimitedUnlimitedUnlimited
Team Members3520100Unlimited
Concurrent Runs12515Unlimited
Storage500 MB2 GB10 GB50 GB500 GB
Full AI Engine✅✅✅✅✅
All Integrations✅✅✅✅✅
Audit Logs———✅✅
SSO————✅
SupportCommunityEmailEmailPriorityDedicated 24/7

Limits are enforced automatically by the backend. Upgrading takes effect immediately.

Storage Tracking​

Agnox tracks your data usage in real time:

  • Live tracking: every execution finish atomically increments your organisation's storage counter.
  • Nightly reconciliation: a background job runs at 02:00 UTC using MongoDB $bsonSize aggregation to correct any drift from deletions or failed increments.

When your storage limit is reached, new execution requests are blocked with a 429 Storage limit exceeded response until storage is freed or you upgrade.

Upgrading​

  1. Click Upgrade to [Plan Name] on the desired plan card.
  2. Complete payment via the Stripe-hosted checkout form.
  3. The subscription activates via webhook — new limits apply immediately.

Usage Alerts​

Real-time alerts appear at the top of the Billing page as you approach plan limits:

UsageAlertAction
50%Info (blue)Monitor usage trends
80%Warning (yellow)Consider upgrading
90%Critical (red)Upgrade immediately
100%BlockedTests paused until reset or upgrade

Subscription Management​

Click Manage Subscription to access the Stripe Customer Portal:

  • Update payment method
  • View and download invoices
  • Cancel subscription

Cancellation: Service continues until the end of your current billing period, then downgrades to Free automatically. No prorated refunds.

Billing Status Reference​

StatusMeaning
🟢 ActivePayments current, full access
🟡 Past DuePayment failed; 7-day grace period before auto-cancel
⚫ CanceledScheduled for downgrade at period end

Payment & Security​

  • All payments processed by Stripe (PCI DSS Level 1)
  • Credit card details are never stored on Agnox servers
  • Accepted: Visa, Mastercard, Amex, Apple Pay, Google Pay

Billing FAQ​

When does my billing period reset? Monthly periods align with your subscription start date. Test run counters reset on that date.

Are there prorated charges?

  • Upgrades: Yes, prorated charge for the remaining period
  • Downgrades: Take effect at period end, no prorated refunds

What happens if payment fails? Automatic retry for 3 days → "Past Due" status → 7-day grace period → auto-cancel if unresolved.