# FileListResponse

Standard paginated envelope plus a truncation flag.

``truncated`` is true when the enumeration ceiling
(``FILE_DISCOVERY_MAX_ITEMS``, or the internal byte ceiling) was reached, so
items past it are not reachable by paging. Narrow with ``type`` or search.

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 |
| --- | --- | --- | --- | --- |
| `page` | integer, nullable | no | Page number | default: `1` |
| `per_page` | integer, nullable | no | Number of items per page | default: `50` |
| `total` | integer, nullable | no | Total number of pages | default: `0` |
| `results` | array of [FileItem](https://dev-api.sheetgo.com/rest/reference/models/FileItem.md) | no | List of results |  |
| `truncated` | boolean | no | True when the listing was capped | 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)

---

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.