Wallets
Patch Wallet
Allowed on any kind/status (including ARCHIVED — historical labels can be tidied for trophy-case display). Empty strings reset to None.
PATCH
Patch Wallet
Authorizations
Issue from /v1/keys (or admin-issued for enterprise tier).
Headers
Path Parameters
Body
application/json
Maximum string length:
64Response
Successful Response
Previous
Reset WalletArchive the current wallet and spawn the next-generation copy.
Behaviour:
- Old wallet: status=ARCHIVED, archived_at=NOW; LedgerEntry(RESET)
emitted on the user's accounts row as a forensic boundary marker
(reference_id=`wallet:{old_id}:reset`).
- New wallet: same kind, generation=N+1, parent_wallet_id=old_id,
balance=baseline (from FEATURE_MATRIX), status=ACTIVE; LedgerEntry
(DEPOSIT, baseline) emitted with reference_id=`wallet:{new_id}:init`.
Next
Patch Wallet