Skip to main content
GET
Get a single CDN file

Authorizations

Authorization
string
header
required

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

Query Parameters

fileName
string
required

Full file path (e.g. "folder/file.png" or "file.png"). Must belong to the authenticated user.

Response

File metadata

id
string<uuid>
user_id
string<uuid>
filename
string
Example:

"images/logo.png"

size
integer<int64>

File size in KB

mime_type
string
Example:

"image/png"

created_at
string<date-time>
expire_at
string<date-time>
status
enum<string>

pending while a large file upload has not been finalized (no url yet), ready otherwise

Available options:
pending,
ready
url
string

Full CDN URL to access the file

Example:

"https://cdn.example.com/{user_id}/{filename}"