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://dev.autorender.io/FWA7PWC7LZ/h_320,w_320,c_center/ar-juice.jpg",
      "url": "https://dev.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
  }
}

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://dev.autorender.io/FWA7PWC7LZ/h_320,w_320,c_center/ar-juice.jpg",
      "url": "https://dev.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) and meta pagination (page, limit, total, hasNext, hasPrev). Use sort_field + sort_order for ordering, and folder_no to scope to a folder.

List items include thumbanil exactly as the API returns it today (thumbnail URL).

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

Authorizations

Authorization · string · header · required

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

Query Parameters

page · integer · default: 1

Page number (1-based)

limit · integer · default: 20

Items per page

sort_field · enum<string>

Field to sort by

Available options: file_size, name, created_at, updated_at

sort_order · enum<string> · default: desc

Sort direction

Available options: asc, desc

folder_no · string

Restrict results to files in this folder (folder number)

name · string

Filter by filename (partial match, if supported)

path · string

Filter by path prefix (if supported)

tags · string

Comma-separated tags (if supported)

Response

200

application/json

List of files and pagination meta

files · object[] · required

Show child attributes

meta · object · required

Show child attributes