Top up the test credit balance
Deposits simulated money into the test credit balance only — free, unlimited and never
invoiced. Use amount to exercise billing without touching the live credit balance.
Minimum role: admin.
Authorizations
Short-lived JWT issued by the CarHub auth service (Better Auth), verified against its
JWKS. Claims: sub (user), org_id (active organisation) and role
(owner | admin | member). Used by the dashboard for /mgmt/v1/… only — it is never
accepted on /v1/….
Headers
Client-generated key (a UUID is ideal) making this POST safe to retry. The first request
is executed and its response stored for 24 h; any replay with the same key returns that
stored response with Idempotent-Replayed: true and bills nothing. Reusing a key with a
different payload is a 409 idempotency_key_reuse.
8 - 255Body
Simulated money to deposit, in minor currency units.
1 <= x <= 10000000