Skip to main content
A download card — file icon, name, easy-to-read size, and a download button.
​
type
string
required
"file"
​
url
string
An https:// URL. Cannot be mixed with file_id.
​
file_id
string
An uploaded file. Required when there is no url.
​
name
string
1–255 characters. Optional — leave it out with url and we take the filename from the URL, so …/Q2%20report.pdf shows as Q2 report.pdf. With file_id, we use the stored name.
​
size_bytes
integer
Filled in for you with file_id.
​
mime_type
string
Filled in for you with file_id. Picks the icon.
See Sending files for the upload flow.