> ## 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

## Example Usage

```typescript theme={null}
import { ListFilesRequest } from "@openrouter/sdk/models/operations";

let value: ListFilesRequest = {};
```

## Fields

| Field           | Type                                                  | Required             | Description                                                                                                                                                 | Example                                                      |
| --------------- | ----------------------------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| `httpReferer`   | *string*                                              | :heavy\_minus\_sign: | The app identifier should be your app's URL and is used as the primary identifier for rankings.<br />This is used to track API usage per application.<br /> |                                                              |
| `appTitle`      | *string*                                              | :heavy\_minus\_sign: | The app display name allows you to customize how your app appears in OpenRouter's dashboard.<br />                                                          |                                                              |
| `appCategories` | *string*                                              | :heavy\_minus\_sign: | Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.<br />                                                 |                                                              |
| `limit`         | *number*                                              | :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`      | [models.FileProvider](../../models/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                                                          |