File details

Full metadata for one file by file number.

GET /api/v1/files/{fileNo}

cURL

curl --request GET \
  --url 'https://upload.autorender.io/api/v1/files/2353377462' \
  --header 'Authorization: Bearer YOUR_API_KEY'

200

{
  "success": true,
  "data": {
    "id": "974628c2-9b55-4ce4-adf1-9b63edff6baa",
    "file_no": "2338045312",
    "name": "Screenshot from 2026-03-27 18-58-16.png",
    "url": "https://assets.autorender.io/FWA7PWC7LZ/Screenshot from 2026-03-27 18-58-16.png",
    "path": null,
    "format": "PNG",
    "dimensions": {
      "width": 1849,
      "height": 910
    },
    "size": 194141,
    "workspace": {
      "name": "api-testing",
      "workspace_no": "FWA7PWC7LZ"
    },
    "folder": null,
    "uploaded_by": "premmm2201",
    "uploaded_at": "2026-03-27T14:56:20.511Z",
    "asset_key": "2338045312",
    "asset_url": "https://assets.autorender.io/FWA7PWC7LZ/null",
    "extension": "image"
  }
}

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/2353377462' \
  --header 'Authorization: Bearer YOUR_API_KEY'

200

{
  "success": true,
  "data": {
    "id": "974628c2-9b55-4ce4-adf1-9b63edff6baa",
    "file_no": "2338045312",
    "name": "Screenshot from 2026-03-27 18-58-16.png",
    "url": "https://assets.autorender.io/FWA7PWC7LZ/Screenshot from 2026-03-27 18-58-16.png",
    "path": null,
    "format": "PNG",
    "dimensions": {
      "width": 1849,
      "height": 910
    },
    "size": 194141,
    "workspace": {
      "name": "api-testing",
      "workspace_no": "FWA7PWC7LZ"
    },
    "folder": null,
    "uploaded_by": "premmm2201",
    "uploaded_at": "2026-03-27T14:56:20.511Z",
    "asset_key": "2338045312",
    "asset_url": "https://assets.autorender.io/FWA7PWC7LZ/null",
    "extension": "image"
  }
}

Overview

Returns the full metadata for a single file, looked up by file_no (the same id used in delivery URLs and list results). The response is wrapped as { "success": true, "data": { ... } }.

Path parameters

Parameter	Description
fileNo	Numeric file identifier (e.g. 2353377462)

data object

Includes id, file_no, name, url, path, format, dimensions (width / height), size, workspace (name, workspace_no), folder, uploaded_by, uploaded_at, asset_key, asset_url, extension.

Next steps

Rename file

Change a file’s display name.

Delete file

Permanently remove a file from your workspace.

Authorizations

x-api-key · string · header · required

API key for public endpoints. Can also be provided via Authorization: Bearer

Path Parameters

fileNo · string · required

Response

200

application/json

File details

File details

success · enum<boolean> · required

Available options: true

data · object · required

Show child attributes