@apteva/integrations 0.3.62 → 0.15.4

package/src/apps/heygen.json

@@ -1,7 +1,7 @@
 {
   "slug": "heygen",
   "name": "HeyGen",
-  "description": "HeyGen AI video generation platform. Create lifelike avatar videos from text, generate one-shot videos with the Video Agent, translate videos into 175+ languages with lip-sync, manage photo avatars, digital twins, templates, and assets.",
+  "description": "HeyGen AI video generation platform using the current v3 API first: Avatar IV/V video generation, image-to-video, Video Agent prompt-to-video, voices/TTS, avatar creation, assets, video translation, lipsync, webhooks, and legacy Studio/template APIs where v3 has no replacement.",
   "logo": "https://www.google.com/s2/favicons?domain=heygen.com&sz=128",
   "categories": [
     "ai",
@@ -12,7 +12,9 @@
   ],
   "base_url": "https://api.heygen.com",
   "auth": {
-    "types": ["api_key"],
+    "types": [
+      "api_key"
+    ],
     "headers": {
       "X-Api-Key": "{{api_key}}"
     },
@@ -27,7 +29,7 @@
   "tools": [
     {
       "name": "create_video_agent_v3",
-      "description": "Create a video with HeyGen's newest Video Agent API (v3). Give it a natural-language prompt plus an avatar and voice, and HeyGen builds the full video automatically — no scene composition needed. Returns a video id to poll via get_video_status. This is the newest one-shot video generation endpoint; prefer it over the older v1 video_agent_generate when the caller just wants 'make me a video about X'.",
+      "description": "Create a video with HeyGen Video Agent v3. One prompt can produce a finished video; optional avatar, voice, style, brand kit, and files steer the result. Poll returned video_id with get_video.",
       "method": "POST",
       "path": "/v3/video-agents",
       "input_schema": {
@@ -35,18 +37,65 @@
         "properties": {
           "prompt": {
             "type": "string",
-            "description": "Natural-language description of the video you want. Example: 'Create a 30-second explainer about the benefits of cold brew coffee for a cafe's Instagram feed.'"
+            "description": "Natural-language description of the video to create."
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "generate",
+              "chat"
+            ],
+            "default": "generate",
+            "description": "generate is one-shot; chat allows multi-turn revision."
           },
           "avatar_id": {
             "type": "string",
-            "description": "Avatar id from list_avatars. The Video Agent uses this avatar's voice and appearance throughout."
+            "description": "Optional avatar look id from list_avatar_looks."
           },
           "voice_id": {
             "type": "string",
-            "description": "Voice id from list_voices. Overrides the avatar's default voice when provided."
+            "description": "Optional voice id from list_voices."
+          },
+          "style_id": {
+            "type": "string",
+            "description": "Optional style id from HeyGen video agent styles."
+          },
+          "brand_kit_id": {
+            "type": "string",
+            "description": "Optional brand kit id."
+          },
+          "orientation": {
+            "type": "string",
+            "enum": [
+              "landscape",
+              "portrait"
+            ],
+            "description": "Optional output orientation."
+          },
+          "files": {
+            "type": "array",
+            "description": "Optional asset inputs, max 20. Each entry is {type:\"url\"|\"asset_id\"|\"base64\", ...}.",
+            "items": {
+              "type": "object"
+            }
+          },
+          "callback_url": {
+            "type": "string",
+            "description": "Webhook URL for completion/failure."
+          },
+          "callback_id": {
+            "type": "string",
+            "description": "Caller-defined callback identifier."
+          },
+          "incognito_mode": {
+            "type": "boolean",
+            "default": false,
+            "description": "Disable memory injection/extraction for this session."
           }
         },
-        "required": ["prompt"]
+        "required": [
+          "prompt"
+        ]
       }
     },
     {
@@ -68,7 +117,9 @@
           "files": {
             "type": "array",
             "description": "Array of asset references the agent can incorporate. Each entry: {\"asset_id\": \"...\"}",
-            "items": { "type": "object" }
+            "items": {
+              "type": "object"
+            }
           },
           "callback_id": {
             "type": "string",
@@ -79,87 +130,146 @@
             "description": "Webhook URL to notify when the video finishes generating."
           }
         },
-        "required": ["prompt"]
+        "required": [
+          "prompt"
+        ]
       }
     },
     {
-      "name": "generate_video",
-      "description": "Generate Video (V2) — canonical endpoint for producing an avatar video from text or audio. Supports Avatar III/IV, photo avatars, digital twins, and direct image input. Use one of avatar_id / image_url / image_asset_id as the subject, and one of script+voice_id / audio_url / audio_asset_id as the voice source. Asynchronous — poll status via get_video_status.",
+      "name": "create_video",
+      "description": "Create a HeyGen v3 video from an avatar look or an arbitrary image. Supports Avatar IV/V engines, script+voice or audio lip-sync, backgrounds, captions, mp4/webm output, and async polling via get_video.",
       "method": "POST",
-      "path": "/v2/videos",
+      "path": "/v3/videos",
       "input_schema": {
         "type": "object",
         "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "avatar",
+              "image"
+            ],
+            "description": "Use avatar for a saved avatar look, image for one-off image-to-video."
+          },
           "avatar_id": {
             "type": "string",
-            "description": "Avatar id from list_avatars. Mutually exclusive with image_url / image_asset_id."
+            "description": "Avatar look id from list_avatar_looks. Required when type=avatar."
+          },
+          "image": {
+            "type": "object",
+            "description": "Image input when type=image: {type:\"url\",url} or {type:\"asset_id\",asset_id} or {type:\"base64\",data}."
           },
