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
    }
  ]
}

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
    }
  ]
}

Overview

Returns folders: each row has folder_no, name, created_at, total_items, and total_size (bytes under that folder).

Query parameters

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

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

parent_folder_no · string

Only return direct children of this folder (folder number)

Example:

"sD1LvqoDzG"

Response

200

application/json

Folder list

folders · object[]

Show child attributes