파일
파일 업로드
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