Withdraw an invite

DELETE/api/v1/invites/:id

Who can use this: Any signed-in accountAs Markdown

The invite stays on your list, as revoked, and no longer counts toward your limit of waiting invites. Only a pending invite can be withdrawn.

Parameters

Name	Where	What it is
id required	path	The invite's `id`, from List your invites.e.g. 12
user	query	The sender's address, to withdraw an invite someone else sent. Site admins only; anyone else gets 403.

Good to know

An invite that isn't yours, or isn't pending any more, answers 404.

curl -s -X DELETE 'https://api.mailmasker.org/api/v1/invites/12' \
  -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/invites/12',
    { Authorization => "Bearer $ENV{TOKEN}" })->result;
die $res->code, ' ', ($res->json('/error') // $res->message), "\n" unless $res->is_success;
print $res->body, "\n";

homelab-cli invite revoke 12

Response 200 OK

{ "ok": true }