Technical reference

API documentation

Upload media programmatically and get a direct link back. Built for bots and integrations.

Base URL

POST Upload a file

Uploads a file and returns a direct URL, viewer link and thumbnail.

Endpoint

Headers

`X-API-Key`	Your API key
`Content-Type`	`multipart/form-data`

Body

file The file to upload (form field)

Example request

Example response

{
  "success": true,
  "id": "abc123",
  "name": "photo.jpg",
  "size": 245678,
  "mime_type": "image/jpeg",
  "direct_url": "https://pixeldrain.com/api/file/abc123",
  "download_url": "https://pixeldrain.com/api/file/abc123?download",
  "viewer_url": "https://pixeldrain.com/u/abc123",
  "thumbnail_url": "https://pixeldrain.com/api/file/abc123/thumbnail"
}

POST Upload from a remote URL

Give it a media URL instead of raw bytes — useful when you only have a link (e.g. incoming WhatsApp media).

Endpoint

Body (JSON)

{
  "url": "https://example.com/incoming-media.mp4",
  "filename": "clip.mp4"
}