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"
}
File Management
List files
Paginated files with sort, folder filter, and meta pagination.
GET
/
api
/
v1
/
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
Returnsfiles (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
Query Parameters
Was this page helpful?