Set Node Platform Owner Wallet
Pins the platform owner payout wallet for one node on one network, or clears the override when wallet_id is empty so the node inherits the network-wide default again. The wallet is chosen from the same pool as the default: one of the platform owner (root) node's own wallets, on the network's chain. The override applies to setups the node creates afterwards; existing setups keep the wallet they were created with.
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/nodes/{node_id}/platform-owner-wallets/networks/{network_id}
Parameters
| Name | Type | In | Description |
|---|---|---|---|
node_id | string | path | Required. The node the override is for |
network_id | string | path | Required. The network the override is for |
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 node's override (clearing when there is none is a no-op). |
Example
curl --request PUT \
--url '{{baseUrl}}/v2/admin/nodes/6901350deb7ed8c1c38de4e9/platform-owner-wallets/networks/68fe7b31c2d94a5e8b1f0c63' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"wallet_id": "6907b0d3e2f1a4c5b6d7e8fa"
}'
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 | node_id or 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.