File object used by image, video, pdf, file and audio blocks, and by files property values.
| Property | Type | Description |
|---|---|---|
| caption | Caption of the media block. | |
| external | External_Object | External file URL, when type is external. |
| file | File_Object | Notion-hosted file, when type is file. |
| file_upload | Id_Reference | Uploaded file, when type is file_upload. |
| name | String | Name of the file (file blocks and files properties). |
| type | String | file (Notion-hosted), external or file_upload (request only). |