Sign in

v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB
Organizations

Add Credits

Add credits to the organization.

When credits are added to a FREE-tier organization:

  • If new balance >= 100,000: Auto-upgrade to PRO tier
  • If new balance >= 1,000,000: Auto-upgrade to TEAM tier

PRO and TEAM tiers get enhanced rate limits automatically.

post/v1/organizations/credits

Request body

creditsinteger required

Number of credits to add. Must be positive.

Example request

{
  "credits": 1000
}

Response

Successful Response

previous_balanceinteger required

Credit balance before addition

credits_addedinteger required

Number of credits added

new_balanceinteger required

Credit balance after addition

previous_tier'build' | 'scale' | 'enterprise' | 'free' | 'pro' | 'team' required

Account tier (2026-07 pricing overhaul).

Current tiers (CC-required, tier minimum is a billing floor): BUILD: $25/mo min — 100K objects/mo (managed) / 1M vectors (MVS) SCALE: $250/mo min — 1M objects/mo (managed) / 25M vectors (MVS) ENTERPRISE: Custom — dedicated compute, SLA

LEGACY tiers — still stored on unmigrated orgs; resolvable until the Phase-4 migration completes (do NOT remove before then — org records in Mongo carry these strings): FREE (→ Build or read-only), PRO (→ Build), TEAM (→ Scale)

new_tier'build' | 'scale' | 'enterprise' | 'free' | 'pro' | 'team' required

Account tier (2026-07 pricing overhaul).

Current tiers (CC-required, tier minimum is a billing floor): BUILD: $25/mo min — 100K objects/mo (managed) / 1M vectors (MVS) SCALE: $250/mo min — 1M objects/mo (managed) / 25M vectors (MVS) ENTERPRISE: Custom — dedicated compute, SLA

LEGACY tiers — still stored on unmigrated orgs; resolvable until the Phase-4 migration completes (do NOT remove before then — org records in Mongo carry these strings): FREE (→ Build or read-only), PRO (→ Build), TEAM (→ Scale)

tier_upgradedboolean required

Whether tier was automatically upgraded