Skip to main content
POST
Top up the balance

Authorizations

Authorization
string
header
required

Use a Runcrate API key with the rc_live_* prefix as the bearer token. Create one at https://www.runcrate.ai/dashboard/api-keys.

Headers

Idempotency-Key
string

May be sent instead of idempotency_key in the body; if both are sent they must match.

Maximum string length: 255

Body

application/json
amount_usd
number
required

Amount to add, in USD: 20 to 10,000, in dollars and cents.

Required range: 20 <= x <= 10000
Example:

50

idempotency_key
string

Names this top-up: 1 to 255 printable ASCII characters, no spaces (a UUID per top-up works). Required here unless sent as the Idempotency-Key header; if both are sent they must match. The same key answers the same top-up with its current status and never charges twice.

Required string length: 1 - 255
Pattern: ^[\x21-\x7e]+$
Example:

"nightly-1"

Response

The top-up and its status. On a replay of an earlier key, its current status, with Idempotent-Replayed: true.

data
object
required