# 1. Ask for an upload URL
curl -X POST "https://api.hooked.so/v1/media/upload" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "fileName": "demo.mp4", "fileType": "video/mp4", "fileSize": 8388608 }'

# 2. PUT the file to data.uploadUrl
curl -X PUT "UPLOAD_URL_FROM_STEP_1" \
  -H "Content-Type: video/mp4" \
  --data-binary @demo.mp4

# 3. Complete
curl -X POST "https://api.hooked.so/v1/media/MEDIA_ID/complete" \
  -H "x-api-key: your_api_key_here"

import { readFile, stat } from "node:fs/promises";

const headers = { "x-api-key": process.env.HOOKED_API_KEY, "Content-Type": "application/json" };
const { size } = await stat("demo.mp4");

const start = await fetch("https://api.hooked.so/v1/media/upload", {
  method: "POST",
  headers,
  body: JSON.stringify({ fileName: "demo.mp4", fileType: "video/mp4", fileSize: size }),
});
const { data: upload } = await start.json();

await fetch(upload.uploadUrl, {
  method: upload.method,
  headers: upload.headers,
  body: await readFile("demo.mp4"),
});

const done = await fetch(`https://api.hooked.so/v1/media/${upload.mediaId}/complete`, {
  method: "POST",
  headers: { "x-api-key": process.env.HOOKED_API_KEY },
});
const { data: media } = await done.json();
console.log(media.id, media.status); // COMPLETED

import os
import requests

api_key = os.environ["HOOKED_API_KEY"]
path = "demo.mp4"

upload = requests.post(
    "https://api.hooked.so/v1/media/upload",
    headers={"x-api-key": api_key},
    json={"fileName": "demo.mp4", "fileType": "video/mp4", "fileSize": os.path.getsize(path)},
).json()["data"]

with open(path, "rb") as file:
    requests.put(upload["uploadUrl"], headers=upload["headers"], data=file).raise_for_status()

media = requests.post(
    f"https://api.hooked.so/v1/media/{upload['mediaId']}/complete",
    headers={"x-api-key": api_key},
).json()["data"]
print(media["id"], media["status"])

{
  "success": true,
  "message": "Upload URL created",
  "data": {
    "mediaId": "cm4x9s8u60009ab12kl56mn90",
    "uploadUrl": "https://files.hooked.so/team/public/demo--fid--9c1d.mp4?X-Amz-Signature=...",
    "method": "PUT",
    "headers": { "Content-Type": "video/mp4" },
    "expiresAt": "2026-10-01T09:40:00.000Z"
  }
}

{
  "success": false,
  "message": "fileName: The extension must be one of mp4, mov, webm"
}