---
title: "Add Credits"
method: POST
path: "/v1/organizations/credits"
tags: ["Organizations"]
---

# Add Credits

`POST /v1/organizations/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.

## Request body

- AddCreditsRequest — Request to add credits to an organization.
  - `credits` integer, required — Number of credits to add. Must be positive.

## Response `200`

Successful Response

- AddCreditsResponse — Response after adding credits.
  - `previous_balance` integer, required — Credit balance before addition
  - `credits_added` integer, required — Number of credits added
  - `new_balance` integer, 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_upgraded` boolean, required — Whether tier was automatically upgraded

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/revisions/5307993e44d3/schema)