Skip to main content

Update User Wallet

API operation: Open the endpoint in Scalar

Use PUT /users/{user_id}/wallets/{wallet_id} to update a user's wallet lock state. The current public operation is Wallet.update.

Only administrators and agents can update a wallet. The request must identify the user and wallet and include locked. Unlocking clears locked_reason and locked_at; locking records the time and creates a zero-amount audit event attributed to the authenticated caller.

The locked field is required. See Wallet model.

OpenAPI reference​

Operation: PUT /users/{user_id}/wallets/{wallet_id}

Path parameters

NameTypeRequiredDescription
user_idintegerYes—
wallet_idintegerYes—

Header parameters

NameTypeRequiredDescription
User-AgentstringNo—
X-Forwarded-ForstringNo—

Request body fields

NameTypeRequired
lockedbooleanYes
locked_reasonanyNo

Responses

CodeDescription
200OK (Envelope)
400Bad Request (ErrorResponse)
401Unauthorized
404Not Found
429Too Many Requests (ErrorResponse)
500Internal Server Error (ErrorResponse)
503Service Unavailable (ErrorResponse)
Open this operation in the API reference