Create Folder

POSThttps://api.konpro.ai/v1/folders/create

Create a new folder within your account to organize assets, projects, or other content. You can specify the folder's name, project type, and parent folder to create nested structures.

Request History

TIME	STATUS	USER AGENT
Make a request to see history.

0 Requests This Month

cURL Request

shell

curl --request POST \
--url https://api.konpro.ai/v1/folders/create \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-api-key: <your-api-key>' \
--data '{
  "name": "Project Media",
  "project_type": "video",
  "parent_id": "folder123"
}'

Request Body Parameters

Field	Type	Description
name	string	Name of the folder to create (default: "test")
project_type	string	Type of projects the folder is associated with. Options include: video_translate, instant_avatar, video, asset, brand_kit, mixed
parent_id	string	Optional ID of the parent folder to nest this folder under

Response

Response Structure

Field	Type	Description
folder_id	string	Unique identifier of the created folder
name	string	Name of the created folder
project_type	string	Project type associated with the folder
parent_id	string	ID of the parent folder (null for root folders)
created_at	datetime	Timestamp of folder creation

Sample Response

json

{
  "folder_id": "folder_789",
  "name": "Project Media",
  "project_type": "video",
  "parent_id": "folder123",
  "created_at": "2024-01-15T12:00:00Z"
}

Notes

Requires API authentication.
Folder name defaults to "test" if not provided.
Project type determines folder categorization.
Parent ID creates nested folder structure.
Folder names must be unique within the same parent.
Project types: video_translate, instant_avatar, video, asset, brand_kit, mixed.
Root folders have parent_id set to null.
Refer to Error Responses for error information.

Example Usage

Shell

curl --request POST \
--url https://api.konpro.ai/v1/folders/create \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-api-key: <your-api-key>' \
--data '{
  "name": "Project Media",
  "project_type": "video",
  "parent_id": "folder123"
}'

LANGUAGE

CREDENTIALS

Header

HEADER

RESPONSE

Examples

Choose an example:

application/json

200 - Success

401 - Unauthorized

List Folders Update Folder