organisation
Change the role of members
POST
/api/v1/organisation/members/role
Give one root role to several members, or take it back with none. The last admin is never demoted; partial says some of the ids were skipped.
key
Required scope: org:admin
Request body application/json
-
idsarray of integer · requiredIds of the members.
-
rolestring · requiredThe root role to give them;
nonetakes it back.
Response
200
MembersRoleDone
-
changedintegerNumber of members whose role changed.
-
partialbooleanWhether some of the ids were skipped.
Errors
-
401
No valid credential.
-
403
The credential lacks the required scope, or the account may not do this.
-
409
The current state of the content forbids the request.
-
422
A value is missing or malformed.
-
429
Too many requests;
Retry-Aftergives the seconds to wait.