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 Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/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