Take a permission from a role

DELETE/api/v1/admin/roles/:role/permissions/:permission

Who can use this: Site adminsAs Markdown

Every account with the role loses the permission, unless another of its roles carries it too.

Parameters

Name	Where	What it is
role required	path	The role's name.e.g. auditor
permission required	path	The permission's name.e.g. audit.view

Good to know

It answers ok even when the role didn't have the permission, or either name is unknown.

curl -s -X DELETE 'https://api.mailmasker.org/api/v1/admin/roles/auditor/permissions/audit.view' \
  -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/roles/auditor/permissions/audit.view',
    { 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 roles revoke-permission auditor audit.view

Response 200 OK

{ "ok": true }