Drive

Combine files into one

POST/api/v1/drive/append-jobs

Who can use this: Any signed-in accountAs Markdown

For putting a file back together from its pieces, such as backup.iso.001, backup.iso.002 and so on. The work happens in the background, so the answer is a job id to follow with See how a combine is going. The pieces are kept, and the new file lands next to the first piece unless you say otherwise.

Parameters

Name	Where	What it is
file_ids required	body	At least two of your file ids, in the order their bytes should go.e.g. [41,42,43]
output_name	body	The new file's name. Left out, it is the first piece's name without its piece number, so backup.iso.001 gives backup.iso. e.g. backup.iso
folder_id	body	The folder to put the new file in. Left out, it goes in the first piece's folder.

Good to know

Every piece must be one of your files and not in Trash. If any isn't, nothing starts and the answer is 400.
The new file counts against your storage limit on top of the pieces; if it won't fit, the answer is 413.

curl -s -X POST 'https://api.mailmasker.org/api/v1/drive/append-jobs' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"file_ids":[41,42,43],"output_name":"backup.iso"}'

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

my $ua  = Mojo::UserAgent->new;
my $res = $ua->post('https://api.mailmasker.org/api/v1/drive/append-jobs',
    { Authorization => "Bearer $ENV{TOKEN}" },
    json => { file_ids => [41, 42, 43], output_name => 'backup.iso' })->result;
die $res->code, ' ', ($res->json('/error') // $res->message), "\n" unless $res->is_success;
print $res->body, "\n";

homelab-cli drive append 41 42 43 --output backup.iso

Response 202 Accepted

{ "id": 12, "output_name": "backup.iso" }