Upload Media

Upload an image or video once, then reference it by ID on any number of posts.

Endpoint

Example

Send the file as multipart form data:

curl -X POST https://api.plansched.com/developers/v1/media \
  -H "Authorization: Bearer $PLANSCHED_KEY" \
  -F "file=@./launch.png"

Response

{
  "id": "med_9x8y7z",
  "type": "image",
  "mime_type": "image/png",
  "width": 1920,
  "height": 1080,
  "size_bytes": 482310,
  "url": "https://cdn.plansched.com/media/med_9x8y7z.png",
  "created_at": "2026-07-21T10:04:12Z"
}