Your account

Set your recovery address

POST/api/v1/account/recovery-email

Who can use this: Any signed-in accountAs Markdown

If you forget your password, the sign-in page sends a reset link to this address, so pick one outside this mail system. Without one, a reset by email isn't possible, though you can still change your password while signed in. Nothing is sent to check the address, so make sure it is right.

Parameters

Name	Where	What it is
recovery_email	body	The address to use. An empty string or null removes it, and so does leaving it out.e.g. personal@example.com

Good to know

Something that doesn't look like an address answers 400.

curl -s -X POST 'https://api.mailmasker.org/api/v1/account/recovery-email' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"recovery_email":"personal@example.com"}'

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

my $ua  = Mojo::UserAgent->new;
my $res = $ua->post('https://api.mailmasker.org/api/v1/account/recovery-email',
    { Authorization => "Bearer $ENV{TOKEN}" },
    json => { recovery_email => 'personal@example.com' })->result;
die $res->code, ' ', ($res->json('/error') // $res->message), "\n" unless $res->is_success;
print $res->body, "\n";

There's no homelab-cli command for this yet.

Response 200 OK

{ "ok": true, "recovery_email": "personal@example.com" }