Interactive Avatar API - Avatar Version Deprecation Notice

Effective immediately, HeyGen Interactive Avatar API v1 and v2 versions have been deprecated and are no longer supported. All sessions must use v3 or higher versions to ensure optimal performance and access to the latest features.

⚠️ Changes

• ❌ Avatar Version v1 - No longer supported
• ❌ Avatar Version v2 - No longer supported
• ✅ Avatar Version v3+ - Recommended and supported

Error Response Updates

When attempting to use deprecated avatar versions, you will receive one of the following errors:

WebRTC Signaling API Error

{
  "code": 10003,
  "message": "avatar version is deprecated, please update to v3+",
  "details": "invalid avatar"
}

WebRTC Media API Error

{
  "code": 400014,
  "message": "Avatar version is deprecated, please update to v3+",
  "status": 400
}

🛠️ Support

If you need assistance with migration:

contact support: https://www.heygen.com/contact-us

Note: This change is part of our ongoing effort to improve the Interactive Avatar experience. We appreciate your understanding and cooperation in this transition.