Take a role from an account

DELETE/api/v1/admin/users/:id/roles/:role

Who can use this: Site adminsAs Markdown

The account loses what the role allowed, unless another of its roles allows the same. Each removal is recorded in the audit log.

Parameters

Name	Where	What it is
id required	path	The account's number, from the account list.e.g. 7
role required	path	The role's name.e.g. auditor

Good to know

It answers ok even when the account didn't have the role.
Nothing stops you taking site_admin from your own account, so take care.

curl -s -X DELETE 'https://api.mailmasker.org/api/v1/admin/users/7/roles/auditor' \
  -H "Authorization: Bearer $TOKEN"

use Mojo::Base -strict;
use Mojo::UserAgent;

my $ua  = Mojo::UserAgent->new;
my $res = $ua->delete('https://api.mailmasker.org/api/v1/admin/users/7/roles/auditor',
    { Authorization => "Bearer $ENV{TOKEN}" })->result;
die $res->code, ' ', ($res->json('/error') // $res->message), "\n" unless $res->is_success;
print $res->body, "\n";

homelab-cli admin users revoke-role 7 auditor

Response 200 OK

{ "ok": true }