Create folder

Create a folder under an optional parent.

POST /api/v1/folders

cURL

curl --request POST \
  --url 'https://upload.autorender.io/api/v1/folders' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "demo2",
  "parent_folder_no": "sD1LvqoDzG"
}'

200

{
  "name": "demo2",
  "folder_no": "dejfjijf"
}

Key type: requires a private key. A public key returns 403 here, because it may only upload — see key types and scope. Call this from your server, never from browser code.

cURL

curl --request POST \
  --url 'https://upload.autorender.io/api/v1/folders' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "demo2",
  "parent_folder_no": "sD1LvqoDzG"
}'

200

{
  "name": "demo2",
  "folder_no": "dejfjijf"
}

Overview

Creates a folder in your workspace. Send name, and optionally parent_folder_no to nest it under an existing folder.

Request body

Field	Type	Required	Description
name	string	Yes	Folder name
parent_folder_no	string	No	Parent folder number; omit for root

Response

A short payload with the name and folder_no of the created folder.

Next steps

Rename folder

Change a folder’s name.

List folders

Browse the folders in your workspace.

Authorizations

x-api-key · string · header · required

API key for public endpoints. Can also be provided via Authorization: Bearer

Body

application/json

name · string · required

Folder name without slashes

Required string length: 1 - 100

parent_folder_no · string

Parent folder number

Response

201

application/json

Folder created

Folder created

id · string<uuid> · required

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

folder_no · string · required

name · string · required

path · string · required

parent_folder_no · string | null · required

created_at · string<date-time> · required

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

updated_at · string<date-time> | null · required

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$