FileUploads
Retrieve Notion file upload metadata and status information with creation and expiry details.
Columns
| Name | Type | ReadOnly | References | Description |
| Id [KEY] | String | True |
Unique file upload identifier | |
| Object | String | True |
Always 'file_upload' | |
| Status | String | True |
Upload status The allowed values are pending, uploaded, expired, failed. | |
| Filename | String | False |
Name of the uploaded file; must include a file extension | |
| ContentType | String | False |
MIME type of the file | |
| Mode | String | False |
Upload mode: single_part (default, files up to 20MB), multi_part (files over 20MB), or external_url (import from a public HTTPS URL) The allowed values are single_part, multi_part, external_url. | |
| NumberOfParts | Integer | False |
Number of parts when Mode is multi_part; must match the actual number of parts uploaded | |
| ExternalUrl | String | False |
Publicly accessible HTTPS URL of the file to import when Mode is external_url | |
| ContentLength | Integer | True |
Size of the file in bytes | |
| CreatedTime | Datetime | True |
Upload creation timestamp | |
| CreatedById | String | True |
Users.Id |
Creator user ID |
| CreatedByType | String | True |
Creator user type | |
| LastEditedTime | Datetime | True |
Last modification timestamp | |
| ExpiryTime | Datetime | True |
Upload expiration timestamp | |
| Archived | Boolean | True |
Archive status | |
| RequestId | String | True |
Associated request identifier |