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

# client.files

> Method signatures, arguments, and return types for client.files API operations.

<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/client.ts](https://github.com/nottelabs/notte/blob/main/node-sdk/src/client.ts)

Generated file operations; use Files(sessionId) for local file IO helpers.

These operations use the configured client's authentication and transport. Signatures below preserve positional arguments, optional parameters, and return types. See the [OpenAPI schema](https://api.notte.cc/openapi.json) for HTTP request and response fields.

## delete

deleteSessionFile: /sessions/\{session\_id}/files/\{file\_id}. Returns the API response body.

```typescript theme={null}
client.files.delete(sessionId: DeleteSessionFileData["path"]["session_id"], fileId: DeleteSessionFileData["path"]["file_id"], requestOptions?: ResourceRequestOptions & { headers?: Omit<NonNullable<DeleteSessionFileData["headers"]>, "x-notte-api-key">; }): Promise<void>;
```

## download

downloadSessionFile: /sessions/\{session\_id}/files/\{file\_id}. Returns the API response body.

```typescript theme={null}
client.files.download(sessionId: DownloadSessionFileData["path"]["session_id"], fileId: DownloadSessionFileData["path"]["file_id"], requestOptions?: ResourceRequestOptions & { headers?: Omit<NonNullable<DownloadSessionFileData["headers"]>, "x-notte-api-key">; }): Promise<unknown>;
```

## list

listSessionFiles: /sessions/\{session\_id}/files. Returns the API response body.

```typescript theme={null}
client.files.list(sessionId: ListSessionFilesData["path"]["session_id"], query?: ListSessionFilesData["query"], requestOptions?: ResourceRequestOptions & { headers?: Omit<NonNullable<ListSessionFilesData["headers"]>, "x-notte-api-key">; }): Promise<SessionFilesPage>;
```

## upload

uploadSessionFile: /sessions/\{session\_id}/files. Returns the API response body.

```typescript theme={null}
client.files.upload(sessionId: UploadSessionFileData["path"]["session_id"], body: UploadSessionFileData["body"], requestOptions?: ResourceRequestOptions & { headers?: Omit<NonNullable<UploadSessionFileData["headers"]>, "x-notte-api-key">; }): Promise<SessionFile>;
```


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