Request for SDK Change Notifications

Support Help
1

Hi Retell Support,

We’re currently using the Retell AI Python SDK in production for our voice agent platform, and we’ve experienced disruptions when SDK or API changes are made. In a few cases, our platform functionality broke until we were able to identify the change and update our integration.

We’d like to ask whether there is a way to receive advance notice of upcoming SDK or API changes so we can test and adapt proactively.

Some recent changes that impacted us were:

  • get_calls being moved from v2 to v3. and no transcript in that endpoint anymore.
  • LLMResource.create no longer supports version as a parameter
  • InboundVoiceAgent no longer supporting normalize_for_speech, with that setting moved to handbook_config.speech_normalization

These changes affected core parts of our platform, especially:

  • agent updating
  • call logs functionality

Luckily, we were able to figure these out in time and roll out a fix.

To help us maintain stability, could you please clarify:

  1. Is there a notification system, mailing list, changelog notifications, or release channel where we can be alerted about SDK/API changes before they are released?
  2. Do you provide deprecation notices or migration guides in advance of breaking changes?
  3. What is the recommended way for integration partners like us to stay informed about SDK updates, API version changes, and field/parameter migrations?
  4. Is there any versioning or transition period for breaking changes so existing integrations do not fail immediately?

Advance notice would make a big difference for us operationally and would help us avoid downtime for our users.

Thank you for your help.

Best regards

2

Hi @m.hariss123

Totally understand the impact that unexpected breaking changes can have on production, and we’re sorry for the friction this has caused.

Today, we surface API/SDK changes via: