Set Platform Owner Wallet
Sets the platform owner's default payout wallet on one network, or clears it when wallet_id is empty. The wallet must be one of the platform owner (root) node's own wallets, on the network's chain. The change applies to setups created afterwards; existing setups keep the wallet they were created with (move one with Start Platform Owner Change). A node's own override, set with Set Node Platform Owner Wallet, takes precedence over this default.
Only the platform owner's API key may call this endpoint; any other key gets 403.
Required permission: node:create-root-wallet
Request
PUT /v2/admin/platform-owner-wallets/networks/{network_id}
Parameters
| Name | Type | In | Description |
|---|---|---|---|
network_id | string | path | Required. The network to set the default on |
Headers
| Name | Description |
|---|---|
Authorization | Required. Bearer <access_token> |
Content-Type | Required. application/json |
Body
| Field | Type | Required | Description |
|---|---|---|---|
wallet_id | string | No | A platform owner wallet on the network's chain. Empty or omitted clears the network's default (clearing a network that has none is a no-op). |
Example
curl --request PUT \
--url '{{baseUrl}}/v2/admin/platform-owner-wallets/networks/68fe7b31c2d94a5e8b1f0c63' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"wallet_id": "6907b0d3e2f1a4c5b6d7e8f9"
}'
Response
204 No Content, no body.
Errors
| Status | Code | Description |
|---|---|---|
| 400 | 10015 | The network is not found, the wallet is not one of the platform owner's wallets, or the wallet is not on the network's chain. message says which. |
| 400 | 10016 | network_id is not a valid id |
| 403 | 10005 | The API key does not belong to the platform owner |
See Errors for the error format and common codes.