Update static wallet
Static WalletsAPI REFERENCE
Update static wallet
PATCH
/v1/static-wallets/{staticWalletId}Update a static wallet's accepted-asset allow-list, metadata, or webhook URL. Only the fields present in the body are changed.
Example request
A minimal request you can copy and run.
curl -X PATCH https://api.suward.com/v1/static-wallets/<static_wallet_id> \ -H "X-Api-Key: $SUWARD_API_KEY" \ -H "Content-Type: application/json" \ -d '{"webhookUrl":"https://example.com/webhook"}'Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| staticWalletId | string | yes | Static wallet ID |
Request body
| Name | Type | Required | Description |
|---|---|---|---|
| allowedAssets | no | New accepted-asset allow-list, as asset id-strings (see GET /v1/assets). When empty or omitted the current list is left unchanged. | |
| metadata | object | no | Replacement key/value metadata for the static wallet. |
| webhookUrl | string | no | Replacement webhook URL for this wallet's deposit events. |
Request · JSON
{ "webhookUrl": "https://example.com/webhook"}Response
| Name | Type | Required | Description |
|---|---|---|---|
| address | string | no | Reusable on-chain deposit address of this static wallet. Customers may send accepted assets to it repeatedly; each incoming transfer becomes a deposit. |
| allowedAssets | no | Accepted-asset allow-list, as asset id-strings (see GET /v1/assets). Deposits of assets outside this list are ignored and not credited. | |
| createdAt | integer | no | Unix-milliseconds timestamp when the static wallet was created. |
| externalId | string | no | Your own identifier for this static wallet, echoed from creation. Null when none was provided. |
| id | string | no | Unique Suward identifier of the static wallet. |
| metadata | object | no | Arbitrary key/value data attached by the merchant, echoed back unchanged. |
| projectId | string | no | Identifier of the project that owns this static wallet. |
| updatedAt | integer | no | Unix-milliseconds timestamp when the static wallet was last updated. |
| webhookUrl | string | no | Webhook URL that receives this wallet's deposit events. Null when the project default webhook is used. |
Response · JSON
{ "address": "0xabc…def", "allowedAssets": [ "USDT_ETHEREUM" ], "createdAt": 0, "externalId": "order_abc123", "id": "obj_abc123", "metadata": {}, "projectId": "obj_abc123", "updatedAt": 0, "webhookUrl": "https://example.com/webhook"}