HomeAPI ReferenceHow To
API Reference
Create your Account

/media/upload/

post
https://api.callhub.io/v1/media/upload/

Upload an audio, image, or video file to your CallHub media library. Returns media_file_id (sync) or job_id (async video/GIF processing).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
file
required

Binary file payload. Allowed extensions: .mp3, .wav, .ogg, .mp4, .mov, .3gp, .3gpp, .jpg, .jpeg, .png, .gif

string
length ≤ 150

Display name shown in the media library. Defaults to the uploaded filename.

string

Truthy value (1, true) to convert an uploaded video into a GIF asynchronously. Returns a job_id instead of a media_file_id.

Responses

401

Missing or invalid Authorization token.

403

Token revoked or lacks media upload permission.

405

Only POST and OPTIONS (CORS preflight) are accepted.

Updated about 20 hours ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 20 hours ago