megachangelog
Fix13.0.0

Java Helper Library 13.0.0: Handle unknown fields in nested API responses

Java Helper Library 13.0.0 fixes a critical issue where versions 10.0.0-12.1.1 crash on unknown fields in nested API responses, now matching the behavior of other Twilio Helper Libraries. Upgrade immediately to prevent integration failures when Twilio adds new optional API fields.

The Java Helper Library now handles unknown fields gracefully in nested response objects, but if customers are on an affected version, their integration is at risk until they upgrade.

Versions 10.0.0 through 12.1.1 parse nested response types (profile, configuration, webhook, and others) with strict deserialization. When an API response comes back with a field the SDK doesn't recognize, the request fails with ApiConnectionException: Unable to deserialize response: Unrecognized field. Because Twilio APIs can add new optional fields at any time, this is a latent break. Customers’ integrations work today and can start failing without warning the moment a new field ships.

In 13.0.0, the Java Helper Library ignores unknown fields in all response objects, matching how every other Twilio Helper Library already behaves.

What to do

Upgrade to Java Helper Library 13.0.0 or later as soon as possible. Version 13 does include breaking changes so follow the upgrade guide to migrate safely. Once customers are on 13.0.0, their integration handles new optional fields in API responses without hitting deserialization errors.

The Python, Node.js, C#, Ruby, PHP, and Go Helper Libraries are not affected. They already handle unknown response fields the same way.

 

javasdkstabilityapi-responsedeserialization

Source: original entry ↗

More from Twilio

Follow Twilio to get its new changes in your feed and email digest.

Feature

Voice Insights now tags HD audio calls

Voice Insights now automatically tags calls as HD Audio when they use AMR-WB or Opus codecs, helping you confirm endpoint configuration and correlate HD audio usage with transcription accuracy and customer satisfaction. The system also tags calls as Downsampled when HD audio is converted to narrowband, visible in Console, REST API, and Event Streams.

voiceinsightsaudiohd-audioapi
Feature

RCS messaging now supported on all major Canadian carriers

Twilio now supports sending RCS messages to Rogers phone numbers, completing RCS coverage across Canada's major carriers. Existing RCS Senders approved by other Canadian carriers are automatically submitted to Rogers for approval.

rcsmessagingcanadacarriers
Feature

RCS messaging now supported on all major Canadian carriers

RCS messaging is now available to Rogers phone numbers in Canada, completing coverage across all major Canadian carriers. Previously approved RCS Senders will automatically be submitted to Rogers for review with no action required.

rcsmessagingcanadacarriers
See all Twilio changes →