List folders

List folders, optionally under a parent folder.

GET /api/v1/folders

cURL

curl --request GET \
  --url 'https://upload.autorender.io/api/v1/folders?parent_folder_no=sD1LvqoDzG' \
  --header 'Authorization: Bearer YOUR_API_KEY'

200

{
  "folders": [
    {
      "folder_no": "4bu71SsGmM",
      "name": "demo",
      "created_at": "2026-03-27T15:59:36.104Z",
      "total_items": 0,
      "total_size": 0
    },
    {
      "folder_no": "53855hxPoq",
      "name": "demo2",
      "created_at": "2026-03-27T15:21:40.693Z",
      "total_items": 3,
      "total_size": 1166070
    }
  ]
}

{
  "success": false,
  "error": "Unauthorized",
  "message": "Invalid or missing API key"
}

cURL

curl --request GET \
  --url 'https://upload.autorender.io/api/v1/folders?parent_folder_no=sD1LvqoDzG' \
  --header 'Authorization: Bearer YOUR_API_KEY'

200

{
  "folders": [
    {
      "folder_no": "4bu71SsGmM",
      "name": "demo",
      "created_at": "2026-03-27T15:59:36.104Z",
      "total_items": 0,
      "total_size": 0
    },
    {
      "folder_no": "53855hxPoq",
      "name": "demo2",
      "created_at": "2026-03-27T15:21:40.693Z",
      "total_items": 3,
      "total_size": 1166070
    }
  ]
}

{
  "success": false,
  "error": "Unauthorized",
  "message": "Invalid or missing API key"
}

Overview

Returns folders. Each row carries folder_no, name, created_at, total_items, and total_size (the total bytes under that folder).

Query parameters

Parameter	Type	Description
parent_folder_no	string	List only the direct children of this folder. Omit it for root-level folders.

Next steps

Create folder

Add a new folder, optionally nested under a parent.

List files

Page through the files inside a folder.

Authorizations

x-api-key · string · header · required

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

Query Parameters

parent_folder_no · string

Filter by parent folder number

search · string

Partial name match (case-insensitive)

sort · enum<string> · default: created_at_desc

Available options: name_asc, name_desc, created_at_asc, created_at_desc

Response

200

application/json

List of folders

List of folders

folders · object[] · required

Show child attributes