Files
Upload File
List Files
Download File
Get File Metadata
Delete File
Models
DeletedFile object{ type: "file_deleted", id }
type: optional "file_deleted"Deleted object type.
Deleted object type.
For file deletion, this is always "file_deleted".
ID of the deleted file.
FileExpiredErrorDetails object{ error_code }The file's expires_at has passed, so its content is no longer available.
The file's expires_at has passed, so its content is no longer available.
FileMetadata object{ type: "file", id, created_at, 5 more }
type: "file"Object type.
Object type.
For files, this is always "file".
id: stringUnique object identifier.
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.
RFC 3339 datetime string representing when the file was created.
filename: stringOriginal filename of the uploaded file.
Original filename of the uploaded file.
mime_type: stringMIME type of the file.
MIME type of the file.
size_bytes: numberSize of the file in bytes.
Size of the file in bytes.
downloadable: optional booleanWhether the file can be downloaded.
Whether the file can be downloaded.
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.
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.
FileNotDownloadableErrorDetails object{ error_code }The file has downloadable: false. Only files generated by a tool, such as the code execution tool, can be downloaded.
The file has downloadable: false. Only files generated by a tool, such as the code execution tool, can be downloaded.
StorageQuotaExceededErrorDetails object{ error_code }The organization's file storage quota is exhausted. Delete files to free up space, then retry the upload.
The organization's file storage quota is exhausted. Delete files to free up space, then retry the upload.