Skip to main content
Legacy Endpoint — This page links to our legacy API documentation for reference purposes.

HeyGen API v1 and v2 (Legacy)

Fully maintained, but no longer receiving new feature investment.

Deprecation Timeline — Oct 1, 2026

HeyGen API v3

The actively developed API. All new endpoints, models, and capabilities — including Avatar IV and Video Agent — are v3-first.
The v1 and v2 endpoints will remain fully supported until October 1, 2026. Our engineering roadmap and new feature development are focused exclusively on v3, and we strongly encourage all users to adopt v3 to take advantage of ongoing improvements, enhanced performance, and priority support. The primary distinction between the legacy endpoints and v3 lies in the Studio API and Template API, which are available in v2 but not yet supported in v3. Apart from these, the v3 endpoints cover the full HeyGen API, providing a unified platform for all new development. For guidance on migrating from v2 to v3, we recommend:
  1. Review the v3 API documentation to understand updated endpoint structures and request/response formats.
  2. Map your existing v2 calls to the equivalent v3 endpoints, noting that Studio and Template APIs currently remain on v2.
  3. Update authentication and payload formats according to v3 specifications.
  4. Test your integration in a staging environment before moving to production.

For questions about migration or enterprise support, please reach out to HeyGen support.