NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet · #462 most downloaded on NuGet
Twilio REST API helper library
Last release 10 days ago
28 Sep 2026
Release timing varies
gaps range from 1 weeks to 4 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
127 years old
390 releases · first in 1900
One column per quarter.
Corrected the data types for feedback summary fields (breaking change)
Api
from and to param to be endpoint type for supporting client identifier and sip addressBulkexports
Events
Messaging
status field in us_app_to_person api to campaign_status (breaking change)Verify
push factor and include extra information about totp factor.Change schema_versions prop and key to versions (breaking change)
Api
from and to param to be endpoint type for supporting client identifier and sip addressfrom and to param to be endpoint type for supporting client identifier and sip addressBulkexports
Events
Messaging
use_inbound_webhook_on_number field in Service API for fetch, create, update, readTaskrouter
If-Match Header based on ETag for Task DeleteVerify
AuthPayload parameter to support verifying a Challenge upon creation. This is only supported for totp factors.Challenge. This is only supported for push factors.Twiml
Removed optional property time_limit in the call create request. (breaking change)
Api
announcement event to conference status callback eventstime_limit in the call create request. (breaking change)Messaging
Supersim
Verify
Binding field is now returned when creating a Factor. This value won't be returned for other endpoints.Video
Twiml
announcement event to statusCallbackEvent for <Conference>.Recording rule beta flag (breaking change)
Api
CallToken for create calls apitime_limit in the call create request.Bulkexports
Events
Numbers
Supersim
SmsCommandsUrl, SmsCommandsMethod and SmsCommandsEnabled to a Fleet resourceTaskrouter
If-Match Header based on ETag for Task UpdateETag as Response Headers to Tasks and ReservationsVideo
Adjust A2P brand registration status enum (breaking change)
Events
Messaging
Studio
Verify
api.verify.totp beta feature.Twiml
<VirtualAgent> nounRemove A2P campaign and use cases API (breaking change)
Library - Fix
Events
Messaging
Verify
Remove If-Match header for Document (breaking change)
Library - Chore
Api
from and to param to be endpoint type for supporting client identifier and sip addressfrom and to param to be endpoint type for supporting client identifier and sip addressEvents
Flex
notifications and markdown to Flex ConfigurationMessaging
Serverless
Sync
Trusthub
Twiml
refer_url and refer_method to Dial.Allow updating CommandsUrl and CommandsMethod on a Fleet
Studio
Supersim
CommandsUrl and CommandsMethod on a FleetTwiml
status_callback and status_callback_method to Stream.Changed last_read_message_index type in Participant's resource (breaking change)
Api
Conversations
last_read_message_index type in Participant's resource (breaking change)Insights
created_time to call summary.Sync
Video
Updated call_event default_output_properties to request and response.
Api
call_event default_output_properties to request and response.Conversations
last_read_message_index and last_read_timestamp to Participant's resource update operationis_notifiable and is_online to User's resourcereachability_enabled parameters to update method for Conversation Service Configuration resourceMessaging
Twiml
sequential to Dial.Removed deprecated Programmable Chat usage record categories (breaking change)
Api
RecordingTrack parameter for create calls, create participants, and create call recordingsTwiml
recordingTrack to Dial.Remove RecordingTrack parameter for create calls, create participants, and create call recordings (breaking change)
Api
RecordingTrack parameter for create calls, create participants, and create call recordings (breaking change)RecordingTrack parameter for create calls and create call recordingsrecording_track in the participant create requestLookups
caller_name and carrier properties type to object (breaking change)Trunking
Twiml
jitterBufferSize and participantLabel to Conference.Removing call_sid from participant summary. (breaking change)
Library - Feature
Api
Conversations
Insights
Serverless
Sync
Verify
Details and HiddenDetails properties are now marked as PIIexpiration_date attribute updated to set a default value of five (5) minutes and to allow max dates of one (1) hour after creation.identity attribute updated to allow values between 8 and 64 characters.The API itself failed the request without these fields. (breaking change)
Library - Feature
Api
verify-push to usage_record APIBulkexports
Insights
Ip_messaging
Verify
preview to betatwilio_sandbox_mode header was removed from Verify Push resources (breaking change)Video
Simplified Channels resource. The path is now /BrandedChannels/branded_channel_sid/Channels (breaking change)
Library - Feature
Ai
Annotation Project and Annotation Task endpointsPrimitives endpointsmeta.total to the search endpointConversations
Insights
trust to summary.Preview
Channels resource. The path is now /BrandedChannels/branded_channel_sid/Channels (breaking change)Verify
config and binding) to use dot notation instead of JSON string (e.i. Before: binding={"alg":"ES256", "public_key": "xxx..."}, Now: Binding.Alg="ES256", Binding.PublicKey="xxx..."). (breaking change)details and hidden_details) to use dot notation instead of JSON string (e.i. Before: details={"message":"Test message", "fields": "[{\"label\": \"Action 1\", \"value\":\"value 1\"}]"}, Now: details.Message="Test message", Details.Fields=["{\"label\": \"Action 1\", \"value\":\"value 1\"}"]). (breaking change)notify_service_sid from push service configuration object. Add Push.IncludeDate, Push.ApnCredentialSid and Push.FcmCredentialSid service configuration parameters. (breaking change)Add optional property call_reason in the participant create request
Api
call_reason in the participant create requestMessaging
Serverless
Video
PR #542: allow API redirect responses. Thanks to @childish-sambino!
Library - Fix
Accounts
Conversations
Events
PR #540: add custom header support. Thanks to @eshanholtz!
Library - Feature
Conversations
Messaging
Numbers
Proxy
Supersim
AccountSid parameter to Sim resource update requestPR #538: use ReferenceAssemblies NuGet packages. Thanks to @childish-sambino!
Library - Fix
Messaging
Supersim
ready status as an available status for a Sim resourcePR #535: simplify the build-test-pack-release process. Thanks to @childish-sambino!
Library - Chore
Ai
Bulkexports
Messaging
Numbers
Routes
Trunking
transfer_mode property on Trunks.Removed Start and End parameters from the Data Sessions list endpoint. (breaking change)
Library - Chore
Conversations
Events
Proxy
Supersim
Wireless
Start and End parameters from the Data Sessions list endpoint. (breaking change)Add rejection reason support to WhatsApp API
Messaging
Proxy
Verify
CustomFriendlyName optional parameter on Verification creation.Challenge resource to update documentation of both details and hidden_details properties.PR #530: Change Default Logo from .ico to .png in NuGet. Thanks to @garethpaul!
Library - Fix
Api
Supersim
Changed wfm_integrations Flex Configuration key to private (breaking change)
Library - Feature
Conversations
Events
Flex
wfm_integrations Flex Configuration key to private (breaking change)Messaging
Numbers
valid_until in the Bundles resourceVerify
sms, totp and app-push factor types in Verify push (breaking change)Update start/end date filter params to support date-or-time format (breaking change)
Api
JitterBufferSize parameter for creating conference participantlabel property for conference participantscaller_id for creating conference participant endpoint.Autopilot
Conversations
Monitor
Numbers
provisionally-approved as a Supporting Document statusPreview
Authy resources. (breaking change)Supersim
Verify
api.verify.push beta featureTwiml
Gather verb.Removed insights preview API from API Definitions (breaking change)
Library - Docs
Api
pstnconnectivity to usage_record APIAutopilot
Notify
Numbers
provisionally-approved as a Bundle statusPreview
BrandsInformation endpoint now returns a single BrandsInformationkyc-apipreview API from API Definitions (breaking change)BrandsInformation endpoint to query brands information stored in KYCSupersim
Renamed twilio_authy_sandbox_mode headers to twilio_sandbox_mode (breaking change)
Api
reason_conference_ended and call_sid_ending_conference to Conference read/fetch/updateAuthy
twilio_authy_sandbox_mode headers to twilio_sandbox_mode (breaking change)Twilio-Authy-* headers to Twilio-Veriry-* (breaking change)Flex
flex_service_instance_sid to Flex ConfigurationPreview
Channels endpoint to brand a phone number for BrandedCallsServerless
Supersim
Trunking
PR #516: add troubleshooting guide. Thanks to @thinkingserious!
Library - Docs
PR #521: drop the unneeded client region when constructing requests. Thanks to @childish-sambino!
Library - Chore
Library - Feature
Api
emergency_caller_sid parameter to SIP Domaincall_reason optional property to be treated as PIIAutopilot
Contacts
Events
Numbers
Supersim
Verify
CustomCode optional parameter on Verification creation.Voice
PR #519: add details to api exception. Thanks to @ashish-s!
PR #515: remove S3 URLs from test data. Thanks to @childish-sambino!
Library - Chore
Api
call_reason in the call create requestContacts
Studio
flow_valid to flow_validateerrors and warnings from flows error response and added new property named detailswarnings attribute v2 flow POST apiTwiml
speech_model for the Gather verbRemove deactivated status for Super SIM which is replaced by inactive (breaking change)
Api
Authy
Push when updating a service to send the service level push factor configurationBulkexports
Flex
queue_stats_configuration and wfm_integrations to Flex ConfigurationServerless
Supersim
deactivated status for Super SIM which is replaced by inactive (breaking change)Added config param to Factor creation (breaking change)
Api
emergency_calling_enabled parameter to SIP Domaincall_reason in the call create requestAuthy
friendly_name and config as optional params to Factor updateconfig param to Factor creation (breaking change)Preview
SuccessRate endpoint to ImpressionsRate for Branded Calls (fka. Verified by Twilio) (breaking change)Remove FactorStrength support for Factors and Challenges (breaking change)
Authy
configuration property to services to return the service level configurationsPush when creating a service to send the service level push factor configurationMessaging
Preview
/Devices register Branded Calls endpoint, as per iOS sample app deprecation (breaking change)Twilio-Sandbox-Mode request header from the Branded Calls endpoints, as not officially supported (breaking change)Verify version from preview subdomain in favor to verify subdomain. (breaking change)Serverless
Supersim
inactive status for Super SIM which is an alias for deactivatedTaskrouter
priority in task endpointVerify
SendCodeAttempts type. It's an array of objects instead of a unique object. (breaking change)Deprecate Session API (breaking change)
Api
async_amd, async_amd_status_callback, and async_amd_status_callback_method publictrunk_sid as an optional field to Call resource fetch/read responsesqueue_time to successful response of create, fetch, and update requests for Callbyoc to conference participant create.Authy
Flex
ui_dependencies to Flex ConfigurationMessaging
Numbers
Studio
Taskrouter
longest_relative_task_age_in_queue and longest_relative_task_sid_in_queue to TaskQueue Real Time Statistics API.wait_duration_in_queue_until_accepted aggregations to TaskQueues Cumulative Statistics endpointVideo
audio_sources or the video_layout, but one of them has to be providedaudio_sources type on the composer HTTP POST command, changed from sid[] to string[] (breaking change)audio_sources or the video_layout, but one of them has to be providedMaking content retention and address retention public
Api
status enum for Messages to include 'partially_delivered'Authy
Autopilot
Verify
SendCodeAttempts to create verification response.Video
audio_sources or video_layout, but on of them has to be providedTwiml
Removed Verify v2 from preview in favor of its own namespace as GA (breaking change)
Library - Docs
Api
byoc to call create request.Flex
creation_on_message parameter documentationStudio
Verify
AppHash parameter when creating a Verification.DoNotShareWarningEnabled parameter to the Service resource.Twiml
track attribute to siprec noun.byoc to <Number>Add Regulatory Compliance CRUD APIs
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.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
Remove unsupported mixed_track value from (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 #501: add TLS 1.2 warning to README. Thanks to @eshanholtz!
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 #494: breaking: Correct video composition date and callback 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 #493: Docs cleanup, clarify .NET support. Thanks to @dprothero!
Library
Conversations
Supersim
Changed authentication method for SDK Trusted Comms endpoints: /CPS, /CurrentCall, and /Devices. Please use Authorization: Bearer (breaking change)
Numbers
Preview
/CPS, /CurrentCall, and /Devices. Please use Authorization: Bearer <xCNAM JWT> (breaking change)Voice
Message API required params updated (breaking change)
Api
Conversations
Flex
features_enabled and serverless_service_sids to Flex ConfigurationMessaging
Preview
CallSid to /BrandedCalls endpointPR #490: Update the Flex domain name to be 'flex-api'. Thanks to @childish-sambino!
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)
Insights
properties to summary.Preview
Twiml
<Conference> recording events (breaking change)PR #485: Add urls property in ice servers. Thanks to @FMV1491!
Changed phone numbers from _URL|Path_ to X-XCNAM-Sensitive headers (breaking change)
Autopilot
Preview
X-XCNAM-Sensitive headers (breaking change)Verify
MessagingConfiguration resource to verify serviceMessage API Create updated with conditional params (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 #482: Add SubscribeRule and SubscribeRulesUpdate. Thanks to @innerverse!
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.
Serverless
Wireless
imeisv to Data Session resource.Add verified property to Addresses
Api
verified property to AddressesNumbers
Proxy
Serverless - Serverless scaffolding
Serverless
PR #476: Add a comment and test to verify thread safety of async HTTP requests. Thanks to @childish-sambino!
Library
Flex
Numbers
Proxy
Remove optional if_machine call create parameter from helper libraries (breaking change)
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.Your coding agent can read these notes before it upgrades. Set up the MCP server →