Kanorio
Kanorio Developers

Cloud infrastructure

Media & Assets

The media library with public and protected files, image variants and placeholders, video streaming and processing status.

Available

Every image, video and file a site uses lives in its media library. Content refers to files by asset id, and responses resolve ids to URLs, sizes, alt text and placeholders.

Core objects

  • Assets. A file with its visibility, tags, alt text, focal point and processing status. Public files are served from a CDN. Protected files, such as course videos, are only reachable through short-lived signed URLs.
  • Image variants. Resized versions on demand, plus a tiny blurred placeholder for every image.
  • Video streaming. Videos are converted to adaptive streams, with signed segments for protected videos.

How the APIs fit

  • Upload by URL or file, request direct upload URLs for large files, create upload links for clients, and import stock photos with the Management API.
  • Every Content Delivery API response that references media includes the assets map.
  • <kanorio-media> and <kanorio-lightbox> play media and show images.
  • Webhooks report when an asset is ready or failed to process.

What the APIs expose

  • Public & protected media, responsive images, LQIP placeholders, lightbox & HLS video streamingAvailable
    API
    Management API media.* (images and files with visibility public/protected, tags and processing; protected files have no public URL and need only media:manage; media.get renditions[] for public files incl. hls and thumbnails once a video is transcoded, streaming none/processing/partial/ready; media.update focus, alt text, tags, visibility switch and streaming: true to transcode now); Delivery assets map (url, width, height, alt, focus, watermarked, placeholder 16px WebP data URL, processing, video renditions + streaming; public assets only); Customer API POST /units/:id/open returns renditions with a signed hls path for protected videos (expiresIn follows the video length); GET /api/v1/site mediaProtection
    Elements
    <kanorio-media src mime-type>, <kanorio-lightbox images='[…]'> (reads the site's media protection when protection is omitted)
    Hosted site
    /media library; gallery & media sections
    Webhooks
    media.asset.ready, media.asset.failed (background processing of a file: thumbnails, visibility moves, transcoding)

API reference

Webhook events

  • media.asset.ready · Fired when background processing of a media file (thumbnail, visibility move, transcoding) finishes and the file is ready to use.
  • media.asset.failed · Fired when background processing of a media file fails after retries; the site team also gets an in-app notification.
  • site.storageQuota.alert · Fired when site storage reaches 80%, is exhausted, auto-upgrades, or add-on payment fails.

Elements

  • <kanorio-media> · Public media player for a URL.
  • <kanorio-lightbox> · Image lightbox with zoom, keyboard navigation, and download and share controls that follow the site's media protection.

Recent changes

  • 2026-11-01 Media: adaptive streaming (HLS) versions of videos
  • 2026-10-31 Media: visibility is a file property
  • 2026-10-24 billableBytes, edgeColor, ogImageFraming, imageFramings, and 20 GB storage add-on levels
  • 2026-10-23 Per-device image aspect ratio and image framing in sections
  • 2026-10-23 Protected files for deliverables, file uploads and large-file uploads
View the full changelog

For site owners

How to use this product in the dashboard is covered in the help center.

Open the help center