Media API

Upload an image, video, or audio file. It is stored on your CDN and served at /{org}/media/{id}. Requires a media-family key.

Request

Send multipart/form-data with a single file field. Max 100 MB.

curl -X POST http://localhost:3000/api/v1/upload \
  -H "Authorization: Bearer mng_your_media_key" \
  -F "[email protected]"

Response

200 OK with the file record. The public URL is http://localhost:3000/{org}/media/{id}.

{
  "id": "9f1c2e7a-…",
  "url": "http://localhost:3000/your-org/media/9f1c2e7a-…",
  "name": "clip.mp4",
  "contentType": "video/mp4",
  "category": "video",
  "size": 1048576
}

Errors