/editRole
1 min
POST
http://1.1.1.1/editRole
Query Parameters
- roleobjectrequiredDescriptionDefault{ "Id": "2376234", "Name": "Role name", "Frequency": 0, "IsAdmin": true, "CanApproveTransactions": false, "CanEditContactsAndAddressGroups": true, "CanApproveMultisigTransactions": false, "AmountLimit": "123", "FeesLimit": "123", "UserIds": ["[email protected]", "[email protected]"] }
- request_extra_dataobjectrequiredDescriptionDefault{ "MessageNumber": 5, "SessionId": "3478593863424051983840947" }
Body Parameters
- bodyeditRoleRequest
- FunctionDataobject
- IdstringExampleDescriptionDefault123
- RequestExtraDataobject
- MessageNumberintegerExampleDescriptionDefault5
- SessionIdstringExampleDescriptionDefault3478593863424051983840947
- MetaMetaTokeneditRole
- FunctionNamestringExampleDescriptionDefaultdeleteRole
- RandomDatastringExampleDescriptionDefault288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229
- DestinationstringDescriptionDefaultb9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea
- TimestringExampleDescriptionDefault2021-02-07T18:37:46.948Z
- SourcestringDescriptionDefault048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99
- AccessTokenstringExampleDescriptionDefault51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087
Responses
200
- editRoleResponse
- FunctionDataobject
- StatusCodeintegerDescriptionDefault0
- MetaMetaResponse
- AccessTokenstringExampleDescriptionDefaulta3e816b5bc04302d99da94705ec2309a4a63fe10d6aed3c5f6fc9e7ff27c6be6
- DestinationstringExampleDescriptionDefault042c671aeb148d9b2bb4918399c4c925f3764248c5ab2d5194ab0f32664132834692699a75e7fafb5af35f183b7d8a68bdc3b3e6ebfaff8ab555b9a3caf8090622
- SourcestringExampleDescriptionDefaultdf4b76a23067a9d782d09a7372ed526ec713cf6d771fac4dbdb9610f7af36d570a157eed76986b8e85afde12888d10d10bef461399e490f3d7e4db44cde1b6e355
- TimestringExampleDescriptionDefault2021-02-14 09:58:52.320
curl
curl --request POST \
--url 'http://1.1.1.1/editRole?role=%22{%5Cn%20%20%5C%22Id%5C%22%3A%20%5C%222376234%5C%22%2C%5Cn%20%20%5C%22Name%5C%22%3A%20%5C%22Role%20name%5C%22%2C%5Cn%20%20%5C%22Frequency%5C%22%3A%200%2C%5Cn%20%20%5C%22IsAdmin%5C%22%3A%20true%2C%5Cn%20%20%5C%22CanApproveTransactions%5C%22%3A%20false%2C%5Cn%20%20%5C%22CanEditContactsAndAddressGroups%5C%22%3A%20true%2C%5Cn%20%20%5C%22CanApproveMultisigTransactions%5C%22%3A%20false%2C%5Cn%20%20%5C%22AmountLimit%5C%22%3A%20%5C%22123%5C%22%2C%5Cn%20%20%5C%22FeesLimit%5C%22%3A%20%5C%22123%5C%22%2C%5Cn%20%20%5C%22UserIds%5C%22%3A%20[%5C%22bla%40gk8.io%5C%22%2C%20%5C%22bla2%40gk8.io%5C%22]%5Cn}%5Cn%22&request_extra_data=%22{%5Cn%20%20%5C%22MessageNumber%5C%22%3A%205%2C%5Cn%20%20%5C%22SessionId%5C%22%3A%20%5C%223478593863424051983840947%5C%22%5Cn}%5Cn%22' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"FunctionData": {
"Id": "123",
"RequestExtraData": {
"MessageNumber": 5,
"SessionId": "3478593863424051983840947"
}
},
"Meta": {
"FunctionName": "deleteRole",
"RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
"Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
"Time": "2021-02-07T18:37:46.948Z",
"Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
"AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
}
}'javascript
var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");
var raw = JSON.stringify({
"FunctionData": {
"Id": "123",
"RequestExtraData": {
"MessageNumber": 5,
"SessionId": "3478593863424051983840947"
}
},
"Meta": {
"FunctionName": "deleteRole",
"RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
"Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
"Time": "2021-02-07T18:37:46.948Z",
"Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
"AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
}
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("http://1.1.1.1/editRole?role=\"{\\n \\\"Id\\\": \\\"2376234\\\",\\n \\\"Name\\\": \\\"Role name\\\",\\n \\\"Frequency\\\": 0,\\n \\\"IsAdmin\\\": true,\\n \\\"CanApproveTransactions\\\": false,\\n \\\"CanEditContactsAndAddressGroups\\\": true,\\n \\\"CanApproveMultisigTransactions\\\": false,\\n \\\"AmountLimit\\\": \\\"123\\\",\\n \\\"FeesLimit\\\": \\\"123\\\",\\n \\\"UserIds\\\": [\\\"[email protected]\\\", \\\"[email protected]\\\"]\\n}\\n\"&request_extra_data=\"{\\n \\\"MessageNumber\\\": 5,\\n \\\"SessionId\\\": \\\"3478593863424051983840947\\\"\\n}\\n\"", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));ruby
require "uri"
require "json"
require "net/http"
url = URI("http://1.1.1.1/editRole?role=\"{\n \\"Id\\": \\"2376234\\",\n \\"Name\\": \\"Role name\\",\n \\"Frequency\\": 0,\n \\"IsAdmin\\": true,\n \\"CanApproveTransactions\\": false,\n \\"CanEditContactsAndAddressGroups\\": true,\n \\"CanApproveMultisigTransactions\\": false,\n \\"AmountLimit\\": \\"123\\",\n \\"FeesLimit\\": \\"123\\",\n \\"UserIds\\": [\\"[email protected]\\", \\"[email protected]\\"]\n}\n\"&request_extra_data=\"{\n \\"MessageNumber\\": 5,\n \\"SessionId\\": \\"3478593863424051983840947\\"\n}\n\"")
http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
"FunctionData": {
"Id": "123",
"RequestExtraData": {
"MessageNumber": 5,
"SessionId": "3478593863424051983840947"
}
},
"Meta": {
"FunctionName": "deleteRole",
"RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
"Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
"Time": "2021-02-07T18:37:46.948Z",
"Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
"AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
}
})
response = http.request(request)
puts response.read_body
python
import requests
import json
url = "http://1.1.1.1/editRole?role=\"{\\n \\\"Id\\\": \\\"2376234\\\",\\n \\\"Name\\\": \\\"Role name\\\",\\n \\\"Frequency\\\": 0,\\n \\\"IsAdmin\\\": true,\\n \\\"CanApproveTransactions\\\": false,\\n \\\"CanEditContactsAndAddressGroups\\\": true,\\n \\\"CanApproveMultisigTransactions\\\": false,\\n \\\"AmountLimit\\\": \\\"123\\\",\\n \\\"FeesLimit\\\": \\\"123\\\",\\n \\\"UserIds\\\": [\\\"[email protected]\\\", \\\"[email protected]\\\"]\\n}\\n\"&request_extra_data=\"{\\n \\\"MessageNumber\\\": 5,\\n \\\"SessionId\\\": \\\"3478593863424051983840947\\\"\\n}\\n\""
payload = json.dumps({
"FunctionData": {
"Id": "123",
"RequestExtraData": {
"MessageNumber": 5,
"SessionId": "3478593863424051983840947"
}
},
"Meta": {
"FunctionName": "deleteRole",
"RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
"Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
"Time": "2021-02-07T18:37:46.948Z",
"Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
"AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
}
})
headers = {
'accept': 'application/json',
'content-type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
200
// success
{
"FunctionData": {
"StatusCode": 0
},
"Meta": {
"AccessToken": "a3e816b5bc04302d99da94705ec2309a4a63fe10d6aed3c5f6fc9e7ff27c6be6",
"Destination": "042c671aeb148d9b2bb4918399c4c925f3764248c5ab2d5194ab0f32664132834692699a75e7fafb5af35f183b7d8a68bdc3b3e6ebfaff8ab555b9a3caf8090622",
"Source": "df4b76a23067a9d782d09a7372ed526ec713cf6d771fac4dbdb9610f7af36d570a157eed76986b8e85afde12888d10d10bef461399e490f3d7e4db44cde1b6e355",
"Time": "2021-02-14 09:58:52.320"
}
}- NOTE - this function can not be called from Swagger, please use editRoleForSwagger instead.
- Calling this request is used to edit an existing role in the MPC Driven system
- return - success or error response.
- Possible status codes:
0 - Role edited successfully,
1 - Unknown role,
2 - Role name already exists,
3 - Invalid name,
4 - Invalid frequency,
5 - Invalid amount limit,
6 - Invalid fees limit,
7 - Invalid allowed operations due to removing admin operation to users in the admin group,
8 - Invalid allowed operations due to not enough approvers in the approval workflow,
9 - Cannot change the name of the system-defined role,
10 - Cannot change allowed operations of the default role,
11 - Cannot change admin or transaction approval operations of the quorum admin role,
12 - Duplicate user,
13 - Unknown user
Have a question?
Our super-smart AI, knowledgeable support team and an awesome community will get you an answer in a flash.
To ask a question or participate in discussions, you'll need to authenticate first.