-          "image_url": {
+          "title": {
             "type": "string",
-            "description": "Public image URL to use as the subject. Mutually exclusive with avatar_id / image_asset_id."
+            "description": "Display title in HeyGen."
           },
-          "image_asset_id": {
+          "resolution": {
             "type": "string",
-            "description": "Uploaded image asset id. Mutually exclusive with avatar_id / image_url."
+            "enum": [
+              "720p",
+              "1080p",
+              "4k"
+            ],
+            "default": "1080p"
           },
-          "script": {
+          "aspect_ratio": {
             "type": "string",
-            "description": "Text for the avatar to speak. Requires voice_id. Mutually exclusive with audio_url / audio_asset_id."
+            "enum": [
+              "16:9",
+              "9:16",
+              "4:5",
+              "5:4",
+              "1:1",
+              "auto"
+            ],
+            "default": "16:9"
           },
-          "voice_id": {
+          "fit": {
             "type": "string",
-            "description": "Voice id from list_voices. Required when script is provided."
+            "enum": [
+              "contain",
+              "cover"
+            ],
+            "description": "Subject fit on canvas."
           },
-          "audio_url": {
+          "background": {
+            "type": "object",
+            "description": "Background setting: color/image/video input depending on HeyGen support."
+          },
+          "remove_background": {
+            "type": "boolean",
+            "description": "Remove avatar background when supported."
+          },
+          "output_format": {
             "type": "string",
-            "description": "Public audio file URL to drive the avatar's lip-sync. Mutually exclusive with script."
+            "enum": [
+              "mp4",
+              "webm"
+            ],
+            "default": "mp4"
           },
-          "audio_asset_id": {
+          "script": {
             "type": "string",
-            "description": "Uploaded audio asset id. Mutually exclusive with script."
+            "description": "Text script. Mutually exclusive with audio_url/audio_asset_id."
           },
-          "title": {
+          "voice_id": {
             "type": "string",
-            "description": "Video title shown in the HeyGen dashboard."
+            "description": "Voice id from list_voices. Required for image/script; optional for avatars with default voice."
           },
-          "resolution": {
+          "audio_url": {
             "type": "string",
-            "enum": ["720p", "1080p"],
-            "default": "1080p"
+            "description": "Public audio URL for lip-sync. Mutually exclusive with script."
           },
-          "aspect_ratio": {
+          "audio_asset_id": {
             "type": "string",
-            "enum": ["16:9", "9:16"],
-            "default": "16:9"
+            "description": "Uploaded audio asset id for lip-sync. Mutually exclusive with script."
+          },
+          "voice_settings": {
+            "type": "object",
+            "description": "Voice settings: speed, pitch, volume, locale, engine_settings."
           },
           "motion_prompt": {
             "type": "string",
-            "description": "Photo avatars only — free-text guidance for movement and expression."
+            "description": "Avatar IV-only body motion prompt; do not use with engine.type=avatar_v."
           },
           "expressiveness": {
             "type": "string",
-            "enum": ["low", "medium", "high"],
-            "description": "Photo avatars only."
-          },
-          "remove_background": {
-            "type": "boolean",
-            "default": false,
-            "description": "Output with transparent background (requires webm via create_webm_video for true alpha channel)."
+            "enum": [
+              "low",
+              "medium",
+              "high"
+            ],
+            "description": "Avatar IV-only expressiveness."
+          },
+          "engine": {
+            "type": "object",
+            "description": "Engine selector, e.g. {type:\"avatar_v\"} or {type:\"avatar_iv\"}. Omit for HeyGen default."
           },
-          "background": {
+          "watermark": {
             "type": "object",
-            "description": "Background config: {type: 'color'|'image', value: '#hex' (for color), url: 'https://...' or asset_id: '...' (for image)}."
+            "description": "Optional watermark config."
           },
-          "voice_settings": {
+          "caption": {
             "type": "object",
-            "description": "Voice tuning: {speed: 0.5-1.5, pitch: -50 to +50, locale: 'en-US'}"
+            "description": "Optional caption config."
+          },
+          "callback_url": {
+            "type": "string",
+            "description": "Webhook URL for completion/failure."
+          },
+          "callback_id": {
+            "type": "string",
+            "description": "Caller-defined callback identifier."
           }
-        }
+        },
+        "required": [
+          "type"
+        ]
       }
     },
     {
       "name": "generate_studio_video",
-      "description": "Generate Studio Video — the earlier v2 multi-scene generator. Accepts an array of video_inputs where each entry is a scene with its own character (avatar + style), voice (script + voice_id or audio), and optional background. Use this when you need a multi-scene video with different avatars or backgrounds across scenes. For single-scene videos, prefer generate_video (POST /v2/videos) which has a simpler shape.",
+      "description": "Legacy v2 Studio multi-scene generator. Keep for older Studio/template workflows; for new single-scene avatar/image videos use create_video (POST /v3/videos), and for prompt-to-video use create_video_agent_v3.",
       "method": "POST",
       "path": "/v2/video/generate",
       "input_schema": {
@@ -168,7 +278,9 @@
           "video_inputs": {
             "type": "array",
             "description": "Array of scene inputs. Each entry: { character: {type: 'avatar'|'talking_photo', avatar_id: '...', avatar_style: 'normal'|'closeUp'}, voice: {type: 'text', input_text: '...', voice_id: '...'}, background: {type: 'color'|'image'|'video', value: '#hex' or url: '...'} }",
-            "items": { "type": "object" }
+            "items": {
+              "type": "object"
+            }
           },
           "dimension": {
             "type": "object",
@@ -190,7 +302,9 @@
             "description": "Custom callback id for webhook notifications."
           }
         },
-        "required": ["video_inputs"]
+        "required": [
+          "video_inputs"
+        ]
       }
     },
     {
@@ -207,7 +321,10 @@
           },
           "avatar_style": {
             "type": "string",
-            "enum": ["normal", "closeUp"],
+            "enum": [
+              "normal",
+              "closeUp"
+            ],
             "default": "normal"
           },
           "input_text": {
@@ -227,61 +344,85 @@
             "description": "Custom output dimensions: {width: 512, height: 512}"
           }
         },
-        "required": ["avatar_pose_id"]
+        "required": [
+          "avatar_pose_id"
+        ]
       }
     },
     {
-      "name": "get_video_status",
-      "description": "Poll the status of a video generation job. Returns status (processing | completed | failed), video_url when done, and duration. Poll every ~10 seconds until status is completed or failed.",
+      "name": "get_video",
+      "description": "Get/poll a HeyGen v3 video by id. Returns status, video_url, thumbnail/gif/subtitle URLs, duration, and failure details.",
       "method": "GET",
-      "path": "/v1/video_status.get",
+      "path": "/v3/videos/{video_id}",
+      "path_params": [
+        "video_id"
+      ],
       "input_schema": {
         "type": "object",
         "properties": {
           "video_id": {
             "type": "string",
-            "description": "The video id returned from generate_video / generate_studio_video / create_video_agent_v3 / etc."
+            "description": "Video id returned by create_video or create_video_agent_v3."
           }
         },
-        "required": ["video_id"]
-      },
-      "query_params": ["video_id"]
+        "required": [
+          "video_id"
+        ]
+      }
     },
     {
       "name": "list_videos",
-      "description": "List every video generated under the account, with status, URL (when completed), duration, and metadata.",
+      "description": "List HeyGen v3 videos with pagination and optional folder/title filtering.",
       "method": "GET",
-      "path": "/v1/video.list",
+      "path": "/v3/videos",
+      "query_params": [
+        "limit",
+        "token",
+        "folder_id",
+        "title"
+      ],
       "input_schema": {
         "type": "object",
         "properties": {
           "limit": {
             "type": "integer",
-            "description": "Max videos to return (up to 100)."
+            "default": 10
           },
           "token": {
             "type": "string",
-            "description": "Pagination token from the previous response."
+            "description": "Pagination token."
+          },
+          "folder_id": {
+            "type": "string",
+            "description": "Folder filter."
+          },
+          "title": {
+            "type": "string",
+            "description": "Title search."
           }
         }
-      },
-      "query_params": ["limit", "token"]
+      }
     },
     {
       "name": "delete_video",
-      "description": "Delete a generated video by id.",
+      "description": "Delete a HeyGen v3 video by id.",
       "method": "DELETE",
-      "path": "/v1/video.delete",
+      "path": "/v3/videos/{video_id}",
+      "path_params": [
+        "video_id"
+      ],
       "input_schema": {
         "type": "object",
         "properties": {
           "video_id": {
-            "type": "string"
+            "type": "string",
+            "description": "Video id."
           }
         },
-        "required": ["video_id"]
-      },
-      "query_params": ["video_id"]
+        "required": [
+          "video_id"
+        ]
+      }
     },
     {
       "name": "get_sharable_url",
@@ -295,42 +436,115 @@
             "type": "string"
           }
         },
