List files

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'

{
  "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
  }
}

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

GET

api

files

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'

{
  "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
  }
}

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

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 --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'

{
  "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
  }
}

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

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

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

Files list

files

object[]

required

Show child attributes

Get started

Endpoints

Overview

Query parameters

Response fields

Next steps

File details

List folders

Authorizations

Query Parameters

Response

​Overview

​Query parameters

​Response fields

​Next steps

File details

List folders

Authorizations

Query Parameters

Response

Overview

Query parameters

Response fields

Next steps