# FileItem

One file or folder, normalized across all four storage providers.

Type: object

Fields typed as another model are documented on that model's page; fetch it before filling the field.

| Field | Type | Required | Description | Allowed values / default / constraints |
| --- | --- | --- | --- | --- |
| `id` | string | yes | Provider id. Usable as an automation source/destination id, and as `parent` when browsing. |  |
| `name` | string, nullable | no | Display name |  |
| `provider` | string | yes | drive \| onedrive \| sharepoint \| dropbox |  |
| `file_type` | [FileTypeFilter](https://dev-api.sheetgo.com/rest/reference/models/FileTypeFilter.md), nullable | no | Automation file type; null when the item is outside the supported set |  |
| `mime_type` | string, nullable | no | Provider mimetype |  |
| `is_folder` | boolean | no | True when the item can be used as a `parent` | default: `false` |
| `parent_id` | string, nullable | no | Containing folder id, when the provider reports one |  |
| `size` | integer, nullable | no | Size in bytes; null or 0 for folders and for providers that omit it |  |
| `created_at` | string, nullable | no | ISO-8601 creation time as reported by the provider |  |
| `modified_at` | string, nullable | no | ISO-8601 last-modified time as reported by the provider |  |
| `web_url` | string, nullable | no | Link to open the item in the provider UI; null when unavailable |  |
| `kind` | [ItemKind](https://dev-api.sheetgo.com/rest/reference/models/ItemKind.md) | no | file \| folder \| site \| shared_drive \| virtual | default: `"file"` |
| `supports_structure` | boolean | no | True when `GET /rest/beta/files/{provider}/{file_id}/structure` can describe this item (any spreadsheet: Google Sheets, Excel, CSV, TSV). Not a claim about reading its values. | default: `false` |

## Used by

- [GET /rest/beta/files/{provider}](https://dev-api.sheetgo.com/rest/reference/files.md#get-rest-beta-files-provider)
- [GET /rest/beta/files/{provider}/roots](https://dev-api.sheetgo.com/rest/reference/files.md#get-rest-beta-files-provider-roots)
- [GET /rest/beta/files/{provider}/search](https://dev-api.sheetgo.com/rest/reference/files.md#get-rest-beta-files-provider-search)
- [GET /rest/beta/files/{provider}/{file_id}](https://dev-api.sheetgo.com/rest/reference/files.md#get-rest-beta-files-provider-file-id)
- [FileListResponse](https://dev-api.sheetgo.com/rest/reference/models/FileListResponse.md)

---

More: start page https://dev-api.sheetgo.com/rest/reference.md, everything in one file https://dev-api.sheetgo.com/rest/llms-full.txt, OpenAPI https://dev-api.sheetgo.com/rest/openapi.json.