Enable GUI Storage Account
API-v2gui_storage::enable_account
Marks a specific account as the active (enabled) account within GUI storage. If the account doesn't yet exist you can create-and-enable it in a single call.
| Parameter | Type | Required | Description |
|---|---|---|---|
| policy | EnableAccountPolicyEnum | ✓ | Determines whether to enable an existing account or create-and-enable a new one. |
| account_id | EnabledAccountId | ✗ | Required when policy = existing. Identifies the account to enable. |
| balance_usd | string (numeric) | ✗ | Optional initial USD balance when policy = new; defaults to 0. |
| description | string | ✗ | Optional description (≤ 600 chars) for a new account. |
| name | string | ✗ | Required when policy = new. Display name for the new account (≤ 255 chars). |
| Parameter | Type | Description |
|---|---|---|
| result | string | Returns success when the account is enabled. |
Enable an existing Iguana account:
enable_account (existing)
POST
gui_storage::enable_account{
"mmrpc": "2.0",
"method": "gui_storage::enable_account",
"params": {
"policy": "existing",
"account_id": {
"type": "iguana"
}
},
"id": 1,
"userpass": "RPC_UserP@SSW0RD"
}
Create and enable a new HD account:
enable_account (new)
POST
gui_storage::enable_account{
"mmrpc": "2.0",
"method": "gui_storage::enable_account",
"params": {
"policy": "new",
"account_id": {
"type": "hd",
"account_idx": 0
},
"name": "HD-0",
"description": "Hardware HD account",
"balance_usd": "0"
},
"id": 2,
"userpass": "RPC_UserP@SSW0RD"
}
| Parameter | Type | Description |
|---|---|---|
| NameTooLong | string | Provided name exceeds maximum length. |
| DescriptionTooLong | string | description exceeds maximum length. |
| AccountExistsAlready | string | Attempted to create an account that already exists (policy = new). |
| NoSuchAccount | string | policy = existing but the given account_id was not found. |
| ErrorLoadingAccount | string | Storage read error. |
| ErrorSavingAccount | string | Storage write error. |
| InternalError | string | Unhandled internal error. |