/editAccount

1 min

POST

/editAccount

Call this endpoint to edit an MPC Account when the system is in MPC Driven mode.

return: The status code of the request and its description.

Request Example:

.. code-block::

editAccount( account_id=910, name="My Mpc Account", transaction_notification_user_ids=["[email protected]", "[email protected]"], required_account_change_approvers=1, available_account_change_approver_user_ids=["[email protected]", "[email protected]"], request_extra_data={ "message_number": 5, "session_id": "3478593863424051983840947" } )

Response Example:

.. code-block::

{
    "FunctionData": {
            StatusCode=0,
            StatusCodeDescription="Account edited successfully"
    },
    "Meta": {
      "AccessToken": "58f08df6e369fa4d126e1ba5c7f66cf85c9c79df32d05fee8f3c542121c87cf5",
      "Destination": "044fd7dc60304b8aceeb662ce41bf9d9cc132278c0871c0a72fb4f3cecbabb25a86e43ae28dab21a95c64e2db76abdcfffb9bfdeec67a21399cfa5f555f01d054b",
      "Source": "be1f60e490b8ccabcc02a4595817b8edf45905d24944e87b8e3cae27f158df63843bfc4b09d37a5e752017b74ea2d136af272bea210f059e768e1ea8777aaf21e9",
      "Time": "2025-10-19 15:04:13.129"
    }
}

Error Responses

Error Type	Http Code	GK8 error code	Reason / Description	Example Response
Backend Response	400	1	Account ID does not exist	"StatusCode": 1
Backend Response	400	2	Account is controlled by cold wallet	"StatusCode": 2
Backend Response	400	3	Account is not activated	"StatusCode": 3
Backend Response	400	4	Account name already exists	"StatusCode": 4
Backend Response	400	5	Invalid account name	"StatusCode": 5
Backend Response	400	6	Unknown user	"StatusCode": 6, "UserIds": ["[email protected]", "[email protected]"], "UserType": "TransactionNotification"
Backend Response	400	7	Duplicate user	"StatusCode": 7, "UserId": "[email protected]", "UserType": "AccountChangeApprover"
Backend Response	400	8	User does not have view permission	"StatusCode": 8, "UserIds": ["[email protected]", "[email protected]"]
Backend Response	400	9	Admin user cannot be account change approver	"StatusCode": 9, "UserIds": ["[email protected]", "[email protected]"]
Backend Response	400	10	Required account change approvers cannot be negative	"StatusCode": 10
Backend Response	400	11	Required account change approvers cannot be zero with available approvers	"StatusCode": 11
Backend Response	400	12	Not enough account change approver users selected	"StatusCode": 12, "RequiredAccountChangeApprovers": 2, "AvailableAccountChangeApproverUsers": 1
Backend Response	400	13	Account change approver conflict due to policies	"StatusCode": 13, "PolicyIds": ["123"]
Backend Response	400	14	Account change approver conflict due to address groups	"StatusCode": 14, "AddressGroupIds": ["123"]

account_idintegerID of the account to edit.

account_infoobject<p>AccountInfo:</p> <ul> <li>name: The name of the account to edit.</li> <li>transaction_notification_user_ids: The email addresses of users that will receive transaction notifications for the account.</li> <li>required_account_change_approvers: How many of the available approvers are required to approve account changes.</li> <li>available_account_change_approver_user_ids: The email addresses of all users that are allowed to approve account changes.</li> </ul>

request_extra_dataobject<p>Unique identifier of the session, and sequential message of when in the session, when the call is made. If this is a new session the ID must be generated. For an ongoing session, fetch the session ID from the /getAdministrativeSessionInfo endpoint.</p>

acceptstringGenerated from available response content types

bodyobject

200success

curl --request POST \
     --url '/editAccount?account_id=1001&account_info=%22{%5Cn%20%20%5C%22name%5C%22%3A%20%5C%22Edited%20Account%5C%22%2C%20%20%5Cn%20%20%5C%22transaction_notification_user_ids%5C%22%3A%20[%5C%22ido%40gk8.io%5C%22]%2C%20%5Cn%20%20%5C%22required_account_change_approvers%5C%22%3A%201%2C%20%20%5Cn%20%20%5C%22available_account_change_approver_user_ids%5C%22%3A%20[%5C%22ido%40gk8.io%5C%22]%20%20%5Cn}%5Cn%22&request_extra_data=%22{%5Cn%20%20%5C%22MessageNumber%5C%22%3A%202%2C%5Cn%20%20%5C%22SessionId%5C%22%3A%20%5C%229f2bf96c-a1a8-4152-b50b-22009a57ef1b%5C%22%5Cn}%5Cn%22' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data-raw '{
     "FunctionData": {
     "AccountId": 1001,
     "AvailableAccountChangeApproverUserIds": [
     "[email protected]"
     ],
     "Name": "Edited Account",
     "RequestExtraData": {
     "MessageNumber": 2,
     "SessionId": "9f2bf96c-a1a8-4152-b50b-22009a57ef1b"
     },
     "RequiredAccountChangeApprovers": 1,
     "TransactionNotificationUserIds": [
     "[email protected]"
     ]
     },
     "Meta": {
     "FunctionName": "editAccount",
     "RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
     "Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
     "Time": "2021-02-07T18:37:46.948Z",
     "Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
     "AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
     }
     }'