Skip to main content
POST
Add to Balance

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <access_token>. This must be an account API access token minted via Parallel's OAuth device flow, not a standard API key. See the account API docs.

Body

application/json

Request to charge the org's default payment method and add to balance.

amount_cents
integer
required

Amount in cents to charge and add to the balance. Must be between 1 and 10000 cents ($100.00).

Required range: x <= 10000
idempotency_key
string
required

Required idempotency key. Stripe dedupes the charge server-side for at least 24h when the same key is submitted again for the same org (see https://docs.stripe.com/api/idempotent_requests). Pick a high-entropy value (e.g. a UUID) so distinct agent attempts do not collide.

Required string length: 8 - 128

Response

Successful Response

Balance response for service clients.

org_id
string
required

Organization ID

credit_balance_cents
number
required

Total available prepaid balance in cents (credits + prepaid commits). Always 0 when will_invoice is true.

pending_debit_balance_cents
number
required

Balance in cents currently held for inflight tasks plus charges not yet synced to the billing provider. Always 0 when will_invoice is true.

will_invoice
boolean
required

True if this organization is billed by invoice (postpaid) rather than from a prepaid credit balance. Invoice-only orgs cannot add balance via this API.