-        "required": ["video_id"]
+        "required": [
+          "video_id"
+        ]
       }
     },
     {
-      "name": "list_avatars",
-      "description": "List every public and custom avatar available to the account. Returns avatar_id, name, gender, preview image URL, and preview video URL for each. Call this first when you need an avatar_id for generate_video.",
+      "name": "list_avatar_looks",
+      "description": "List HeyGen v3 avatar looks. The look id is the avatar_id for create_video; supported_api_engines indicates Avatar V eligibility.",
       "method": "GET",
-      "path": "/v2/avatars",
+      "path": "/v3/avatars/looks",
+      "query_params": [
+        "group_id",
+        "avatar_type",
+        "ownership",
+        "limit",
+        "token"
+      ],
       "input_schema": {
         "type": "object",
-        "properties": {}
+        "properties": {
+          "group_id": {
+            "type": "string",
+            "description": "Avatar group id."
+          },
+          "avatar_type": {
+            "type": "string",
+            "enum": [
+              "studio_avatar",
+              "digital_twin",
+              "photo_avatar"
+            ]
+          },
+          "ownership": {
+            "type": "string",
+            "enum": [
+              "public",
+              "private"
+            ]
+          },
+          "limit": {
+            "type": "integer",
+            "default": 20
+          },
+          "token": {
+            "type": "string",
+            "description": "Pagination token."
+          }
+        }
       }
     },
     {
-      "name": "get_avatar_details",
-      "description": "Fetch full metadata for a specific avatar including supported poses, expressions, and capabilities.",
+      "name": "get_avatar_look",
+      "description": "Fetch a HeyGen v3 avatar look, including default_voice_id and supported_api_engines.",
       "method": "GET",
-      "path": "/v2/avatar/{avatar_id}/details",
+      "path": "/v3/avatars/looks/{look_id}",
+      "path_params": [
+        "look_id"
+      ],
       "input_schema": {
         "type": "object",
         "properties": {
-          "avatar_id": {
-            "type": "string"
+          "look_id": {
+            "type": "string",
+            "description": "Avatar look id."
           }
         },
-        "required": ["avatar_id"]
+        "required": [
+          "look_id"
+        ]
       }
     },
     {
       "name": "list_avatar_groups",
-      "description": "List every avatar group (a collection of related avatars — e.g. the same person in different outfits or styles).",
+      "description": "List HeyGen v3 avatar groups/identities.",
       "method": "GET",
-      "path": "/v2/avatar_group.list",
+      "path": "/v3/avatars",
+      "query_params": [
+        "avatar_type",
+        "ownership",
+        "limit",
+        "token"
+      ],
       "input_schema": {
         "type": "object",
-        "properties": {}
+        "properties": {
+          "avatar_type": {
+            "type": "string",
+            "enum": [
+              "studio_avatar",
+              "digital_twin",
+              "photo_avatar"
+            ]
+          },
+          "ownership": {
+            "type": "string",
+            "enum": [
+              "public",
+              "private"
+            ]
+          },
+          "limit": {
+            "type": "integer",
+            "default": 20
+          },
+          "token": {
+            "type": "string",
+            "description": "Pagination token."
+          }
+        }
       }
     },
     {
@@ -345,17 +559,56 @@
             "type": "string"
           }
         },
