Update Avatar Group
Updates an avatar group. Currently supports setting default_voice_id: the voice becomes the avatar’s default for video generation and is linked to the group if it was not already. Accepts any voice available to your workspace, including imported voice clones. Only supported for avatars you own — public avatars cannot be updated.
Authorizations
HeyGen API key. Obtain from your HeyGen dashboard.
Path Parameters
Unique avatar group identifier
Body
Request body for PATCH /v3/avatars/{group_id}.
Voice ID to set as the avatar's default voice, replacing the current one. The voice is also linked to the avatar group if it was not already. Accepts any voice available to your workspace, including imported voice clones. Only supported for avatars you own.
255"1bd001e7e50f421d891986aad5c8bbd2"
Response
Successful response
A single avatar group in the list response.
Groups are containers for looks (outfits/styles). To determine avatar type and engine compatibility, fetch the looks via GET /v3/avatars/looks.

