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

# list

<Tip>
  Read [the Notte skill](https://notte.cc/skill.md) and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.
</Tip>

[Source: node-sdk/src/files.ts](https://github.com/nottelabs/notte/blob/main/node-sdk/src/files.ts)

List the session's files.

```typescript theme={null}
RemoteFileStorage.list(options?: FileListOptions): Promise<SessionFilesPage>;
```

## Parameters

<ParamField body="options" type={"FileListOptions"}>
  Optional source filter and pagination. Defaults to all sources, limit 100, and offset 0.

  Default:

  ```typescript theme={null}
  {}
  ```
</ParamField>

## Returns

```typescript theme={null}
Promise<SessionFilesPage>
```

One page of non-expired files and the total count; pagination is not automatic.

## Raises

* NotteAPIError if the storage API request fails.
* InvalidRequestError if storage has not been bound to a session.

## Example

```typescript theme={null}
const downloads = await storage.list({ source: 'session_download', limit: 1000 });
```

## Related types

* [FileListOptions](/typescript-sdk-reference/types/filelistoptions)
* [SessionFilesPage](/typescript-sdk-reference/types/sessionfilespage)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.