-        "required": ["group_id"]
+        "required": [
+          "group_id"
+        ]
       }
     },
     {
       "name": "list_voices",
-      "description": "List every AI voice with voice_id, name, language, gender, accent, emotion support, and preview audio URL. Call this to discover voice_ids for generate_video.",
+      "description": "List HeyGen v3 voices. Use engine=starfish for TTS-compatible voices.",
       "method": "GET",
-      "path": "/v2/voices",
+      "path": "/v3/voices",
+      "query_params": [
+        "type",
+        "engine",
+        "language",
+        "gender",
+        "limit",
+        "token"
+      ],
       "input_schema": {
         "type": "object",
-        "properties": {}
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "public",
+              "private"
+            ],
+            "default": "public"
+          },
+          "engine": {
+            "type": "string",
+            "description": "Voice engine, e.g. starfish."
+          },
+          "language": {
+            "type": "string",
+            "description": "Language filter."
+          },
+          "gender": {
+            "type": "string",
+            "description": "Gender filter."
+          },
+          "limit": {
+            "type": "integer",
+            "default": 20
+          },
+          "token": {
+            "type": "string",
+            "description": "Pagination token."
+          }
+        }
       }
     },
     {
@@ -395,10 +648,14 @@
           "terms": {
             "type": "array",
             "description": "Array of custom term objects: {term: 'string', pronunciation: 'string', translation_hints: {'es': 'string', ...}}",
-            "items": { "type": "object" }
+            "items": {
+              "type": "object"
+            }
           }
         },
