Revoke a system role from a user
DELETE
/api/v1/system-roles/revoke
const url = 'http://localhost:3000/api/v1/system-roles/revoke';const options = { method: 'DELETE', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"userId":"example","role":"SUPERUSER","reason":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request DELETE \ --url http://localhost:3000/api/v1/system-roles/revoke \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "userId": "example", "role": "SUPERUSER", "reason": "example" }'Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ” Media type application/json
object
userId
required
User ID to revoke the role from
string
role
required
Role type to revoke
string
reason
Reason for revoking the role
string
Responses
Section titled “ Responses ”Role revoked
Cannot revoke own superuser role or last superuser
Only superusers can revoke roles
User or role not found