Upload a file once and reuse the returned media ID across multiple media messages, instead of sending a public link every time.

Endpoint

POST /media.php

Requires the same Authorization: Bearer header as every other endpoint. Uses multipart/form-data, not JSON.

Request

Send the file as a multipart field named file:

curl -X POST "https://riffrechat.com/api/v1/media.php" \
  -H "Authorization: Bearer rf_live_YOUR_API_KEY" \
  -F "file=@product.jpg"

The file's actual content is sniffed server-side to determine its MIME type - the filename extension and any client-supplied Content-Type are not trusted.

Supported file types and size limits

A file whose sniffed MIME type is not in this list, or that exceeds its type's size limit, is rejected with 422.

Success response

201 Created:

{
  "id": "1234567890",
  "library_id": "6a2f9c9e-2e1a-4b7d-9d3d-0a5b7c8d9e0f",
  "type": "image",
  "mime_type": "image/png",
  "filename": "product.png",
  "file_size": 48213
}

Use the id field as image.id / video.id / audio.id / document.id in a subsequent call to Send Media Messages. library_id is Riffre's own internal reference for the upload and is not used in send-message requests.

Errors