-        "required": ["brand_voice_id"]
+        "required": [
+          "brand_voice_id"
+        ]
       }
     },
     {
@@ -423,7 +680,9 @@
             "type": "string"
           }
         },
-        "required": ["template_id"]
+        "required": [
+          "template_id"
+        ]
       }
     },
     {
@@ -438,7 +697,9 @@
             "type": "string"
           }
         },
-        "required": ["template_id"]
+        "required": [
+          "template_id"
+        ]
       }
     },
     {
@@ -470,7 +731,9 @@
             "type": "string"
           }
         },
-        "required": ["template_id"]
+        "required": [
+          "template_id"
+        ]
       }
     },
     {
@@ -508,7 +771,10 @@
             "type": "string"
           }
         },
-        "required": ["video_url", "output_language"]
+        "required": [
+          "video_url",
+          "output_language"
+        ]
       }
     },
     {
@@ -523,7 +789,9 @@
             "type": "string"
           }
         },
-        "required": ["video_translate_id"]
+        "required": [
+          "video_translate_id"
+        ]
       }
     },
     {
@@ -548,7 +816,9 @@
             "type": "string"
           }
         },
-        "required": ["video_translate_id"]
+        "required": [
+          "video_translate_id"
+        ]
       }
     },
     {
@@ -573,7 +843,9 @@
           "output_languages": {
             "type": "array",
             "description": "Multiple target languages for batch proofread generation.",
-            "items": { "type": "string" }
+            "items": {
+              "type": "string"
+            }
           },
           "brand_voice_id": {
             "type": "string"
@@ -596,7 +868,10 @@
             "type": "boolean"
           }
         },
-        "required": ["video_url", "title"]
+        "required": [
+          "video_url",
+          "title"
+        ]
       }
     },
     {
@@ -611,7 +886,9 @@
             "type": "string"
           }
         },
-        "required": ["proofread_id"]
+        "required": [
+          "proofread_id"
+        ]
       }
     },
     {
@@ -626,7 +903,9 @@
             "type": "string"
           }
         },
-        "required": ["proofread_id"]
+        "required": [
+          "proofread_id"
+        ]
       }
     },
     {
@@ -641,7 +920,9 @@
             "type": "string"
           }
         },
-        "required": ["proofread_id"]
+        "required": [
+          "proofread_id"
+        ]
       }
     },
     {
@@ -656,7 +937,9 @@
             "type": "string"
           }
         },
-        "required": ["proofread_id"]
+        "required": [
+          "proofread_id"
+        ]
       }
     },
     {
@@ -677,7 +960,10 @@
           },
           "gender": {
             "type": "string",
-            "enum": ["Man", "Woman"]
+            "enum": [
+              "Man",
+              "Woman"
+            ]
           },
           "ethnicity": {
             "type": "string",
@@ -685,7 +971,11 @@
           },
           "orientation": {
             "type": "string",
-            "enum": ["horizontal", "vertical", "square"]
+            "enum": [
+              "horizontal",
+              "vertical",
+              "square"
+            ]
           },
           "pose": {
             "type": "string",
@@ -700,7 +990,9 @@
             "description": "Free-text appearance description ('short brown hair, glasses, casual shirt')."
           }
         },
-        "required": ["name"]
+        "required": [
+          "name"
+        ]
       }
     },
     {
@@ -719,7 +1011,10 @@
             "description": "Initial photo image_key from a previously-uploaded asset."
           }
         },
