Restore a file from Trash

POST/api/v1/drive/files/:id/restore

Who can use this: Any signed-in accountAs Markdown

The file goes back where it was. If its folder is in Trash too, that folder and any above it come back as well, so the file has somewhere to land; their other contents stay in Trash. Links you shared for it work again.

Parameters

Name	Where	What it is
id required	path	The file's id.e.g. 42

Good to know

A file that isn't in your Trash answers 404.

curl -s -X POST 'https://api.mailmasker.org/api/v1/drive/files/42/restore' \
  -H "Authorization: Bearer $TOKEN"

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

my $ua  = Mojo::UserAgent->new;
my $res = $ua->post('https://api.mailmasker.org/api/v1/drive/files/42/restore',
    { Authorization => "Bearer $ENV{TOKEN}" })->result;
die $res->code, ' ', ($res->json('/error') // $res->message), "\n" unless $res->is_success;
print $res->body, "\n";

homelab-cli drive restore 42

Response 200 OK

{ "ok": true }