/createRole

Calling this request is used to create a new role in the MPC Driven system

Request Example:

.. code-block::

createRole( id="2376234", name="Role name", frequency=0, is_admin=true, can_approve_transactions=false, can_edit_contacts_and_address_groups=true, can_complete_multisig_transactions=false, amount_limit="123", fees_limit="123", user_ids=["[email protected]", "[email protected]"], request_extra_data={ "message_number": 5, "session_id": "3478593863424051983840947" } )

---

Response Example:

.. code-block::

{
    "FunctionData": {
        "StatusCode": 0,
        "StatusCodeDescription": "Role created successfully"
    },
    "Meta": {
        "AccessToken": "2911...9a7",
        "Destination": "04bc...9e2",
        "Source": "3dcf...ba4",
        "Time": "2025-05-22 17:00:44.605"
    }
}

---

Possible status codes:

0 - Role created successfully,

1 - Role already exists,

2 - Role name already exists,

3 - Invalid name,

4 - Invalid frequency,

5 - Invalid amount limit,

6 - Invalid fees limit,

7 - Duplicate user,

8 - Unknown user,

9 - Invalid allowed operations due to removing admin operation to users in the admin group,

10 - Invalid allowed operations due to not enough approvers in approval workflow

curl --request POST \
     --url '/createRole?role={%0A%20%20%22Id%22%3A%20%222376234%22%2C%0A%20%20%22Name%22%3A%20%22Role%20name%22%2C%0A%20%20%22Frequency%22%3A%200%2C%0A%20%20%22IsAdmin%22%3A%20true%2C%0A%20%20%22CanApproveTransactions%22%3A%20false%2C%0A%20%20%22CanEditContactsAndAddressGroups%22%3A%20true%2C%0A%20%20%22CanApproveMultisigTransactions%22%3A%20false%2C%0A%20%20%22AmountLimit%22%3A%20%22123%22%2C%0A%20%20%22FeesLimit%22%3A%20%22123%22%2C%0A%20%20%22UserIds%22%3A%20[%22bla%40gk8.io%22%2C%20%22bla2%40gk8.io%22]%0A}%0A&request_extra_data={%0A%20%20%22MessageNumber%22%3A%205%2C%0A%20%20%22SessionId%22%3A%20%223478593863424051983840947%22%0A}%0A' \
     --header 'accept: application/json'