-        "required": ["name", "image_key"]
+        "required": [
+          "name",
+          "image_key"
+        ]
       }
     },
     {
@@ -736,10 +1031,15 @@
           "image_keys": {
             "type": "array",
             "description": "Array of image_key strings from uploaded assets.",
-            "items": { "type": "string" }
+            "items": {
+              "type": "string"
+            }
           }
         },
-        "required": ["group_id", "image_keys"]
+        "required": [
+          "group_id",
+          "image_keys"
+        ]
       }
     },
     {
@@ -754,7 +1054,9 @@
             "type": "string"
           }
         },
-        "required": ["group_id"]
+        "required": [
+          "group_id"
+        ]
       }
     },
     {
@@ -769,7 +1071,9 @@
             "type": "string"
           }
         },
-        "required": ["group_id"]
+        "required": [
+          "group_id"
+        ]
       }
     },
     {
@@ -789,7 +1093,11 @@
           },
           "orientation": {
             "type": "string",
-            "enum": ["horizontal", "vertical", "square"]
+            "enum": [
+              "horizontal",
+              "vertical",
+              "square"
+            ]
           },
           "pose": {
             "type": "string"
@@ -798,7 +1106,10 @@
             "type": "string"
           }
         },
-        "required": ["group_id", "prompt"]
+        "required": [
+          "group_id",
+          "prompt"
+        ]
       }
     },
     {
@@ -814,7 +1125,9 @@
             "description": "Photo avatar look id."
           }
         },
-        "required": ["avatar_id"]
+        "required": [
+          "avatar_id"
+        ]
       }
     },
     {
@@ -829,7 +1142,9 @@
             "type": "string"
           }
         },
-        "required": ["avatar_id"]
+        "required": [
+          "avatar_id"
+        ]
       }
     },
     {
@@ -844,7 +1159,9 @@
             "type": "string"
           }
         },
-        "required": ["avatar_id"]
+        "required": [
+          "avatar_id"
+        ]
       }
     },
     {
@@ -859,7 +1176,9 @@
             "type": "string"
           }
         },
-        "required": ["group_id"]
+        "required": [
+          "group_id"
+        ]
       }
     },
     {
@@ -882,7 +1201,11 @@
             "type": "string"
           }
         },
-        "required": ["training_footage_url", "video_consent_url", "avatar_name"]
+        "required": [
+          "training_footage_url",
+          "video_consent_url",
+          "avatar_name"
+        ]
       }
     },
     {
@@ -897,7 +1220,9 @@
             "type": "string"
           }
         },
-        "required": ["digital_twin_id"]
+        "required": [
+          "digital_twin_id"
+        ]
       }
     },
     {
@@ -912,12 +1237,14 @@
             "type": "string"
           }
         },
-        "required": ["digital_twin_id"]
+        "required": [
+          "digital_twin_id"
+        ]
       }
     },
     {
-      "name": "list_assets",
-      "description": "List every asset (image, audio, video) uploaded under the account. Paginated via token. Assets are referenced by asset_id in generate_video (image_asset_id, audio_asset_id) and create_video_agent_v3 (files array).",
+      "name": "legacy_list_assets",
+      "description": "Legacy v1 asset list endpoint. Prefer upload_asset/get_asset/delete_asset for v3 asset workflows.",
       "method": "GET",
       "path": "/v1/asset/list",
       "input_schema": {
@@ -929,7 +1256,11 @@
           },
           "file_type": {
             "type": "string",
-            "enum": ["image", "audio", "video"]
+            "enum": [
+              "image",
+              "audio",
+              "video"
+            ]
           },
           "limit": {
             "type": "integer",
@@ -941,22 +1272,33 @@
           }
         }
       },
-      "query_params": ["folder_id", "file_type", "limit", "token"]
+      "query_params": [
+        "folder_id",
+        "file_type",
+        "limit",
+        "token"
+      ]
     },
     {
       "name": "delete_asset",
-      "description": "Delete a specific asset by id. Removes it from the account permanently.",
+      "description": "Delete a HeyGen v3 asset.",
       "method": "DELETE",
-      "path": "/v1/asset/{asset_id}",
+      "path": "/v3/assets/{asset_id}",
       "input_schema": {
         "type": "object",
         "properties": {
           "asset_id": {
-            "type": "string"
+            "type": "string",
+            "description": "Asset id."
           }
         },
-        "required": ["asset_id"]
-      }
+        "required": [
+          "asset_id"
+        ]
+      },
+      "path_params": [
+        "asset_id"
+      ]
     },
     {
       "name": "create_folder",
@@ -974,7 +1316,9 @@
             "description": "Parent folder id. Omit for root-level folder."
           }
         },
