curl -X POST "https://api.admanage.ai/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/your/file.mp4"

{
  "success": true,
  "url": "https://media.admanage.ai/company-name/filename.png",
  "filename": "filename_suffix.png",
  "originalName": "filename.png",
  "wasRenamed": true,
  "dimensions": {
    "format": "png",
    "size": 145523,
    "width": 960,
    "height": 694,
    "space": "srgb",
    "channels": 3,
    "depth": "uchar",
    "density": 72,
    "isProgressive": false,
    "hasProfile": false,
    "hasAlpha": false,
    "exif": {
      "type": "Buffer",
      "data": [77, 77, 0, 42, 0, 0, 0, 8, 0, 1, 135, 105, 0, 4, 0, 0, 0, 1, 0, 0, 0, 26, 0, 0, 0, 0, 0, 3, 160, 1, 0, 3, 0, 0, 0, 1, 0, 1, 0, 0, 160, 2, 0, 4, 0, 0, 0, 1, 0, 0, 3, 192, 160, 3, 0, 4, 0, 0, 0, 1, 0, 0, 2, 182, 0, 0, 0, 0]
    }
  },
  "size": 145523,
  "sizeFormatted": "142.11 KB"
}

Upload a video file directly to AdManage for ad creation. Images and Videos are supported.

curl -X POST "https://api.admanage.ai/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/your/file.mp4"

{
  "success": true,
  "url": "https://media.admanage.ai/company-name/filename.png",
  "filename": "filename_suffix.png",
  "originalName": "filename.png",
  "wasRenamed": true,
  "dimensions": {
    "format": "png",
    "size": 145523,
    "width": 960,
    "height": 694,
    "space": "srgb",
    "channels": 3,
    "depth": "uchar",
    "density": 72,
    "isProgressive": false,
    "hasProfile": false,
    "hasAlpha": false,
    "exif": {
      "type": "Buffer",
      "data": [77, 77, 0, 42, 0, 0, 0, 8, 0, 1, 135, 105, 0, 4, 0, 0, 0, 1, 0, 0, 0, 26, 0, 0, 0, 0, 0, 3, 160, 1, 0, 3, 0, 0, 0, 1, 0, 1, 0, 0, 160, 2, 0, 4, 0, 0, 0, 1, 0, 0, 3, 192, 160, 3, 0, 4, 0, 0, 0, 1, 0, 0, 2, 182, 0, 0, 0, 0]
    }
  },
  "size": 145523,
  "sizeFormatted": "142.11 KB"
}

​
Parameters

​
file
file
required

The video file to upload. Supported formats: MP4, MOV, AVI. Maximum size: 100MB.

​
Upload from URL

Upload a video from a URL to AdManage for ad creation.

curl -X POST "https://api.admanage.ai/upload/url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/video.mp4"}'

{
  "success": true,
  "url": "https://media.admanage.ai/admanage.ai/video_sample_xyz123.mp4",
  "filename": "video_sample_xyz123.mp4",
  "originalName": "video.mp4",
  "wasRenamed": true,
  "id": 11110,
  "dimensions": {
    "format": "mp4",
    "size": 12582912,
    "width": 1280,
    "height": 720,
    "duration": 25.2,
    "bitrate": 4000000,
    "framerate": 30
  },
  "size": 12582912,
  "sizeFormatted": "12.00 MB"
}

​
Parameters

​
url
string
required

The URL of the video file to upload. Must be publicly accessible and point to a supported video format.

​
Response Fields

​
success
boolean

Indicates whether the upload was successful.

​
url
string

The CDN URL where the uploaded file can be accessed.

​
filename
string

The final filename of the uploaded file (may include suffix if renamed).

​
originalName
string

The original filename of the uploaded file.

​
wasRenamed
boolean

Indicates whether the file was renamed during upload to avoid conflicts.

​
id
number

Unique identifier for the uploaded file. Use this ID to reference the file in other API calls.

​
dimensions
object

Detailed information about the file’s dimensions and metadata.

​
size
number

The size of the uploaded file in bytes.

​
sizeFormatted
string

Human-readable formatted file size (e.g., “142.11 KB”, “12.00 MB”).

​
Error Responses

{
  "success": false,
  "error": "FILE_TOO_LARGE",
  "message": "File size exceeds the maximum limit of 100MB",
  "details": {
    "fileSize": 157286400,
    "maxSize": 104857600
  }
}