Skip to main content
{
	"content_type": "image/jpeg",
	"filename": "document.pdf",
	"id": "file_xxxxxxxxxxxxx",
	"size": "123.45",
	"upload_status": "pending",
	"url": "<string>",
	"visibility": "public"
}
​
content_type
string | null
required
The MIME type of the uploaded file (e.g., image/jpeg, video/mp4, audio/mpeg).Example: image/jpeg
​
filename
string | null
required
The original filename of the uploaded file, including its file extension.Example: document.pdf
​
id
string
required
The unique identifier for the file.Example: file_xxxxxxxxxxxxx
​
size
string | null
required
The file size in bytes. Null if the file has not finished uploading.Example: 123.45
​
upload_status
UploadStatuses
required
The current upload status of the file (e.g., pending, ready).Available options: pending, processing, ready, failed
​
url
string | null
required
The URL for accessing the file. For public files, this is a permanent CDN URL. For private files, this is a signed URL that expires. Null if the file has not finished uploading.
​
visibility
FileVisibility
required
Whether the file is publicly accessible or requires authentication.Available options: public, private