Upload media file

​

Path parameters

​

Request

​

Behaviour

• The post must belong to the caller’s current workspace; otherwise the response is 404.
• The file’s MIME type is intersected with the platforms enabled on the post. For example, uploading an image to a TikTok-only post returns 422 unless the post targets tiktok_photo. Uploading a PDF only succeeds on platforms that accept documents (e.g. LinkedIn linkedin_post).
• Per-type size caps are enforced after MIME detection. The FormRequest uses the video ceiling as an overall bound; per-type limits still apply.
• PNG and WebP still images are normalized to JPEG (q100) at storage time for universal platform compatibility. GIF is preserved (animation kept for X / Bluesky / Mastodon / Telegram / Discord). MP4, MOV, and PDF are stored as-is.
• The new media is stored under medias/{uuid}.{ext} on the configured filesystem disk (local, s3, or r2) and appended to the post’s media[] array.

​

Response

curl -X POST https://app.trypost.it/api/posts/9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c/media \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -F "media=@./photo.jpg"

{
  "id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "content": "Launch day!",
  "media": [
    {
      "id": "01HX1A2B3C4D5E6F7G8H9I0J1K",
      "path": "medias/2681a1bf-131f-41b1-9866-755c1cb51f97.jpg",
      "url": "https://media.trypost.it/medias/2681a1bf-131f-41b1-9866-755c1cb51f97.jpg",
      "type": "image",
      "mime_type": "image/jpeg",
      "original_filename": "photo.jpg"
    }
  ],
  "status": "draft",
  "scheduled_at": null,
  "published_at": null,
  "platforms": [],
  "labels": [],
  "created_at": "2025-01-14 09:00:00",
  "updated_at": "2025-01-14 09:30:00"
}