Create Directories

Creates one or more directories recursively.

The endpoint automatically creates all missing parent directories.

If a directory already exists, the operation succeeds silently.

Required Scope

file.create

Endpoint

POST /api/mkdir

Example Request (HTTPie)

http POST https://webN.ftpgrid.com/api/mkdir \
    Authorization:"Bearer YOUR_TOKEN" \
    Filelist[]="/documents/projects" \
    Filelist[]="/documents/projects/archive/2026"

Raw JSON Body

{
    "Filelist": ["/documents/projects", "/documents/projects/archive/2026"]
}

Request Parameters

Parameter	Type	Description
Filelist[]	array	Array of directory paths to create

Example Response

{
    "rslt": "OK"
}

Notes

• Directory creation is recursive
• Missing parent directories are created automatically
• Existing directories do not cause errors
• Multiple directories may be created in a single request
• Paths are UNIX-style paths
• Paths may contain spaces and UTF-8 characters
• Paths are automatically sanitized and normalized
• Invalid or unsafe paths are rejected
• Directories become available immediately after creation
• Metadata propagation may be eventually consistent depending on operation type