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 (MCPrequest-media-upload-toolor REST). Used by AI agents to upload local files without provisioning an API key.
Upload limits
All upload paths (dashboard, REST, MCP signed URL) use the same per-type caps. There is no separate MCP-only size limit.
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. On self-hosted instances, raising the video cap also requires bumping PHP’s upload_max_filesize / post_max_size and any reverse-proxy body-size cap to match.
Signed upload URLs are single-use and expire after 15 minutes by default (MEDIA_SIGNED_UPLOAD_URL_TTL_MINUTES; legacy fallback 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 — that catalog is the source of truth.
There is no linkedin_carousel, linkedin_page_carousel, or instagram_carousel content type on posts. Multi-image Instagram posts use instagram_feed. LinkedIn multi-image / PDF posts use linkedin_post / linkedin_page_post (format is inferred from the attached media; optional meta.document_title for PDFs).
LinkedIn / LinkedIn Page
X (Twitter)
Instagram (and Instagram via Facebook)
TikTok
YouTube
Threads
Bluesky
Mastodon
Telegram
Discord
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 storage
Media files are stored on the disk configured byFILESYSTEM_DISK. Out of the box, TryPost ships with these drivers:
Any S3-compatible service (MinIO, DigitalOcean Spaces, Backblaze B2) works under the
s3 driver with the right endpoint.
On TryPost Cloud, media storage is handled automatically. Self-hosted users should configure cloud storage for production — see the Configuration guide.
FAQ
What's the maximum file size?
What's the maximum file size?
Defaults: 10 MB per image, 1 GB per video, 100 MB per PDF. Files over 1 MB are sent through the chunked upload endpoint via
Content-Range headers. Self-hosters can raise the caps with MEDIA_IMAGE_MAX_SIZE_MB / MEDIA_VIDEO_MAX_SIZE_MB / MEDIA_DOCUMENT_MAX_SIZE_MB.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?
TryPost uploads media to social platforms as-is. Each platform applies its own compression and resizing rules afterwards.