---
title: Files
description: "Files and directories store media and documents used by pages, objects, and email. Uploads are multipart on the REST API; MCP accepts base64 and converts to multipart."
---

Listing needs website access. Uploads and mutations need writable file access on the website.

# Files

List files and directories together, upload with multipart form data, move files between directories, or soft-delete them. System-managed favicon assets are excluded from listings.

List files and directories. Optional includeDeleted=true.

```
GET /api/v1/{locale}/{websiteId}/files
```

Move (PATCH directoryId) or soft-delete a file.

```
PATCH|DELETE /api/v1/{locale}/{websiteId}/files/{fileId}
```

```json
{
  "directoryId": "string | null"
}
```

MCP: list_files, upload_file, update_file, delete_file.