Actions23
- Asset Actions
- Avatar Actions
- List Actions
- Lipsync Actions
- OAuth Actions
- Video Actions
- Video Agent Actions
List → List Avatars Groups
AI-generatedSummary
Lists HeyGen avatar groups using the v3 API, optionally filtered by ownership. Set a page size and, to fetch another page, provide the opaque pagination token returned by a previous response.
Inputs
- Authentication — Choose OAuth2 (default) or the legacy API key credential.
- Max Results — Items per page; defaults to 20.
- Pagination Token — Opaque cursor from
next_tokento request another page; omitted by default. - Ownership — Filter groups by ownership: Any (default), Private, or Public.
Output shape
A single item containing the HeyGen API response for the avatar groups request.
The request is GET
/v3/avatars; the response is passed through without reshaping. Pagination is controlled by the limit and token parameters. With Continue On Fail enabled, errors are returned as an item with anerrorfield.