-        "required": ["name"]
+        "required": [
+          "name"
+        ]
       }
     },
     {
@@ -1004,7 +1348,13 @@
           }
         }
       },
-      "query_params": ["limit", "parent_id", "name_filter", "is_trash", "token"]
+      "query_params": [
+        "limit",
+        "parent_id",
+        "name_filter",
+        "is_trash",
+        "token"
+      ]
     },
     {
       "name": "update_folder",
@@ -1022,7 +1372,10 @@
             "description": "New folder name."
           }
         },
-        "required": ["folder_id", "name"]
+        "required": [
+          "folder_id",
+          "name"
+        ]
       }
     },
     {
@@ -1037,7 +1390,9 @@
             "type": "string"
           }
         },
-        "required": ["folder_id"]
+        "required": [
+          "folder_id"
+        ]
       }
     },
     {
@@ -1052,14 +1407,16 @@
             "type": "string"
           }
         },
-        "required": ["folder_id"]
+        "required": [
+          "folder_id"
+        ]
       }
     },
     {
       "name": "get_current_user",
-      "description": "Get the authenticated user's profile information (email, plan, account id, etc).",
+      "description": "Get current HeyGen v3 user, wallet, and subscription information.",
       "method": "GET",
-      "path": "/v1/user/me",
+      "path": "/v3/users/me",
       "input_schema": {
         "type": "object",
         "properties": {}
@@ -1090,10 +1447,15 @@
           "events": {
             "type": "array",
             "description": "Array of event name strings (e.g. ['avatar_video.success', 'avatar_video.fail'])",
-            "items": { "type": "string" }
+            "items": {
+              "type": "string"
+            }
           }
         },
-        "required": ["url", "events"]
+        "required": [
+          "url",
+          "events"
+        ]
       }
     },
     {
@@ -1122,10 +1484,14 @@
           },
           "events": {
             "type": "array",
-            "items": { "type": "string" }
+            "items": {
+              "type": "string"
+            }
           }
         },
-        "required": ["endpoint_id"]
+        "required": [
+          "endpoint_id"
+        ]
       }
     },
     {
@@ -1140,9 +1506,13 @@
             "type": "string"
           }
         },
-        "required": ["endpoint_id"]
+        "required": [
+          "endpoint_id"
+        ]
       },
-      "query_params": ["endpoint_id"]
+      "query_params": [
+        "endpoint_id"
+      ]
     },
     {
       "name": "list_available_webhook_events",
@@ -1153,6 +1523,320 @@
         "type": "object",
         "properties": {}
       }
