Create a folder (mkdir) or import a file from a URL

POST

https://api.pibox.com/api/v2/folders/{folderId}/children

Send {name, type:"folder", ...} to create a folder, or {source_url, name} to import a file (returns 202 Accepted).

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

A single resource

Bodyapplication/json

🟢202Accepted

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.pibox.com/api/v2/folders//children' \
--header 'Content-Type: application/json' \
--data '{
    "name": "string",
    "type": "folder",
    "removal_protection": true,
    "task_load_protection": true
}'

Response Example

201 - Example 1

{
    "object": "string",
    "data": {
        "property1": "string",
        "property2": "string"
    },
    "property1": "string",
    "property2": "string"
}

Modified at 2026-08-05 12:46:23

List folder contents

Upload a file (streamed binary body)