Documentation Index
Fetch the complete documentation index at: https://docs.trypost.it/llms.txt
Use this file to discover all available pages before exploring further.
Supported media types
| Type | Common formats | MIME types accepted on upload |
|---|---|---|
| Image | JPG, PNG, GIF, WebP | image/jpeg, image/png, image/gif, image/webp |
| Video | MP4, MOV | video/mp4, video/quicktime |
POST /posts/{post}/media) and the URL-fetch endpoint (POST /posts/{post}/media/from-url) accept the same MIME set. WebM is intentionally excluded — every major social platform rejects it, so accepting it would just produce platform-specific publish failures.
Upload limit
1 GB per file. Files over 1 MB are sent in chunks (the dashboard streams them viaContent-Range to the chunked upload endpoint) so big videos transfer reliably even on flaky connections.
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
| Content type | Media | Max files | Notes |
|---|---|---|---|
linkedin_post / linkedin_page_post | Optional | 1 image or 1 video | Standard text post with optional media |
linkedin_carousel / linkedin_page_carousel | Required | Up to 20 images | Multi-image swipeable post |
X (Twitter)
| Content type | Media | Max files | Notes |
|---|---|---|---|
x_post | Optional | 4 images or 1 video | Images and video can’t be mixed in the same post |
| Content type | Media | Max files | Aspect | Notes |
|---|---|---|---|---|
facebook_post | Optional | 10 images or 1 video | — | Standard page post |
facebook_reel | Required | 1 video | 9:16 | Short-form vertical video |
facebook_story | Required | 1 image or 1 video | 9:16 | Disappears after 24 hours |
Instagram (and Instagram via Facebook)
| Content type | Media | Max files | Aspect | Notes |
|---|---|---|---|---|
instagram_feed | Optional | 1 image or 1 video | 4:5 | Single-asset feed post |
instagram_carousel | Required | Up to 10 images | 4:5 | Swipeable feed carousel (images only) |
instagram_reel | Required | 1 video | 9:16 | Short-form vertical video |
instagram_story | Required | 1 image or 1 video | 9:16 | Disappears after 24 hours |
TikTok
| Content type | Media | Max files | Aspect | Notes |
|---|---|---|---|---|
tiktok_video | Required | 1 video | 9:16 | Short or long-form video |
YouTube
| Content type | Media | Max files | Aspect | Notes |
|---|---|---|---|---|
youtube_short | Required | 1 video | 9:16 | Vertical short |
Threads
| Content type | Media | Max files | Notes |
|---|---|---|---|
threads_post | Optional | Up to 10 images or 1 video | Text post with optional media |
| Content type | Media | Max files | Aspect | Notes |
|---|---|---|---|---|
pinterest_pin | Required | 1 image | 2:3 | Standard image pin |
pinterest_video_pin | Required | 1 video | 9:16 | Video pin |
pinterest_carousel | Required | Up to 5 images | 2:3 | Multi-image swipeable pin |
Bluesky
| Content type | Media | Max files | Notes |
|---|---|---|---|
bluesky_post | Optional | Up to 4 images or 1 video | Text post with optional media |
Mastodon
| Content type | Media | Max files | Notes |
|---|---|---|---|
mastodon_post | Optional | Up to 4 images or 1 video | Text post with optional media |
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:
| Driver | Use case |
|---|---|
local | Development or small self-hosted setups |
s3 | AWS S3 |
r2 | Cloudflare R2 (S3-compatible — the default in shipped config) |
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?
1 GB per file. 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?
TryPost uploads media to social platforms as-is. Each platform applies its own compression and resizing rules afterwards.