PostLake: upload media

Upload the file first to get a med_… id, then pass it as media in a publish or schedule call. Some platforms require media (Instagram, TikTok, YouTube, Pinterest).

Auth

Authorization: Bearer $POSTLAKE_API_KEY

Base URL https://api.postlake.dev.

Upload

POST the raw bytes with the file's Content-Type. Limits: images ≤20MB (jpeg/png/webp/gif); videos ≤200MB (mp4/mov/webm).

From a local file:

curl -X POST https://api.postlake.dev/v1/media \
 -H "Authorization: Bearer $POSTLAKE_API_KEY" \
 -H "Content-Type: image/jpeg" \
 --data-binary @photo.jpg

From a URL (download it first, then upload the bytes):

curl -sL "https://example.com/photo.jpg" -o /tmp/m.jpg
curl -X POST https://api.postlake.dev/v1/media \
 -H "Authorization: Bearer $POSTLAKE_API_KEY" \
 -H "Content-Type: image/jpeg" \
 --data-binary @/tmp/m.jpg

Response:

{ "id": "med_47214a…", "url": "https://media.postlake.dev/med_47214a…", "contentType": "image/jpeg", "size": 86487 }

Attach it to a post

Pass the id(s) as media, with optional alt text for accessibility:

curl -X POST https://api.postlake.dev/v1/posts \
 -H "Authorization: Bearer $POSTLAKE_API_KEY" \
 -H "Content-Type: application/json" \
 -H "Idempotency-Key: $(uuidgen)" \
 -d '{
  "text": "New drop 👟",
  "accounts": ["acc_54d8…"],
  "media": ["med_47214a…"],
  "mediaAlt": ["A pair of orange running shoes"]
 }'

Tips

• For removal, distinguish the social post from its uploaded file. Cancelling or retracting a post keeps its uploads and does not refund spent publishing credits.
• List stored files with GET /v1/media. Preview irreversible erasure with GET /v1/media/{id}/deletion; only after owner confirmation send its snapshot to DELETE /v1/media/{id}. Drafts and pending publication block erasure.
• MCP provides the same flow through manage_media: list, preview_delete, then delete with the confirmed snapshot. Erasure leaves social copies online but removes PostLake previews. Storage failures remain retryable.
• Uploads retain a minimum of 90 days while the account remains open, extended for scheduled references through terminal outcome plus 30 days if later. There is no automatic expiry. Explicit erasure and legal/security removal are exceptions. Sources are public URLs, not confidential storage. Keep originals. See https://docs.postlake.dev/media#deletion.
• Set the Content-Type to the real file type. It's how PostLake validates the upload.
• For video platforms (YouTube/TikTok) upload an mp4 and set a title via platformOptions.youtube.title.
• Reuse a med_… id across multiple posts; you don't need to re-upload.