curl -X PATCH "https://api.hooked.so/v1/project/cm4x9k2p10001ab12cd34ef56/edit" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "captionSegments": [{ "index": 1, "text": "changed my mornings forever" }],
    "caption": { "preset": "beast", "alignment": "bottom" },
    "music": { "musicId": "12", "volume": 0.3 },
    "branding": { "logoMediaId": "cm4x9p3r40005ab12gh56ij78", "position": "top-right" }
  }'

const projectId = "cm4x9k2p10001ab12cd34ef56";
const headers = {
  "x-api-key": process.env.HOOKED_API_KEY,
  "Content-Type": "application/json",
};

// 1. Fix a caption line and lower the music
const edit = await fetch(`https://api.hooked.so/v1/project/${projectId}/edit`, {
  method: "PATCH",
  headers,
  body: JSON.stringify({
    captionSegments: [{ index: 1, text: "changed my mornings forever" }],
    music: { volume: 0.3 },
  }),
});
const edited = await edit.json();
if (!edited.success) throw new Error(edited.message);

// 2. Render the edited project
const render = await fetch("https://api.hooked.so/v1/render", {
  method: "POST",
  headers,
  body: JSON.stringify({ projectId }),
});
const { data } = await render.json();
console.log("New video:", data.videoId);

import os
import requests

project_id = "cm4x9k2p10001ab12cd34ef56"
headers = {"x-api-key": os.environ["HOOKED_API_KEY"]}

edited = requests.patch(
    f"https://api.hooked.so/v1/project/{project_id}/edit",
    headers=headers,
    json={
        "caption": {"preset": "beast"},
        "branding": {"logoMediaId": "cm4x9p3r40005ab12gh56ij78", "position": "top-right"},
    },
).json()
if not edited["success"]:
    raise RuntimeError(edited["message"])

render = requests.post(
    "https://api.hooked.so/v1/render",
    headers=headers,
    json={"projectId": project_id},
).json()
print("New video:", render["data"]["videoId"])

{
  "success": true,
  "message": "Project edited",
  "data": {
    "projectId": "cm4x9k2p10001ab12cd34ef56",
    "changed": ["captionSegments", "caption.preset", "caption.alignment", "music.musicId", "music.volume", "branding.logoMediaId", "branding.position"],
    "caption": { "disabled": false, "preset": "beast", "alignment": "bottom", "segments": 14 },
    "music": { "musicId": "12", "name": "Arietta", "volume": 0.3 },
    "branding": { "logoMediaId": "cm4x9p3r40005ab12gh56ij78", "position": "top-right", "size": 100 }
  }
}

{
  "success": false,
  "message": "voiceId: Cannot be edited through the API. Only caption, captionSegments, music and branding can; edit anything else in the dashboard"
}

{
  "success": false,
  "message": "A video of this project is still rendering"
}

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