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.