NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #4242 most downloaded on npm
A Twilio helper library
Last release 6 days ago
28 Sep 2026
Release timing varies
gaps range from 2 weeks to 3 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
11 versions withdrawn
withdrawn after publishing
16 years old
349 releases · first in 2011
PR #519: switch to a URL parsing lib that does not add percent-encoding. Thanks to @childish-sambino!
Library - Fix
Numbers
Studio
Twiml
speech_model to Gather verbAdd /Insights/SuccessRate endpoint for Businesses Branded Calls (Verified by Twilio)
Preview
/Insights/SuccessRate endpoint for Businesses Branded Calls (Verified by Twilio)Studio
Verify
MailerSid property to Verify Service resource.Wireless
data_limit_strategy to Rate Plan resource.One column per quarter.
Removed discard / obfuscate parameters from ContentRetention, AddressRetention (breaking change)
Api
twiml conditional for create. One of url, twiml, or application_sid is now required.bundle_sid parameter to /IncomingPhoneNumbers APIChat
last_consumed_message_index and last_consumption_timestamp parameters in update method for UserChannel resource (breaking change)Conversations
Messaging
PR #499: BREAKING feat: add support for custom HTTP headers in API requests. Thanks to @eshanholtz! (breaking change)
Library
Api
twiml parameter for call createChat
delete method in UserChannel resourceConversations
Taskrouter
Twiml
mixed_track value from <Stream> (breaking change)<Receive> optional attributesPR #498: fix: Stringify TwiML array attributes as space delimited. Thanks to @mpeltonen!
Library
Api
persistent_action parameter publictwiml optional private parameter for call createAutopilot
Flex
channel_type options documentationInsights
Messaging
Supersim
Direction filter parameter to list commands endpointIccid filter parameter to list sims endpointTwiml
<Refer> verbImplemented different Sid for Current Calls (Verified by Twilio), instead of relying in Call.Sid from Voice API team (breaking change)
Library
Api
sms-messages-carrierfees and mms-messages-carrierfeesConversations
Preview
Sid for Current Calls (Verified by Twilio), instead of relying in Call.Sid from Voice API team (breaking change)Supersim
Wireless
account_sid to Sim update parameters.Twiml
Say from PollyPR #486: breaking: Correct video composition date types. Thanks to @childish-sambino! (breaking change)
Library
Api
attempt to sms_messagesFlex
JanitorEnabled attribute to Flex Flowfeatures_enabled Flex Configuration key to private (breaking change)Supersim
Twiml
<Conference> rename "whisper" attribute to "coach" (breaking change)PR #483: Added the ability for users to specify a CA bundle for HTTPS requests. Thanks to @whitebarry!
Library
Conversations
Supersim
PR #476: breaking: Use specific TS list types and allow non-array TS params. Thanks to @childish-sambino! (breaking change)
Library
Numbers
Preview
/CPS, /CurrentCall, and /Devices. Please use Authorization: Bearer <xCNAM JWT> (breaking change)Voice
Message API required params updated (breaking change)
Library
Api
Conversations
Flex
features_enabled and serverless_service_sids to Flex ConfigurationMessaging
Preview
CallSid to /BrandedCalls endpointPR #471: Yoyodyne updates per PR 379. Thanks to @thinkingserious!
Library
Conversations
Flex
outbound_call_flows object to Flex ConfigurationSupersim
Sync
Wireless
usage_notification_method and usage_notification_url properties to rate_plan.Twiml
ach-debit transactions in Pay verbAdded support for the header Twilio-Sandbox-Mode to mock all Voice dependencies
Preview
Twilio-Sandbox-Mode to mock all Voice dependenciesTwiml
<Siprec> noun<Stream> noun<Start> and <Stop>Update recording events (breaking change)
Library
Insights
properties to summary.Preview
Twiml
<Conference> recording events (breaking change)PR #463: Add missing type for 'validateRequestWithBody'. Thanks to @childish-sambino!
Library
Api
friendly_name optional for applications createas_of date to Usage Record API callsWireless
Changed phone numbers from _URL|Path_ to X-XCNAM-Sensitive headers (breaking change)
Library
Autopilot
Preview
X-XCNAM-Sensitive headers (breaking change)Verify
MessagingConfiguration resource to verify serviceMessage resource price parameter type changed to string (breaking change)
Library
Api
price parameter type changed to string (breaking change)Autopilot
Flex
integrations to Flex ConfigurationInsights
Messaging
Proxy
Sync
Verify
RateLimits and Buckets resources to Verify ServicesRateLimits optional parameter on Verification creation.Twiml
<Room> participantIdentity casingPR #449: Replace string templating with interpolation. Thanks to @childish-sambino!
Library
Verify
approved to status enumRemoved webhook.*.format update parameters in Service resource from public library visibility in v1 (breaking change)
Library
Api
method optional for queue members updateChat
webhook.*.format update parameters in Service resource from public library visibility in v1 (breaking change)Insights
Numbers
Taskrouter
channel_optimized_routing attribute to task-channel endpointVideo
Wireless
imei to Data Session resource.imeisv from Data Session resource. (breaking change)Added imeisv to Data Session resource.
PR #440: Upgrade 'js-yaml' to resolve DOS vulnerability. Thanks to @childish-sambino!
Library
Api
verified property to AddressesNumbers
Proxy
PR #439: Force 'marked' dependency upgrade to resolve DoS vulnerability. Thanks to @childish-sambino!
Library
Flex
Numbers
Proxy
Serverless
PR #434: Upgrade 'js-yaml' to resolve DOS vulnerability. Thanks to @childish-sambino!
Library
Api
if_machine call create parameter from helper libraries (breaking change)call_sid path parameter type on QueueMember fetch and update requests (breaking change)Voice
Wireless
ResetStatus property to Sim resource to allow resetting connectivity via the API.PR #425: Upgrade the ‘request' lib and transitively the ‘extend’ lib to address CVE-2018-16492. Thanks to @childish-sambino!
Library
Api
machine_detection_speech_threshold, machine_detection_speech_end_threshold, machine_detection_silence_timeout optional params to Call create requestFlex
Release Notes ------------ Twiml - Add de1 to regions [Docs]
Add endpoint to update/cancel a Verification (breaking change)
Library
Api
Authy
Iam
Verify
Video
enqueued state to CompositionTwiml
Dial noun.PR #416: Bump packages for security. Thanks to @cjcodes!
Library
Api
force_opt_in optional param to Messages create requestFlex
Taskrouter
reject_pending_reservations to worker update endpointevent_date_ms and worker_time_in_previous_activity_ms to Events API responseVerify
EnablePsd2 optional parameter for PSD2 on Service resource creation or update.Amount, Payee optional parameters for PSD2.Update language enum for Gather to fix language code for Filipino (Philippines) and include additional supported languages (breaking change)
Library
Video
Twiml
language enum for Gather to fix language code for Filipino (Philippines) and include additional supported languages (breaking change)Add lookup information in the response when creating a new verification (depends on the LookupEnabled flag being enabled at the service level)
Verify
lookup information in the response when creating a new verification (depends on the LookupEnabled flag being enabled at the service level)VerificationSid optional parameter on Verification check.Remove unsupported query parameters (breaking change)
Chat
Proxy
Release Notes ------------ Insights - Initial revision. [Docs]
Reverted the change to FactorType and FormType, avoiding conflicts with Helper Libraries reserved words (type) (breaking change)
Library
Authy
FactorType and FormType, avoiding conflicts with Helper Libraries reserved words (type) (breaking change)Proxy
Studio
Taskrouter
Verify
SkipSmsToLandlines, TtsName, DtmfInputRequired optional parameters on Service resource creation or update.Wireless
Twiml
currency from enum to string for Pay (breaking change)Required authentication for /v1/Forms/{type} endpoint (breaking change)
Api
interactive_data optional param to Messages create requestAuthy
/v1/Forms/{type} endpoint (breaking change)Challenge.reason to Challenge.responded_reasonverification_sid from Challenge responsesconfig param from the Factor creationFactorType and FormType in favor of a unified Type (breaking change)Chat
Preview
Authy version from preview subdomain in favor to authy subdomain. (breaking change)Verify
CustomCode optional parameter on Verication creation.Change master-card to mastercard as cardType for Pay and Prompt, remove attribute credential_sid from Pay (breaking change)
Messaging
Twiml
master-card to mastercard as cardType for Pay and Prompt, remove attribute credential_sid from Pay (breaking change)url: '/v1/Accounts/{account sid}/Balance'
Api
Proxy
Verify
Locale optional parameter on Verification creation.Add Verb Transactions category to usage records
Api
Twiml
Pay verbDropped support for FactorType param given new Factor prefixes (breaking change)
Library
Api
coaching and call_sid_to_coach to participant properties, create and update requests.Authy
FactorType param given new Factor prefixes (breaking change)DELETE actions for Authy resourcesauthy subdomainAutopilot
autopilot subdomain with all resources from preview.understandPreview
preview to authy subdomainTaskrouter
Verify
LookupEnabled optional parameter on Service resource creation or update.SendDigits optional parameter on Verification creation.Twiml
Client noun and renamed the optional name field to identity. This is a breaking change in Ruby, and applications will need to transition from dial.client '' and dial.client 'alice' formats to dial.client and dial.client(identity: alice) formats. (breaking change)Renamed response headers for Challenge and Factors Signatures
Preview
Video
Twiml
debug to GatherparticipantIdentity to Roomchanged path param name from parent_iso_code to iso_code for highrisk_special_prefixes api (breaking change)
Library
Api
call_sid_to_coach parameter in participant to be previewPreview
totp in Authy preview endpointslatest in Authy Challenges endpointsVoice
Move from preview to beta (breaking change)
Library
Api
call_sid_to_coach parameter to participant create requestvoice_receive_mode param to IncomingPhoneNumbers createPreview
Form resource to Authy preview given a form_typePricing
Verify
Video
offset property in resourcePR #372: Tests for typescript. Thanks to @ekarson!
Library
Api
Chat
Preview
Actions endpoints and remove ResponseUrl from assistants on the Understand apiPricing
Add new Intent Statistics endpoint
Preview
ttl from AssistantsStudio
Removing deprecated segments, users, segment_memberships, user_bindings classes from helper libraries. (breaking change)
Library
Api
Chat
Notify
segments, users, segment_memberships, user_bindings classes from helper libraries. (breaking change)Preview
ttl from AssistantsProxy
Video
group-small room typeTwiml
Connect and Room for Programmable Video RoomsAdd support for SSML on Say verb, the message body is changed to be optional (breaking change)
Library
Twiml
PR #362: Remove old Precise env and sudo flag on TravisCI. Thanks to @jonatasbaldin!
Library
Api
cidr_prefix_length param to SIP IpAddresses APIStudio
Video
PR #358: Add Dockerfile and related changes to build the Docker image. Thanks to @jonatasbaldin!
Library
Api
Call Recording Controls feature support in helper librariesPR #359: Add test for mixed content. Thanks to @ekarson!
Library
Api
Video
ContentDisposition when obtaining media URLs for Room Recordings and CompositionsPR #354: Add validateSslCertificate to node client. Thanks to @mbichoffe!
Library
Twiml
PR #353: Update package-lock.json. Thanks to @cjcodes!
Library
Chat
Lookups
fraud lookup typePR #347: Update dependencies to fix vulnerabilities (#343). Thanks to @dkundel!
Library
Api
Studio
Trunking
Update event filtering to support date/time (breaking change)
Library
Chat
Monitor
Wireless
maturity to ga for all wireless apisRedesign API by adding custom VideoLayout object. (breaking change)
Library
Video
VideoLayout object. (breaking change)Gather input Enum: remove unnecessary "dtmf speech" value as you can now specify multiple enum values for this parameter and both "dtmf" and "speech"
Twiml
[Recordings] Change size type to long. (breaking change)
Library
Preview
Studio
Video
size type to long. (breaking change)Disable support for fraud lookups *(breaking change)*
Lookups
fraud lookups (breaking change)Preview
BuildDuration and ErrorCode to Understand ModelBuildStudio
Add caller_id param to Outbound Calls API
Api
caller_id param to Outbound Calls APItrim recording Outbound Calls API functionality in helper librariesVideo
room_sid to Composition resource.Twiml
input on GatherRemoves the context property from existing step and engagement resources. *(breaking change)*
Library
toJSON methods on all instance objects to allow serialization to json and remove circular references.Studio
Node v0.12 is no longer supported.
Important Notice
Api
trim param to Outbound Calls APILookups
fraud lookup typeNumbers
Video
SEQUENCE value to available layouts, and trim and reuse params.Add AnnounceUrl and AnnounceMethod params for conference announce
Api
AnnounceUrl and AnnounceMethod params for conference announceChat
Add studio-engagements usage key
Api
studio-engagements usage keyPreview
Studio
Video
SubscribedTracks.SubscribedTracks.PR #315: Add 'forever' as an option to RequestClient request method. Thanks @vzhidal!
Library
Api
conference_sid property on RecordingsChat
Fax
ttl parameter
ttl is the number of minutes a fax is considered valid.Preview
call_delay, extension, verification_code, and verification_call_sids.failure_reason to HostedNumberOrders.Your coding agent can read these notes before it upgrades. Set up the MCP server →