Upload File

Upload a media file by multipart form. Returns an id and path you can pass into a post’s image array.

Accepted MIME types

The backend inspects the file’s actual content (not just the extension) and rejects anything outside this allowlist:

Type	MIME
JPEG	image/jpeg
PNG	image/png
GIF	image/gif
WebP	image/webp
AVIF	image/avif
BMP	image/bmp
TIFF	image/tiff
MP4 video	video/mp4

PDFs are not accepted. See Uploads troubleshooting for limits and recommended video formats.

Example

curl -X POST "https://social.nittymusic.com/api/public/v1/upload" \
  -H "Authorization: your-api-key" \
  -F "file=@photo.jpg"

Example response:

{
  "id": "01HXYZ123ABCDEF",
  "path": "https://media.nittymusic.com/uploads/photo.jpg"
}

Usage in a post

{
  "image": [
    {
      "id": "01HXYZ123ABCDEF",
      "path": "https://media.nittymusic.com/uploads/photo.jpg"
    }
  ]
}