HOC Site

Files

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.

List files and directories together, upload with multipart form data, move files between directories, or soft-delete them.

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

Operations

List files and directories. Optional includeDeleted=true.

GET /api/v1/en/{websiteId}/files

Upload a file. Multipart field name: file. Optional directory_id.

POST /api/v1/en/{websiteId}/files

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

PATCH|DELETE /api/v1/en/{websiteId}/files/{fileId}

Use the following request body shape:

{
  "directoryId": "string | null"
}

MCP

MCP: list_files, upload_file, update_file, delete_file.

Topics