Update Wallet
Rename a wallet, or make it the user’s primary wallet. Send only the fields you want to change; sending nickname as null clears the current name.
Making a wallet primary moves that status off whichever wallet currently holds it and updates the user’s payout addresses. Only an EOA can be primary, and primary status cannot be removed on its own — promote another wallet instead. If no Safe smart wallet exists on the promoted wallet’s chain, one is created in the background and the response is 202 Accepted.
Authorizations
JWT issued by Dynamic Labs or Privy. Sent in the x-juno-jwt header on every authenticated request.
Headers
Tenant org ID for multi-tenant auth
Controls how timestamp fields are serialized in JSON response bodies.
Default (header omitted or any other value): epoch milliseconds as integers.
iso8601: UTC ISO 8601 strings of the form YYYY-MM-DDTHH:MM:SSZ.
Example: with X-Timestamp-Format: iso8601, the field value 1704067200000 becomes "2024-01-01T00:00:00Z".
Affected fields (recursively, in dicts and arrays): any field whose name ends in _at, plus the literal field names timestamp, period_start, and period_end. All other fields are passed through unchanged.
Only iso8601 is recognized. Any other value (or omitting the header) yields the default epoch-ms representation; the server does not reject unknown values, so this is documented as an example rather than an enum to keep generated clients permissive.
"iso8601"
Path Parameters
Body
Request payload for updating wallet properties.
Set to true to make this wallet the primary EOA. Only EOA wallets can be primary. May trigger async Safe creation (202 response).
Update the wallet's friendly name. Omit the field to leave the current name alone; send it as null to clear the name entirely. An explicit null is a request to clear, so a client that PATCHes the whole object back must omit this field rather than send null for a wallet whose name should be kept.
100"Main Wallet"
Response
Wallet updated
HAL-style hypermedia links for navigation.
Public wallet identifier.
Wallet address (EOA or Safe).
Blockchain chain ID where this wallet exists. Must be 1329 (Sei mainnet).
True if this is the user's primary wallet for this type.
True for EOA (Externally Owned Account), false for Safe smart wallet.
Wallet creation timestamp (epoch milliseconds).
Set when this address is registered as a signer on the account's Safe rather than being a wallet the account holder transacts from. Absent on an ordinary wallet, and absent on a wallet that predates the field.
cli_mandate_key How far the signer registration has got. pending while the owner addition is in flight, active once the address has been confirmed in the Safe's owner set on chain, failed if it terminally did not land. active and failed are the only settled values — poll until one of them appears. Absent on a wallet that is not a registered signer.
pending, active, failed Why the registration failed, as the same error code the API returns elsewhere. Present only alongside signer_status: failed.
Human-readable detail for a failed registration. Present only alongside signer_status: failed.
User-defined friendly name for the wallet.
URI to the blockchain's logo image.
Soft deletion timestamp (epoch milliseconds).
Event ID for tracking Safe creation. Only present in 202 Accepted responses when Safe creation is triggered.
Linked payment cards. Only included when expand=cards is specified.