Drive

Create a folder

POST/api/v1/drive/folders

Who can use this: Any signed-in accountAs Markdown

Folders nest as deep as you like, but two folders in the same place can't have the same name.

Parameters

Name	Where	What it is
name required	body	The new folder's name.e.g. Receipts
parent_folder_id	body	The folder to make it in. Leave it out, or send null, for the top level.e.g. 7

Good to know

A missing name answers 400.
A folder of that name already in the same place answers 409, and so does a parent folder that isn't yours.

curl -s -X POST 'https://api.mailmasker.org/api/v1/drive/folders' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"name":"Receipts","parent_folder_id":7}'

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

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

homelab-cli drive mkdir Receipts --parent 7

Response 201 Created

{ "id": 9, "name": "Receipts", "parent_folder_id": 7 }