API reference

Upload media

Upload an image or video before attaching it to a post.

POST/api/upload

Send the file as multipart/form-data in a field named file. Accepted types: JPEG, PNG, GIF, WebP, MP4, MOV, AVI. Maximum size 100 MB.

curl -X POST https://rostido.com/api/upload \
  -H "X-API-Key: rostido_xxx" \
  -F "[email protected];type=video/mp4"

Response

{
  "url": "/uploads/3f9c…e1.mp4",
  "meta": { "title": "…", "caption": "…", "hashtags": ["…"] }
}

Use url in a post's mediaUrls. meta only appears for videos that carry a title, description or comment in their file metadata, for example videos exported with ffmpeg -metadata.

You can also pass a public https:// media URL directly in mediaUrls instead of uploading.