Documentation Index
Fetch the complete documentation index at: https://docs.videowise.com/llms.txt
Use this file to discover all available pages before exploring further.
Base URL
https://api.videowise.com
POST /external/media/v1
Uploads a video or image file to Videowise.
| Key | Type | Required | Description |
|---|
X-Videowise-Access-Token | String | Yes | Access token to authorize the request. |
Request Body
The request must be sent as multipart/form-data.
| Field | Type | Required | Description |
|---|
fileContent | File | Yes | The media file to upload. |
File Limitations
Video Files
Max size: 50 MBSupported formats: Image Files
Max size: 5 MBSupported formats:
.jpeg / .jpg
.webp
.png
.gif
.avif
Example Request
curl -X POST https://api.videowise.com/external/media/v1 \
-H "X-Videowise-Access-Token: <your_access_token>" \
-F "fileContent=@/path/to/your/video.mp4"
Response
| Field | Type | Description |
|---|
id | String | The unique identifier of the uploaded media. |
url | String | The URL of the uploaded media file. |
{
"id": "6a0ef7bd30cc5df396bf8bbf",
"url": "https://cdn2.videowise.com/media/custom-videos/videos/1779365821653_wid_NmEwZWY3YmQzMGNjNWRmMzk2YmY4YmJm.mp4",
"hostKey": "custom-videos/videos/1779365821653_wid_NmEwZWY3YmQzMGNjNWRmMzk2YmY4YmJm.mp4"
}
| Status | Description |
|---|
200 | Media uploaded successfully. |
400 | Bad request. File type or size is not supported. |
401 | Unauthorized access. |
Error Codes
| Status | Description |
|---|
400 | Bad request. File type is not allowed or file exceeds the size limit. |
401 | Unauthorized. Access token is missing or invalid. |