List files

Paginated files with sort, folder filter, and meta pagination.

GET /api/v1/files

cURL

curl --request GET \
  --url 'https://upload.autorender.io/api/v1/files?page=1&limit=20&sort_field=file_size&sort_order=desc&folder_no=BGbQHg5UtW' \
  --header 'Authorization: Bearer YOUR_API_KEY'

200

{
  "files": [
    {
      "file_no": "2353377462",
      "name": "ar-juice.jpg",
      "thumbanil": "https://assets.autorender.io/FWA7PWC7LZ/h_320,w_320,c_center/ar-juice.jpg",
      "url": "https://assets.autorender.io/FWA7PWC7LZ/ar-juice.jpg",
      "file_size": 1278975,
      "format": "jpg",
      "width": 3788,
      "height": 5869,
      "created_at": "2026-03-27T14:58:53.795Z",
      "workspace_no": "FWA7PWC7LZ",
      "path": "ar-juice.jpg",
      "extension": "image"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 2,
    "hasNext": false,
    "hasPrev": false
  }
}

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 GET \
  --url 'https://upload.autorender.io/api/v1/files?page=1&limit=20&sort_field=file_size&sort_order=desc&folder_no=BGbQHg5UtW' \
  --header 'Authorization: Bearer YOUR_API_KEY'

200

{
  "files": [
    {
      "file_no": "2353377462",
      "name": "ar-juice.jpg",
      "thumbanil": "https://assets.autorender.io/FWA7PWC7LZ/h_320,w_320,c_center/ar-juice.jpg",
      "url": "https://assets.autorender.io/FWA7PWC7LZ/ar-juice.jpg",
      "file_size": 1278975,
      "format": "jpg",
      "width": 3788,
      "height": 5869,
      "created_at": "2026-03-27T14:58:53.795Z",
      "workspace_no": "FWA7PWC7LZ",
      "path": "ar-juice.jpg",
      "extension": "image"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 2,
    "hasNext": false,
    "hasPrev": false
  }
}

Overview

Returns files (lightweight rows for listing) alongside meta pagination (page, limit, total, hasNext, hasPrev). Order the results with sort_field and sort_order, and scope them to one folder with folder_no.

The API returns each file’s thumbnail URL under the key thumbanil — a known misspelling. Read it exactly as shown.

Query parameters

Parameter	Type	Description
page	integer	Page number (default 1)
limit	integer	Page size (e.g. 20)
sort_field	string	One of: file_size, name, created_at, updated_at
sort_order	string	asc or desc
folder_no	string	Only files in this folder
name	string	Filename filter (partial), if supported
path	string	Path filter, if supported
tags	string	Comma-separated tags, if supported

Response fields

files[]: file_no, name, thumbanil, url, file_size, format, width, height, created_at, workspace_no, path, extension

meta: page, limit, total, hasNext, hasPrev

Next steps

File details

Fetch the full metadata for one file by its file number.

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

Query Parameters

folder_no · string

Filter by folder number

search · string

Partial name match (case-insensitive)

page · integer · default: 1

Required range: 1 <= x <= 9007199254740991

limit · integer · default: 20

Required range: 1 <= x <= 100

sort · enum<string> · default: created_at_desc

Available options: name_asc, name_desc, size_asc, size_desc, created_at_asc, created_at_desc

Response

200

application/json

Files list

Files list

files · object[] · required

Show child attributes

meta · object · required

Show child attributes