> ## Documentation Index
> Fetch the complete documentation index at: https://autorender.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# File details
> Full metadata for one file by file number.
```bash cURL theme={null}
curl --request GET \
--url 'https://upload.autorender.io/api/v1/files/2353377462' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
```json 200 theme={null}
{
"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"
}
}
```
```json 404 theme={null}
{
"error": "File not found"
}
```
```json 500 theme={null}
{
"error": "Failed to get file details"
}
```
## 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
Change a file's display name.
Permanently remove a file from your workspace.
## OpenAPI
````yaml api-reference/openapi.json GET /api/v1/files/{fileNo}
openapi: 3.0.0
info:
title: AutoRender Public API
description: >-
REST API for uploading, managing, and serving media assets. All endpoints
require an API key via the x-api-key header or Authorization: Bearer .
version: 1.0.0
contact:
name: AutoRender Support
email: support@autorender.io
servers:
- url: https://app-api.autorender.io
description: Production server
security:
- apiKey: []
tags:
- name: Uploads
description: Upload endpoints (API key required)
- name: Files
description: File management endpoints (API key required)
- name: Folders
description: Folder management endpoints (API key required)
paths:
/api/v1/files/{fileNo}:
get:
tags:
- Files
summary: Get file details
operationId: getFile
parameters:
- schema:
type: string
in: path
name: fileNo
required: true
responses:
'200':
description: File details
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
enum:
- true
data:
type: object
properties:
id:
type: string
file_no:
type: string
name:
type: string
path:
type: string
url:
type: string
width:
nullable: true
type: integer
minimum: -9007199254740991
maximum: 9007199254740991
height:
nullable: true
type: integer
minimum: -9007199254740991
maximum: 9007199254740991
size:
type: integer
minimum: -9007199254740991
maximum: 9007199254740991
format:
nullable: true
type: string
mime_type:
type: string
tags:
type: array
items:
type: string
metadata:
nullable: true
type: object
additionalProperties:
x-stainless-any: true
folder_no:
nullable: true
type: string
folder_name:
nullable: true
type: string
source:
type: string
created_at:
type: string
format: date-time
pattern: >-
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
updated_at:
nullable: true
type: string
format: date-time
pattern: >-
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
required:
- id
- file_no
- name
- path
- url
- width
- height
- size
- format
- mime_type
- tags
- metadata
- folder_no
- folder_name
- source
- created_at
- updated_at
additionalProperties: false
required:
- success
- data
additionalProperties: false
description: File details
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
required:
- error
- message
additionalProperties: false
description: Unauthorized
'404':
description: File not found
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
required:
- code
- message
additionalProperties: false
required:
- error
additionalProperties: false
description: File not found
'429':
description: Rate limit exceeded
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
retryAfterSeconds:
type: number
required:
- error
- message
additionalProperties: false
description: Rate limit exceeded
'503':
description: Limit service unavailable
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
additionalProperties: false
description: Limit service unavailable
security:
- apiKey: []
components:
securitySchemes:
apiKey:
type: apiKey
name: x-api-key
in: header
description: >-
API key for public endpoints. Can also be provided via Authorization:
Bearer
````