curl -X PATCH "https://api.hooked.so/v1/character/cm4xa1b2c0001cd34ef56gh78" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Mia Torres" }'

const response = await fetch("https://api.hooked.so/v1/character/cm4xa1b2c0001cd34ef56gh78", {
  method: "PATCH",
  headers: { "x-api-key": process.env.HOOKED_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ name: "Mia Torres" }),
});
const { data: character } = await response.json();

import os
import requests

response = requests.patch(
    "https://api.hooked.so/v1/character/cm4xa1b2c0001cd34ef56gh78",
    headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
    json={"name": "Mia Torres"},
)
character = response.json()["data"]

{
  "success": true,
  "message": "Character updated",
  "data": {
    "id": "cm4xa1b2c0001cd34ef56gh78",
    "name": "Mia Torres",
    "description": "Late 20s, red curly hair, denim jacket",
    "voiceProfile": "Warm, slightly husky, speaks fast",
    "presetId": "cinematic",
    "imageUrl": "https://files.hooked.so/team/public/mia--fid--1a2b.png",
    "imageStatus": "COMPLETED",
    "createdAt": "2026-09-30T18:00:00.000Z",
    "creditsCharged": 0
  }
}

{
  "success": false,
  "message": "The character's photo is still processing; try again when imageStatus is not PROCESSING"
}