heygen
• Markdown

interactive avatar api avatar version deprecation notice

Interactive Avatar API - Avatar Version Deprecation Notice

Source: https://docs.heygen.com/docs/interactive-avatar-api-avatar-version-deprecation-notice Generated: 2025-09-18 10:44:50

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

Signal Server Error Code

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

WebRTC Media API Error

Media Sever Error Code

{
  "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.

__Updated about 2 months ago

Ask AI

Back to top