Supported File Types for Upload

The Postiz CLI now correctly detects and uploads various media types.

How It Works

The CLI automatically detects the MIME type based on the file extension:

postiz upload video.mp4
# ✅ Detected as: video/mp4

postiz upload image.png
# ✅ Detected as: image/png

postiz upload audio.mp3
# ✅ Detected as: audio/mpeg

Supported File Types

Images

Extension	MIME Type	Supported
.png	image/png	✅ Yes
.jpg, .jpeg	image/jpeg	✅ Yes
.gif	image/gif	✅ Yes

Examples:

postiz upload photo.jpg
postiz upload logo.png
postiz upload animation.gif
postiz upload icon.svg

Videos

Extension	MIME Type	Supported
.mp4	video/mp4	✅ Yes

Examples:

postiz upload video.mp4
postiz upload clip.mov
postiz upload recording.webm
postiz upload movie.mkv

Audio

Extension	MIME Type	Supported
.mp3	audio/mpeg	✅ Yes
.wav	audio/wav	✅ Yes
.ogg	audio/ogg	✅ Yes
.aac	audio/aac	✅ Yes
.flac	audio/flac	✅ Yes
.m4a	audio/mp4	✅ Yes

Examples:

postiz upload podcast.mp3
postiz upload song.wav
postiz upload audio.ogg

Documents

Extension	MIME Type	Supported
.pdf	application/pdf	✅ Yes
.doc	application/msword	✅ Yes
.docx	application/vnd.openxmlformats-officedocument.wordprocessingml.document	✅ Yes

Examples:

postiz upload document.pdf
postiz upload report.docx

Other Files

For file types not listed above, the CLI uses:

• MIME type: application/octet-stream
• This is a generic binary file type

Usage Examples

Upload an Image

postiz upload ./images/photo.jpg

Response:

{
  "id": "upload-123",
  "path": "https://cdn.postiz.com/uploads/photo.jpg",
  "url": "https://cdn.postiz.com/uploads/photo.jpg"
}

Upload a Video (MP4)

postiz upload ./videos/promo.mp4

Response:

{
  "id": "upload-456",
  "path": "https://cdn.postiz.com/uploads/promo.mp4",
  "url": "https://cdn.postiz.com/uploads/promo.mp4"
}

Upload and Use in Post

# 1. Upload the file
RESULT=$(postiz upload video.mp4)
echo $RESULT

# 2. Extract the path (you'll need jq or similar)
PATH=$(echo $RESULT | jq -r '.path')

# 3. Use in a post
postiz posts:create \
  -c "Check out my video!" \
  -m "$PATH" \
  -i "tiktok-123"

Upload Multiple Files

# Upload images
postiz upload image1.jpg
postiz upload image2.png
postiz upload image3.gif

# Upload videos
postiz upload video1.mp4
postiz upload video2.mov

What Changed (Fix)

Before (❌ Bug)

postiz upload video.mp4
# ❌ Was detected as: image/jpeg (WRONG!)

The problem: The CLI defaulted to image/jpeg for any unknown file type.

After (✅ Fixed)

postiz upload video.mp4
# ✅ Correctly detected as: video/mp4

postiz upload audio.mp3
# ✅ Correctly detected as: audio/mpeg

postiz upload document.pdf
# ✅ Correctly detected as: application/pdf

Platform-Specific Notes

TikTok

• Supports: MP4, MOV, WEBM
• Recommended: MP4

YouTube

• Supports: MP4, MOV, AVI, WMV, FLV, 3GP, WEBM
• Recommended: MP4

Instagram

• Images: JPG, PNG
• Videos: MP4, MOV
• Recommended: MP4 for videos, JPG for images

Twitter/X

• Images: PNG, JPG, GIF, WEBP
• Videos: MP4, MOV
• Max video size: 512MB

LinkedIn

• Images: PNG, JPG, GIF
• Videos: MP4, MOV, AVI
• Documents: PDF, DOC, DOCX, PPT

Troubleshooting

"Upload failed: Unsupported file type"

Some platforms may not accept certain file types. Check the platform's documentation.

Solution: Convert the file to a supported format:

# Convert video to MP4
ffmpeg -i video.avi video.mp4

# Then upload
postiz upload video.mp4

File Size Limits

Different platforms have different file size limits:

• Twitter/X: Max 512MB for videos
• Instagram: Max 100MB for videos
• TikTok: Max 287.6MB for videos
• YouTube: Max 128GB (but 256GB for verified)

"MIME type mismatch"

If you renamed a file with the wrong extension:

# ❌ Wrong: PNG file renamed to .jpg
mv image.png image.jpg
postiz upload image.jpg  # Might fail

# ✅ Correct: Keep original extension
postiz upload image.png

Testing File Upload

# Set API key
export POSTIZ_API_KEY=your_key

# Test image upload
postiz upload test-image.jpg

# Test video upload
postiz upload test-video.mp4

# Test audio upload
postiz upload test-audio.mp3

Error Messages

File Not Found

❌ ENOENT: no such file or directory

Solution: Check the file path is correct.

No Permission

❌ EACCES: permission denied

Solution: Check file permissions:

chmod 644 your-file.mp4

Invalid API Key

❌ Upload failed (401): Unauthorized

Solution: Set your API key:

export POSTIZ_API_KEY=your_key

Summary

✅ 30+ file types supported ✅ Automatic MIME type detection ✅ Images, videos, audio, documents ✅ Correct handling of MP4, MOV, MP3, etc. ✅ No more defaulting to JPEG!

The upload bug is fixed! 🎉