Move minutes
Moves minutes between the shared pool and teammates: a top-up, a hand-back or a move between people. Set from_user_id or to_user_id to null for the pool. Send an Idempotency-Key. Returns 402 when the source doesn’t have enough minutes.
Scopes: billing:write
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
A unique key (a UUID works) for this request. Retrying with the same key returns the first answer instead of running twice.
255The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"