Files
Models
deleted_file: 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.
file_expired_error_details: object{ error_code }
file_metadata: 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.
Whether the file can be downloaded.
expires_at: optional stringRFC 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.
file_not_downloadable_error_details: object{ error_code }
storage_quota_exceeded_error_details: object{ error_code }
Errors
"file_not_downloadable"HTTP status 400The 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.
details: object{ error_code }
"storage_quota_exceeded"HTTP status 400The 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.
details: object{ error_code }
"file_expired"HTTP status 404The 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.