Skip to main content
POST
/
v1
/
organizations
/
credits
Add Credits
curl --request POST \
  --url https://api.mixpeek.com/v1/organizations/credits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "credits": 1000
}'
{
  "previous_balance": 123,
  "credits_added": 123,
  "new_balance": 123,
  "previous_tier": "free",
  "new_tier": "free",
  "tier_upgraded": true
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication using your API key. Format: 'Bearer your_api_key'. To get an API key, create an account at mixpeek.com/start and generate a key in your account settings.

Headers

​
Authorization
string
required

REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Examples:

"Bearer sk_live_abc123def456"

"Bearer sk_test_xyz789"

Body

application/json

Request to add credits to an organization.

​
credits
integer
required

Number of credits to add. Must be positive.

Required range: x > 0
Examples:

1000

10000

100000

Response

Successful Response

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
enum<string>
required

Account tier before addition

Available options:
free,
pro,
team,
enterprise
​
new_tier
enum<string>
required

Account tier after addition (may auto-upgrade)

Available options:
free,
pro,
team,
enterprise
​
tier_upgraded
boolean
required

Whether tier was automatically upgraded