Create Media Folder

POST

/openapi/v2.0/media/api/v1/workspaces/{workspace_id}/files

Create a folder (file_type=1) in media library to organize media hierarchy. > This API supports multiple operation modes: returns {id} when creating folder; returns paginated file array when querying file list.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "name": "Aerial-2026-06",
    "parent_id": 0,
    "file_type": 1,
    "automatic_rename": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/media/api/v1/workspaces//files' \
--header 'X-Project-Uuid;' \
--header 'X-Request-Id;' \
--header 'X-Request-Id;' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Aerial-2026-06",
    "parent_id": 0,
    "file_type": 1,
    "automatic_rename": true
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "code": 0,
    "message": "success",
    "data": {
        "id": 4521
    }
}

🟠401

Modified at 2026-06-15 13:36:31

Batch Delete Media Files - to Recycle Bin

Get Media File List