curl -X POST "https://api.hooked.so/v1/render" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "cm4x9k2p10001ab12cd34ef56",
    "webhook": "https://example.com/hooked/webhook?token=YOUR_SECRET"
  }'

const response = await fetch("https://api.hooked.so/v1/render", {
  method: "POST",
  headers: {
    "x-api-key": process.env.HOOKED_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    projectId: "cm4x9k2p10001ab12cd34ef56",
    webhook: "https://example.com/hooked/webhook?token=YOUR_SECRET",
  }),
});
const { data } = await response.json();
console.log("Render started, video ID:", data.videoId);

import os
import requests

response = requests.post(
    "https://api.hooked.so/v1/render",
    headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
    json={
        "projectId": "cm4x9k2p10001ab12cd34ef56",
        "webhook": "https://example.com/hooked/webhook?token=YOUR_SECRET",
    },
)
data = response.json()["data"]
print("Render started, video ID:", data["videoId"])

{
  "success": true,
  "data": {
    "videoId": "cm4xa1b2c0007ab12mn34op56",
    "projectId": "cm4x9k2p10001ab12cd34ef56",
    "status": "STARTED"
  },
  "message": "Render started successfully"
}

{
  "success": false,
  "message": "There is nothing on the timeline to render yet"
}

{
  "success": false,
  "message": "Missing projectId"
}

{
  "code": "not_authenticated",
  "message": "Not authenticated",
  "errorCode": "NOT_AUTHENTICATED",
  "details": { "x-api-key": "Header not provided or API Key invalid" }
}

{
  "success": false,
  "message": "The project uses files that do not belong to this team"
}

{
  "success": false,
  "message": "Project not found"
}