Media Library

Uploading files

Upload files via the dashboard or the Media API. Files are uploaded as multipart/form-data.

Supported file types

• Images — JPEG, PNG, WebP, GIF, SVG
• Documents — PDF, DOCX, XLSX, CSV
• Video — MP4, WebM
• Audio — MP3, WAV, OGG

File size limits

Maximum file size depends on your hosting plan:

CDN delivery

All media assets are served via Knitt's CDN. URLs follow the pattern:

https://cdn.knitt.co/{tenant_id}/{folder}/{filename}

Using media in entries

Reference media assets in your entries using the media field type. The API returns the full CDN URL and metadata:

{
  "featured_image": {
    "id": "med_abc123",
    "url": "https://cdn.knitt.co/ten_123/hero.jpg",
    "alt": "Hero banner",
    "width": 1920,
    "height": 1080
  }
}

Next steps

• API Reference: Media — Full upload and management endpoints with code examples