Sub-Accounts

Not generated in the PHP SDK yet. zavudev/sdk does not expose a sub-accounts resource today, so there is nothing to call. The endpoints exist and are stable: use the REST API below, the CLI, or the TypeScript SDK, which does cover it. See the coverage table.

Sub-accounts are isolated projects under your team, each with its own API keys and spending cap. Every charge still bills to the parent team’s balance.

These endpoints require a parent project API key. A sub-account key calling them receives 403.

Create a sub-account

curl -X POST https://api.zavu.dev/v1/sub-accounts \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Client ABC",
    "externalId": "client_123",
    "creditLimit": 100000
  }'

creditLimit is in cents. The response includes apiKey, and that is the only time it is returned.

CLI

npx zavudev sub-accounts create --data '{"name":"Client ABC"}'

Retrieve, list and update

curl https://api.zavu.dev/v1/sub-accounts/jx7abc123 \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"

curl "https://api.zavu.dev/v1/sub-accounts?limit=50" \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"

curl -X PATCH https://api.zavu.dev/v1/sub-accounts/jx7abc123 \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "creditLimit": 250000 }'

Spending

curl https://api.zavu.dev/v1/sub-accounts/jx7abc123/balance \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"

Returns the parent team’s balance alongside this sub-account’s totalSpent and creditLimit, all in cents.

API keys

# List
curl https://api.zavu.dev/v1/sub-accounts/jx7abc123/api-keys \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"

# Create (the full key is returned once)
curl -X POST https://api.zavu.dev/v1/sub-accounts/jx7abc123/api-keys \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Production Key", "environment": "live" }'

# Revoke
curl -X DELETE https://api.zavu.dev/v1/sub-accounts/jx7abc123/api-keys/key_id \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"

Deactivate

curl -X DELETE https://api.zavu.dev/v1/sub-accounts/jx7abc123 \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY"

Remaining balance returns to the parent team and every API key is revoked.

Sub-accounts guide

When to use them, and how billing works

API reference

Every field on the endpoints

​Create a sub-account

​Retrieve, list and update

​Spending

​API keys

​Deactivate

Sub-accounts guide

API reference

Create a sub-account

Retrieve, list and update

Spending

API keys

Deactivate