Skip to main content
POST
/
files
Upload a file
curl --request POST \
  --url https://api.hera.video/v1/files \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form file='@example-file'
{
  "url": "https://your-supabase-url.supabase.co/storage/v1/object/public/images/api-uploads/abc123.png"
}

Authorizations

​
x-api-key
string
header
required

Your API key for authenticating requests.

Body

multipart/form-data
​
file
file
required

The file to upload. Supported types: images (PNG, JPEG, GIF, SVG, WebP, BMP), videos (MP4, MPEG, WebM, MOV, AVI, FLV, MPG, WMV, 3GP), audio (MP3, WAV, AAC), fonts (TTF, OTF, EOT, WOFF, WOFF2), and CSV. Max size: 10 MB.

Response

File uploaded successfully. Returns the public URL of the stored file.

Response after successfully uploading a file.

​
url
string
required

Public URL of the uploaded file. Use this URL in POST /videos fields that accept a URL.

Example:

"https://your-supabase-url.supabase.co/storage/v1/object/public/images/api-uploads/abc123.png"