檔案
上傳檔案
POST/v1/files
列出檔案
GET/v1/files
下載檔案
GET/v1/files/{file_id}/content
取得檔案中繼資料
GET/v1/files/{file_id}
刪除檔案
DELETE/v1/files/{file_id}
Models
DeletedFile object{ id, type }
DeletedFile object{ id, type }
id: string
ID of the deleted file.
type: optional "file_deleted"Deleted object type.
type: optional "file_deleted"
Deleted object type.
For file deletion, this is always "file_deleted".
defaultfile_deleted
FileMetadata object{ id, created_at, filename, 5 more }
FileMetadata object{ id, created_at, filename, 5 more }
id: stringUnique object identifier.
id: string
Unique object identifier.
The format and length of IDs may change over time.
created_at: stringRFC 3339 datetime string representing when the file was created.
created_at: string
RFC 3339 datetime string representing when the file was created.
formatdate-time
filename: stringOriginal filename of the uploaded file.
filename: string
Original filename of the uploaded file.
maxLength500
minLength1
mime_type: stringMIME type of the file.
mime_type: string
MIME type of the file.
maxLength255
minLength1
size_bytes: numberSize of the file in bytes.
size_bytes: number
Size of the file in bytes.
minimum0
type: "file"Object type.
type: "file"
Object type.
For files, this is always "file".
downloadable: optional booleanWhether the file can be downloaded.
downloadable: optional boolean
Whether the file can be downloaded.
defaultfalse
expires_at: optional string or nullRFC 3339 datetime string representing when the file will expire and become unavailable for download. Null if the file does not expire. For files uploaded with expires_in_seconds, this is the upload time plus that value.
expires_at: optional string or null
RFC 3339 datetime string representing when the file will expire and become unavailable for download. Null if the file does not expire. For files uploaded with expires_in_seconds, this is the upload time plus that value.
formatdate-time