Smart Accounts
Update Smart Account
Update settings for an existing Smart Account
PATCH
Update the configuration of an existing Smart Account, including signers, threshold, and optional settings.
Key Concepts
- Partial Updates: Only specify the fields you want to modify
- Transaction Signing: Changes require signatures from current authorized signers or the admin address
- Validation Rules: Updates must maintain valid signer and threshold requirements
Update Modes
Standard Mode
In standard mode (without admin), updates require:
- Meeting the current threshold requirement
- Multiple signers can approve the transaction
- When updating
smart_account_signers
, you must provide the complete desired state - To unset a field, set it to an empty string
""
or0
Example request:
Admin Mode
When a smart account has an admin address set, only that address can modify settings using admin mode:
- Must use the
admin=true
query parameter - Only the admin address should be in
transaction_signers
Example admin request:
Understanding Updates
Modifying Fields
- Adding/Updating Fields: Include the field with its new value
- Removing Optional Fields: Set the field value to
""
or0
to remove it - Required Fields: Cannot be set to
""
or0
(will return validation error)
Example removing admin_address:
Only the admin address can remove the admin address.
Validation Rules
Signer Configuration
-
Must always maintain:
- At least one signer with CAN_INITIATE permission
- Enough signers with CAN_VOTE permission to meet threshold
- At least one signer with CAN_EXECUTE permission
-
Invalid configurations:
Threshold Requirements
- Must be greater than 0
- Must not exceed number of signers with CAN_VOTE permission
- Changes require meeting current threshold for signing
Admin Mode Requirements
- Only admin address can be in
transaction_signers
- Must use
admin=true
query parameter - Updates are atomic - all succeed or all fail
Important Notes
- Changes only take effect after transaction settlement
- Required fields cannot be removed:
smart_account_signers
(must maintain minimum permissions)threshold
(must be > 0)
- Admin can remove itself by setting
admin_address
to""
Authorizations
UUID-based API key provided by Squads
Headers
Specifies the network for the API request
Available options:
mainnet
, devnet
Path Parameters
The address of the smart account
Query Parameters
When true, indicates that the update is being performed by the smart account admin (configured in the admin_address field)
Body
application/json
Response
200
application/json
Smart account updated successfully
The response is of type object
.