Supported media types
Three upload paths share the same MIME set:
POST /posts/{post}/media— direct upload with a Bearer token, attaches straight to a post.POST /posts/{post}/media/from-url— server-side fetch of a public URL.POST /uploads/{token}— one-shot signed URL issued by the MCPrequest-media-upload-toolflow. Used by AI agents to upload local files without provisioning an API key.
Upload limits
| Type | Default cap |n| --------------------- | ------------------------- |n| Image | 10 MB per file |n| Video | 1 GB per file |n| MCP signed-URL upload | 50 MB per file (any type) |
Files over 1 MB are sent in chunks (the dashboard streams them via Content-Range to the chunked upload endpoint) so big videos transfer reliably even on flaky connections.
The MCP upload path uses a tighter cap on purpose — files route through the app server before being written to the configured storage disk, so a smaller ceiling keeps a single worker from being tied up by huge transfers. Each signed URL is single-use and expires after 15 minutes (configurable via MCP_UPLOAD_URL_TTL_MINUTES).
Platform content types and media requirements
Each platform supports different content formats with specific media requirements. UseGET /content-types for the live, machine-readable version.
LinkedIn / LinkedIn Page
X (Twitter)
Instagram (and Instagram via Facebook)
TikTok
YouTube
Threads
Bluesky
Mastodon
Media ordering
Drag attachments in the post editor to reorder them. The order you set is the order they’ll appear on the social platform — important for carousels and multi-image posts.File storagennKavio stores media in managed workspace storage. You do not need to configure storage infrastructure.nn## FAQ
What's the maximum file size?
What's the maximum file size?
10 MB per image and 1 GB per video by default. Files over 1 MB are sent
through the chunked upload endpoint via
Content-Range headers.Can I use the same media in multiple posts?
Can I use the same media in multiple posts?
Each post stores its own media records. To reuse the same image, upload it
again or copy from the asset library.
What happens to media when I delete a post?
What happens to media when I delete a post?
The media records are removed along with the post.
Are images compressed or resized?
Are images compressed or resized?
Kavio uploads media to social platforms as-is. Each platform applies its own
compression and resizing rules afterwards.