Skip to main content
WEBHOOK

Authorizations

Authorization
string
header
required

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 | billing_manager). Used by the dashboard for /mgmt/v1/… only — it is never accepted on /v1/….

Headers

Idempotency-Key
string
required

Reuse the same key on network retries. Execute a change with the preview’s key.

Required string length: 1 - 200

Path Parameters

id
string
required

Body

application/json
amount
integer
required
Required range: 1 <= x <= 100000000
reason
string
required
Required string length: 1 - 280
confirmed
boolean
required
livemode
boolean
default:true
expires_at
string<date-time> | null

Response

Success

organization_id
string
balance
integer<int64>
test_balance
integer<int64>
operation_id
string<uuid>