> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ListFilesRequest

## Fields

| Field         | Type                                                                  | Required             | Description                                                                                                  | Example                                                      |
| ------------- | --------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------ |
| `Limit`       | `*int64`                                                              | :heavy\_minus\_sign: | Maximum number of files to return (1–1000).                                                                  | 100                                                          |
| `Cursor`      | `*string`                                                             | :heavy\_minus\_sign: | Opaque pagination cursor from a previous response.                                                           | eyJjdXJzb3IiOiJvcl9maWxlXzAxMUNOaGE4aUNKY1Uxd1hOUjZxNFY4dyJ9 |
| `WorkspaceID` | `*string`                                                             | :heavy\_minus\_sign: | Workspace to scope the request to. Defaults to the caller’s default workspace.                               | a103d8b6-42f0-4e50-9a3c-bf41e2c3c1a7                         |
| `Provider`    | [\*components.FileProvider](../../models/components/fileprovider.mdx) | :heavy\_minus\_sign: | Store or read this file on the named provider using your own API key for it. Omit to use OpenRouter storage. | openai                                                       |
| `After`       | `*string`                                                             | :heavy\_minus\_sign: | OpenAI-style forward cursor: the id to list after.                                                           | or\_file\_011CNha8iCJcU1wXNR6q4V8w                           |
| `AfterID`     | `*string`                                                             | :heavy\_minus\_sign: | Anthropic-style forward cursor: the id to list after.                                                        | or\_file\_011CNha8iCJcU1wXNR6q4V8w                           |
| `BeforeID`    | `*string`                                                             | :heavy\_minus\_sign: | Anthropic-style reverse cursor. Not supported by OpenRouter storage.                                         | or\_file\_011CNha8iCJcU1wXNR6q4V8w                           |
| `Order`       | [\*operations.Order](../../models/operations/order.mdx)               | :heavy\_minus\_sign: | Sort direction. Only `asc` is supported by OpenRouter storage.                                               | asc                                                          |