+    },
+    {
+      "name": "create_avatar",
+      "description": "Create a HeyGen v3 prompt, photo, or digital twin avatar. Training is async; poll the group/look status.",
+      "method": "POST",
+      "path": "/v3/avatars",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "prompt",
+              "photo",
+              "digital_twin"
+            ]
+          },
+          "name": {
+            "type": "string",
+            "description": "Avatar name."
+          },
+          "prompt": {
+            "type": "string",
+            "description": "Prompt for prompt avatars."
+          },
+          "file": {
+            "type": "object",
+            "description": "Photo/video file input: {type:\"url\"|\"asset_id\"|\"base64\", ...}."
+          },
+          "reference_images": {
+            "type": "array",
+            "description": "Up to 3 reference image inputs.",
+            "items": {
+              "type": "object"
+            }
+          },
+          "avatar_group_id": {
+            "type": "string",
+            "description": "Optional existing avatar group id."
+          }
+        },
+        "required": [
+          "type",
+          "name"
+        ]
+      }
+    },
+    {
+      "name": "create_speech",
+      "description": "Generate HeyGen v3 speech audio from plain text or SSML using a voice id.",
+      "method": "POST",
+      "path": "/v3/voices/speech",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "text": {
+            "type": "string",
+            "description": "Plain text or SSML."
+          },
+          "voice_id": {
+            "type": "string",
+            "description": "Voice id."
+          },
+          "speed": {
+            "type": "number",
+            "description": "Speed multiplier."
+          },
+          "output_format": {
+            "type": "string",
+            "description": "Audio output format when supported."
+          },
+          "locale": {
+            "type": "string",
+            "description": "Locale/pronunciation hint."
+          }
+        },
+        "required": [
+          "text",
+          "voice_id"
+        ]
+      }
+    },
+    {
+      "name": "upload_asset",
+      "description": "Upload a HeyGen v3 asset for reuse. Supports images, video, audio, and PDF.",
+      "method": "POST",
+      "path": "/v3/assets",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "file": {
+            "type": "string",
+            "description": "Multipart file upload field or platform-supported file reference."
+          },
+          "name": {
+            "type": "string",
+            "description": "Optional file name."
+          },
+          "folder_id": {
+            "type": "string",
+            "description": "Optional folder id."
+          }
+        },
+        "required": [
+          "file"
+        ]
+      }
+    },
+    {
+      "name": "get_asset",
+      "description": "Get HeyGen v3 asset metadata and URL.",
+      "method": "GET",
+      "path": "/v3/assets/{asset_id}",
+      "path_params": [
+        "asset_id"
+      ],
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "asset_id": {
+            "type": "string",
+            "description": "Asset id."
+          }
+        },
+        "required": [
+          "asset_id"
+        ]
+      }
+    },
+    {
+      "name": "create_video_translation",
+      "description": "Create HeyGen v3 video translations in one or more target languages. Use speed or precision mode; poll get_video_translation.",
+      "method": "POST",
+      "path": "/v3/video-translations",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "video": {
+            "type": "object",
+            "description": "Source video asset input: {type:\"url\"|\"asset_id\", ...}."
+          },
+          "output_languages": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Target language names."
+          },
+          "title": {
+            "type": "string",
+            "description": "Job title."
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "speed",
+              "precision"
+            ],
+            "default": "speed"
+          },
+          "audio": {
+            "type": "object",
+            "description": "Optional replacement/guide audio asset input."
+          },
+          "input_language": {
+            "type": "string",
+            "description": "Source language code."
+          },
+          "translate_audio_only": {
+            "type": "boolean",
+            "default": false,
+            "description": "Translate only audio."
+          },
+          "callback_url": {
+            "type": "string",
+            "description": "Webhook URL."
+          },
+          "callback_id": {
+            "type": "string",
+            "description": "Callback id."
+          },
+          "enable_caption": {
+            "type": "boolean",
+            "default": false,
+            "description": "Generate captions."
+          },
+          "folder_id": {
+            "type": "string",
+            "description": "Folder id."
+          }
+        },
+        "required": [
+          "video",
+          "output_languages"
+        ]
+      }
+    },
+    {
+      "name": "get_video_translation",
+      "description": "Get/poll a HeyGen v3 video translation job.",
+      "method": "GET",
+      "path": "/v3/video-translations/{video_translation_id}",
+      "path_params": [
+        "video_translation_id"
+      ],
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "video_translation_id": {
+            "type": "string",
+            "description": "Translation id."
+          }
+        },
+        "required": [
+          "video_translation_id"
+        ]
+      }
+    },
+    {
+      "name": "list_supported_translation_languages",
+      "description": "List HeyGen v3 video translation target languages.",
+      "method": "GET",
+      "path": "/v3/video-translations/languages",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "create_lipsync",
+      "description": "Create a HeyGen v3 lipsync job by replacing/dubbing audio on a source video. Poll with get_lipsync.",
+      "method": "POST",
+      "path": "/v3/lipsyncs",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "video": {
+            "type": "object",
+            "description": "Source video asset input."
+          },
+          "audio": {
+            "type": "object",
+            "description": "Replacement audio asset input."
+          },
+          "title": {
+            "type": "string",
+            "description": "Job title."
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "speed",
+              "precision"
+            ],
+            "default": "speed"
+          },
+          "callback_url": {
+            "type": "string",
+            "description": "Webhook URL."
+          },
+          "callback_id": {
+            "type": "string",
+            "description": "Callback id."
+          }
+        },
+        "required": [
+          "video",
+          "audio"
+        ]
+      }
+    },
+    {
+      "name": "get_lipsync",
+      "description": "Get/poll a HeyGen v3 lipsync job.",
+      "method": "GET",
+      "path": "/v3/lipsyncs/{lipsync_id}",
+      "path_params": [
+        "lipsync_id"
+      ],
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "lipsync_id": {
+            "type": "string",
+            "description": "Lipsync job id."
+          }
+        },
+        "required": [
+          "lipsync_id"
+        ]
+      }
+    },
+    {
+      "name": "list_lipsyncs",
+      "description": "List HeyGen v3 lipsync jobs.",
+      "method": "GET",
+      "path": "/v3/lipsyncs",
+      "query_params": [
+        "limit",
+        "token"
+      ],
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": {
+            "type": "integer",
+            "default": 10
+          },
+          "token": {
+            "type": "string",
+            "description": "Pagination token."
+          }
+        }
+      }
     }
   ],
   "webhooks": {
@@ -1200,5 +1884,8 @@
         "description": "Photo avatar generation / training / look failed."
       }
     ]
+  },
+  "health_check": {
+    "tool": "get_current_user"
   }
 }