HOC SiteDocumentation

Files and assets

The website file library stores uploads in directories and serves them from a CDN. Three upload paths cover small files, large files, and existing URLs.

The library

Files belong to a website and optionally to a directory. Each file has an original name, a mime type, a size, and a public CDN URL. Deletes are soft, so a deleted file stops resolving without losing the record.

Uploading

Pick the path that fits the file:

  • Small files — post multipart/form-data to the files endpoint.
  • Large files — create_upload_url returns a 15-minute presigned PUT for up to 5 GB. Send the returned headers, upload the bytes, then call complete_upload. The server verifies size and content type before it inserts the row.
  • Existing URLs — import-url fetches a public HTTPS image, resizes it, and stores a WebP; from-url pulls a file that already lives on the site CDN.

Directories

Directories nest and can be renamed or moved. A directory must be empty before it can be deleted.

SVG

stamp_svg fetches a CDN SVG and returns markup with a data-svg-canvas-id, which is what the SVG canvas block and inline image props expect.