CHANGES.md
Twiml
recording_configuration_id attribute to public visibility in <Conference>, <Dial>, <Record> verbs and <Recording> nounApi
Authy
/v1 — initial onboarding of Public API (/v1/protected/*), Device API (/v1/json/*), and Dashboard API (/v1/dashboard/*) behind REST Proxy using transparent proxy mode.Data-ingress
CreateDataSyncDeleteCloudAppDatasetDeleteWarehouseDataset/v1/DataSyncs/Latest (GetLatestDataSyncs)Memory
ListIdentifiers and GetIdentifierDeleteProfile, CreateIdentifier, PatchIdentifier, and DeleteIdentifier/v1/ControlPlane/Stores/{storeId} (added delete)Voice
I-Twilio-Auth-Account to downstreamRequest headers in POST /v3/Transcriptions transactions to document RestProxy account header injectionLibrary - Breaking Changes
Twiml
backgroundNoiseReduction, speechTimeout, deepgramSmartFormat, ignoreBackchannel, events attributes to <ConversationRelay>Api
Data-ingress
GetDataSync: datasetIdCloudAppSourceUpdate: configCloudAppDatasetUpdate: scheduleWarehouseSourceUpdate: configWarehouseDatasetUpdate: scheduleGetCloudAppPreviewResultGetWarehousePreviewResultGetDataSampleResult/v1/DataSyncs (ListDataSyncs, TriggerDataSync)/v1/DataSyncs/{SyncId} (GetDataSync)/v1/CloudAppSources/{SourceId}/Objects (ListCloudAppObjects)/v1/CloudAppSources/{SourceId}/Objects/{Name}/Properties (ListCloudAppObjectProperties)/v1/CloudAppSources/{SourceId}/Objects/{Name}/Preview (PreviewCloudAppObjectData)/v1/CloudAppSources/{SourceId}/Objects/{Name}/Preview/{OperationId} (GetCloudAppPreviewResult)/v1/WarehouseSources/{SourceId}/Preview (PreviewWarehouseData)/v1/WarehouseSources/{SourceId}/Preview/{OperationId} (GetWarehousePreviewResult)/v1/DataSample (TriggerDataSample)/v1/DataSample/{OperationId} (GetDataSampleResult)explode: true for query params when getting by ids and limit max items to 25Schema more specific by using oneOf without discriminator for now.Insights
/v3/InsightsDomains/* (Query + Metadata) to provide a versioned, GA-ready namespace alongside existing /preview endpoints.Mcp
/v1/docs (InvokeDocsMcp)Memory
/v1/Stores/{storeId}/Profiles/Import (ListProfileImports, CreateProfilesImport)/v1/Stores/{storeId}/Profiles/Import/{importId} (FetchProfileImport)GetProfile and GetProfileTraitsGetProfile and GetProfileTraitsPatchProfileAGENT and UNKNOWN values to ParticipantType enumUpdateTraitGroup 202 response (Operation-Id, Location, Retry-After headers; statusUrl in body)CreateDataMapping, UpdateDataMapping, DeleteDataMapping 202 responses (Operation-Id, Location, Retry-After headers; statusUrl in body)FetchProfileMemoryTraitGroupCoreTraitDefinition: displayNameUpdateProfileTraitsFetchIdentityResolutionSettingsUpdateIdentityResolutionSettingsIdentityResolutionSettingsCoreTraitGroupCoreidType optional w/ defaults for schema IdentifierConfigOperationStatus: resultData-ingress
LongRunningOperationResponseLongRunningOperationResponse to headers/v1/ControlPlane/Operations/{OperationId} (GetControlPlaneOperationStatus)Memory
/v1/ControlPlane/Operations/{operationId} (FetchOperation)Library - Feature
Library - Fix
Library - Chore
Twiml
recording_configuration to recording_configuration_id attribute in <Conference>, <Dial>, <Record> verbs and <Recording> nounAce
Api
Confirmation to Payments create endpoint to enable payment confirmation prompt before gateway submissionRequireMatchingInputs to Payments create endpoint for input confirmation in agent-assisted payment flowspayment-card-number-matcher, expiration-date-matcher, security-code-matcher, postal-code-matcher) to Payments update endpointMemory
/v1/Stores/{storeId}/Profiles/{profileId}/ConversationSummaries/{summaryId} (added patch, get)Api
Memory
/v1/Stores/{storeId}/Profiles/Imports (ListProfileImportsV2, CreateProfilesImportV2)/v1/Stores/{storeId}/Profiles/Imports/{importId} (FetchProfileImportV2)/v1/KnowledgeBases/{kbId}/Knowledge (ListKnowledge, CreateKnowledge)/v1/KnowledgeBases/{kbId}/Search (KnowledgeSearch)/v1/KnowledgeBases/{kbId}/Knowledge/{knowledgeId} (RetrieveKnowledge, PatchKnowledge, DeleteKnowledge)/v1/KnowledgeBases/{kbId}/Knowledge/{knowledgeId}/Chunks (ListKnowledgeChunks)/v1/ControlPlane/KnowledgeBases (ListKnowledgeBases, CreateKnowledgeBase)/v1/ControlPlane/KnowledgeBases/{kbId} (GetKnowledgeBase, UpdateKnowledgeBase, DeleteKnowledgeBase)Library - Chore
Twiml
recording_configuration attribute to <Recording> nounApi
type property to /IncomingPhoneNumbers resourceMemory
/v1/Stores/{storeId}/Profiles/{profileId} (added delete)Library - Fix
Library - Chore
Library - Feature
Twiml
Assistants
Autopilot
autopilot subdomain with all resources from preview.understandCompliance
/v1.Content
Marketplace
Memory
/v1/Stores/{storeId}/Profiles/{profileId}/ConversationSummaries/{summaryId} (DeleteProfileConversationSummary)/v1/Stores/{storeId}/Profiles/Imports (ListProfileImportsV2, ImportProfilesV2)/v1/Stores/{storeId}/Profiles/Imports/{importId} (GetProfileImportV2)/v1/Stores/{storeId}/Profiles/{profileId}/Observations/{observationId}/Revisions (ListObservationRevisions)Sender-ids
Trusthub
Voice
Wise_owl
contexts in Message, instead of root ChatWww
Library - Chore
Api
clientNotificationUrl for create call apiclientNotificationUrl for create participant apiLibrary - Chore
Library - Chore
Library - Feature
Trunking
Trusthub
Library - Chore
Api
twiml_session resource for callstwiml_session resource for callsMonitor
Trusthub
Memory
Twiml
<ConversationRelaySession><Recording> noun under <Start> verbAi
error as possible transcript statuserror as possible transcript statusChat
channel_status from not_participating to notParticipatingIntelligence
error enum to transcription status to better align with possible outputsjson output type to text classificationTrusthub
Accounts
Api
CallerDisplayName for participant create requestCallerDisplayName for participant create requestAccounts
Library - Chore
Insights
field with key in Request Filters and Response Metadata Filters and for Reports APILibrary - Chore
Api
CallerDisplayName for conference participant outboundto in the participant create requestLibrary - Feature
Library - Chore
Api
date_created property to media resource and date_created filtering parameters for read actionchannels property to clarify channels = # of channels in the recording resource and how to specify the # of channels in recording downloadIntelligence
Trusthub
Twiml
<AiSession>Library - Feature
Api
Library - Chore
Studio
type to Step resource APIsVerify
Library - Chore
Library - Fix
Accounts
Api
channels-whatsapp-template-marketing and channels-whatsapp-template-utility to usage categoriesConversations
state spelling for initializing enum valuestate to include intializing for ServiceConversationWithParticipants and ConversationWithParticipantsFlex
identity to web_channels API in version v2Trusthub
Verify
ienum type for Factor creationLibrary - Chore
Events
SinkSid parameter when updating subscriptions. (breaking change)Twiml
Flex
Library - Chore
Bulkexports
Conversations
method casing for ConfgurationAddress, ConversationScopedWebhook, and ServiceConversationScopedWebhook for RestProxy compatibilityProxy
Serverless
ienum to string in Logs apiTaskrouter
URL-encoded from attributes param definition in tasksTrunking
symmetric_rtp_enabled property on Trunks.Twiml
<WhatsApp> noun under <Dial> verbLibrary - Chore
Api
capabilities type object and date_created, date_updated to date_time<rfc2822>Default value from 0 to 1 in the Recordings Resource channels propertyServerless
ienum type level in Logs apiVerify
ienum type for Conversion_Status in Verify Attempts APITwiml
us2 to the list of supported values for the region attribute in the <Conference> TwiML noun.Library - Feature
Library - Chore
Api
usage_record APINumbers
Verify
ienum type for Channels in Verify Attempts APILibrary - Fix
Accounts
Api
friendly_name, date_created and date_updated properties to type string.Twiml
<ConversationRelay> and <Assistant>Library - Chore
Api
response_key for Usage Triggers fetch endpoint.Flex
webhook_ttid as optional parameter in Interactions APIServerless
Video
transcribe_participants_on_connect and transcriptions_configuration from the room resource (breaking change)transcribe_participants_on_connect and transcriptions_configuration to the room resourceLibrary - Chore
Studio
Accounts
Flex
first_name, last_name, and friendly_name from the Flex User APIMessaging
Library - Feature
Library - Chore
Api
emergency_enabled field for Address Service endpointsMessaging
Numbers
Twiml
speechModel of type enum to string (breaking change)Flex
Numbers
Trusthub
Library - Chore
Api
base/api/v2010/validation_request.json.Intelligence
Messaging
Video
Library - Fix
Api
conference/call recordings and recording_transcriptions.Events
Insights
Lookups
parnter_sub_id query parameter to the lookup requestMessaging
Numbers
Library - Chore
Library - Feature
Api
intelligence_service to transcriptionphone_number_sid to be populated for sip trunking terminating calls.Numbers
Twiml
intelligence_service to <Transcription><ConversationRelay> and <Assistant> nounevents attribute to <Dial> verbLibrary - Chore
Api
ivr-virtual-agent-custom-voices and ivr-virtual-agent-genai to usage_record API.Taskrouter
api-tag property to workers reservationapi-tag property to task reservationConversations
Api
country to fetch AvailablePhoneNumber resource by specific country.Messaging
Messaging
Numbers
Verify
SnaClientToken optional parameter on Verification check.EnableSnaClientToken optional parameter for Verification creation.Library - Chore
Accounts
Serverless
Intelligence
Numbers
Library - Chore
Iam
Numbers
Library - Chore
Api
error_code and error_message on the Message resource.transcription resourceFlex
Insights
Intelligence
words array information to the Sentences v2 entity.X-Rate-Limit-Limit, X-Rate-Limit-Remaining, and X-Rate-Limit-Config headers for Operator Results./OperatorType/{} from sid<EY> to string to support searching by SID or by nameX-Rate-Limit-Limit, X-Rate-Limit-Remaining, and X-Rate-Limit-Config headers for Transcript and Service endpoints.Messaging
Numbers
port_date field to Port In Request and Port In Phone Numbers Fetch APIsTrusthub
Verify
custom_code_enabled description on verification docsIntelligence
Api
transcription resourceFlex
Intelligence
X-Rate-Limit-Limit, X-Rate-Limit-Remaining, and X-Rate-Limit-Config as Response Headers to Operator resourcesNumbers
Twiml
<Transcription> nounLibrary - Chore
Events
status and documentation_url to Event TypesLookups
fraud lookups in V1 only to facilitate rest proxy migrationNumbers
status_last_time_updated_timestamp field to last_updated in the Get Port In Phone Number API (breaking change)Proxy
type from enum to ienumTrusthub
Api
Lookups
phone_number_quality_scoreMessaging
Library - Fix
Library - Chore
Api
Flex
plugin_versionsruntime_domain, call_recording_webhook_url, crm_callback_url, crm_fallback_url, flex_url in Flex Configurationrouting optional in Create Interactions endpointIntelligence
language_code parameter from updating service in v2 (breaking change)Numbers
/v1. (breaking change)Taskrouter
routing_target property to tasksignore_capacity property to tasksrouting_target property to tasks due to revertignore_capacity property to tasks due to revertrouting_target property to tasksignore_capacity property to tasksTrusthub
Verify
friendly_name description on service docsLibrary - Chore
Library - Docs
Flex
ui_version to web_channels APIMessaging
Numbers
Api
Flex
plugins and it to plugin_versionsLookups
pre_fill package to the lookup responseMessaging
Verify
whatsapp.msg_service_sid and whatsapp.from parameters to create, update, get and list of services endpointsVoice
Twiml
token_type value payment-method for Pay verbLibrary - Chore
Api
queue_time to conference participant resourceFlex
pluginsMedia
Messaging
Numbers
Oauth
Trusthub
Voice
Twiml
Say verb - gu-IN voicesSay verb - Niamh (en-IE) and Sofie (da-DK) voicesOauth
Note: This release contains breaking changes, check our upgrade guide for detailed migration notes.
Library - Feature
Api
Flex
plugins visibility to publicMessaging
errors attribute to the Brand Registration resource.brand_feedback attribute as deprecated.failure_reason attribute as deprecated.errors attribute is expected to provide additional information about Brand registration failures and feedback (if any has been provided by The Campaign Registry). Consumers should use this attribute instead of brand_feedback and failure_reason.Numbers
Trusthub
Twiml
Library - Chore
Api
Flex
routing_properties to Interactions Channels ParticipantLookups
line_status package to the lookup responselive_activity package from the lookup response (breaking change)Messaging
Trusthub
Twiml
Say verbLibrary - Chore
Api
CallToken for create participant apiEvents
Flex
flex_instance_sid to Flex Configurationprovisioning_status for Email Manageroffline_config to Flex ConfigurationInsights
Intelligence
Lookups
carrier field from sms_pumping_risk and leave carrier_risk_category (breaking change)Messaging
Numbers
Push
Serverless
Taskrouter
jitter_buffer_size param in update reservationTrusthub
Verify
Tags property added again to Public Docs (breaking change)Tags from Public Docs (breaking change)VerifyEventSubscriptionEnabled parameter to service create and update endpoints.Tags optional parameter on Verification creation.Library - Fix
Library - Chore
Oauth
Library - Chore
Push
Api
Events
Insights
Numbers
Taskrouter
jitter_buffer_size param in update reservationTrusthub
Verify
Tags from Public Docs (breaking change)Verify
VerifyEventSubscriptionEnabled parameter to service create and update endpoints.Library - Chore
Api
Messaging
Taskrouter
Trusthub
Verify
Tags optional parameter on Verification creation.Flex
provisioning_status for Email ManagerIntelligence
Messaging
Serverless
Verify
Library - Chore
Accounts
Api
CallToken for create participant apiFlex
offline_config to Flex ConfigurationIntelligence
redacted parameter from fetching transcript in v2 (breaking change)Lookups
phone_number_quality_score package to the lookup responsedisposable_phone_number_risk package (breaking change)Messaging
message_samples requirementsTaskrouter
virtual_start_time property to taskstask_queue_data format from map to array in the response of bulk get endpoint of TaskQueue Real Time Statistics API (breaking change)Library - Fix
Lookups
Conversations
Flex
console_errors_included to Flex Configuration field debugger_integrationsinactive in modify channel endpoint for leave functionality (breaking change)citrix_voice_vdi to Flex ConfigurationTaskrouter
Api
Flex
agent_conv_end_methods to Flex ConfigurationMessaging
Numbers
Pricing
Api
RiskCheck for SMS pumping protection feature only (public beta to be available soon): Include this parameter with a value of disable to skip any kind of risk check on the respective message requestFlex
sid<UO> path param to sid<UT> in interaction channel participant update endpoint (breaking change)Messaging
Numbers
Library - Fix
Insights
Numbers
/v2 API's. (breaking change)Verify
Api
voice-intelligence, voice-intelligence-transcription and voice-intelligence-operators to usage_record API.tts-google to usage_record API.Lookups
disposable_phone_number_risk package to the lookup responseVerify
date_created_after and date_created_before expected date format.date_created_after and date_created_before expected date format parameter on attempts summary API.WHATSAPP as optional valid parameter on attempts summary API.Twiml
statusCallback and statusCallbackMethod attributes to <Siprec>.Library - Fix
Flex
interaction_context_sid as optional parameter in Interactions APIMessaging
Numbers
/v2 of HNO API. (breaking change)/v2 of Authorization document API. (breaking change)Taskrouter
Verify
RiskCheck optional parameter on Verification creation.Twiml
Library - Fix
Lookups
reassigned_number package to the lookup responseNumbers
/v2./v1./v1.Api
content_sid as conditional parametercontent_sid as optional field (breaking change)Insights
annotation to list summary outputApi
Trim to create Conference Participant APIIntelligence
Messaging
errors attribute to us_app_to_person resource. This attribute will provide additional information about campaign registration errors.Conversations
AddressCountry parameter to Address Configuration endpoint, to support regional short code addressesstart_date, end_date and state in list Conversations resource for filteringInsights
Messaging
disable_https to link shortening domain_config propertiesNumbers
/v1.Library - Docs
Conversations
start_date, end_date and state query parameters from list operation on Conversations resource (breaking change)Messaging
messaging_service_sids and messaging_service_sid_action from domain config endpoint (breaking change)Numbers
/v1.Twiml
Say verbConversations
start_date, end_date and state in list operation on Conversations resource for sorting and filteringInsights
Lookups
disposable_phone_number_risk package (breaking change)Messaging
SOLE_PROPRIETOR brand type and SOLE_PROPRIETOR campaign use case.SOLE_PROPRIETOR brand type. Brand registration requests with STARTER brand type will be rejected.SOLE_PROPRIETOR campaign use case. Campaign registration requests with STARTER campaign use case will be rejected.Library - Fix
Library - Docs
Api
friendly_name in Available Phone Number Local, Mobile and TollFree resourcesfriendly_name in Available Phone Number Local, Mobile and TollFree resources (breaking change)Lookups
validation_results from the default_output_propertiesMessaging
linkshortening_messaging_service resourcevalidated parameter and add cert_in_validation parameter to Link Shortening API (breaking change)Supersim
matching_id and activation_code parameters to librariesLibrary - Feature
Library - Test
Library - Fix
Api
scheduled_for property from message resourcescheduled_for property to message resourceLibrary - Fix
Lookups
disposable_phone_number_risk package to the lookup responsesms_pumping_risk package to the lookup responseLibrary - Fix
Note: This release contains breaking changes, check our upgrade guide for detailed migration notes.
Library - Feature
Library - Fix
Library - Test
Library - Docs
Library - Chore
Api
public_application_connect_enabled param to Application resourceMessaging
Verify
device_ip parameter and channel auto for sna/sms orchestrationTwiml
<Application> noun and <ApplicationSid> noun, nested <Parameter> to <Hangup> and <Leave> verbLibrary - Test
Conversations
Lookups
no_data to data_not_available in identity match packageMessaging
Library - Docs
Api
street_secondary param to address create and updatemethod optional for user defined message subscription (breaking change)Flex
Media
Messaging
MessageFlow as a required field for Campaign Creation (breaking change)Oauth
Supersim
statusTwiml
<lang> element.<phoneme> element.character value for SSML <say-as> interpret-as attribute to characters. (breaking change)role attribute to format in SSML <say-as> element. (breaking change)Flex
assessments api in version v1Lookups
identity_match package to the lookup responseMessaging
validated parameter to Link Shortening APIServerless
Library - Chore
Api
Flex
base_url to 'gooddata' response in version v1Insights
answered_by field in List Call Summaryanswered_by field in call summaryFlex
v1Messaging
Twiml
Gather.Api
contentSid and contentVariables to Message resource with public visibility as BetaUserDefinedMessageSubscription and UserDefinedMessage resourceProxy
Supersim
Taskrouter
Ordering query parameter to Workers and TaskQueues for sorting byworker_sid query param for list reservations endpointTwiml
url and method attributes to <Conversation>Api
Oauth
Supersim
Verify
ga maturityTwiml
requireMatchingInputs attribute and input-matching-failed errorType to <Prompt>Api
virtual-agent to usage_record API.Twiml
Number and SipLibrary - Fix
Library - Fix
Flex
close status from Flex Interactions flow (breaking change)debugger_integration and flex_ui_status_report to Flex ConfigurationMessaging
Verify
Video
Anonymize APITwiml
event value call-in-progress to call-answeredLibrary - Test
Library - Feature
Api
beta feature from scheduling params and remove optimize parameters. (breaking change)Routes
Twiml
<lang>.Routes
Supersim
DataLimit on a FleetLibrary - Docs
Library - Feature
Flex
status, error_code, and error_message fields to Interaction Channelmessenger and gbm as supported channels for Interactions APIMessaging
Verify
code stays as the first parameter (breaking change)Library - Test
Conversations
identity as part of Participant's resource (breaking change)Lookups
enhanced_line_type from the lookup response (breaking change)Supersim
sim_ip_addresses resource to helper librariesVerify
service_sid to verify_service_sid to be consistent with list attempts API (breaking change)code optional on Verification check to support sna attempts. (breaking change)Library - Docs
Api
amazon-polly to usage_record API.Insights
annotation field in call summaryVerify
api.verify.totp beta flag and set maturity to beta for Verify TOTP properties and parameters. (breaking change)verify_service_sid to service_sid to be consistent with list attempts API (breaking change)Twiml
maxQueueSize to EnqueueLookups
Studio
Twiml
statusCallbackMethod attribute, nested <Config and <Parameter> elements to <VirtualAgent> noun.Say verb<Conversation> nounLibrary - Chore
Api
media_url to the recording resourcesVerify
silent as a channel type in the verifications API.Conversations
type in list operation on Address Configurations resourceSupersim
data_total_billed and billed_units fields to Super SIM UsageRecords API response.Eid parameter to optional to enable Activation Code download method support (breaking change)Verify
push.include_date parameter in create and update service.Api
provider_sid visibility to privateVerify
AccessTokens factor_friendly_name property.Voice
Library - Chore
Api
stream url parameter to non optionalverify-totp and verify-whatsapp-conversations-business-initiated categories to usage_record APIChat
Flex
channel_configs object to Flex ConfigurationMedia
Supersim
Taskrouter
split_by_wait_time for Cumulative Statistics EndpointVideo
status_callback_method type from enum to http_method (breaking change)status_callback and status_callback_method to compositionstatus_callback and status_callback_method to recordingLibrary - Chore
Api
Chat
X-Twilio-Wehook-Enabled header to delete method in UserChannel resourceNumbers
failure_reason in the Supporting Documents resourcesVerify
metadata parameter to "verify challenge" endpoint, so the SDK/App can attach relevant information from the device when responding to challenges.ttl and date_created properties to AccessTokens.Library - Chore
Api
uri to stream resourcea2p-registration-fee) to usage recordsNumbers
Preview
web_channels from preview to beta under flex-api (breaking change)Taskrouter
ETag as Response Header to List of Task, Reservation & WorkerVerify
metadata to factors.Twiml
Library - Chore
Library - Feature
Api
stream resourceConversations
sms and whatsappFax
Insights
call_state to call_status and remove whisper in conference participant summary (breaking change)Numbers
Supersim
ip_commands_url and ip_commands_method on Fleets resource for helper librariessim property in requests to create an SMS Command made to the /SmsCommands to accept SIM UniqueNames in addition to SIDsVerify
Library - Chore
Insights
Messaging
Verify
Library - Chore
Library - Feature
Library - Fix
Api
Messaging
Numbers
Video
Library - Feature
Api
call deleteConversations
Service Webhook Configuration resource fieldsInsights
Media
Video
EmptyRoomTimeout and UnusedRoomTimeout properties to a room; add corresponding parameters to room creationVoice
Conversations
Service Webhook Configuration resourceFlex
flex_insights_drilldown and flex_url objects to Flex ConfigurationMessaging
Supersim
Verify
factor_friendly_name parameter to the create access token endpoint.Video
Twiml
<emphasis>, <lang>, <p>, <prosody>, <s>, and <w>.<emphasis>, <lang>, <p>, <prosody>, <s>, and <w>.Library - Fix
Frontline
is_available to User's resourceMessaging
Verify
WHATSAPP to the attempts API.config.notification_platform from none to apn or fcm and viceversa for Verify Pushnone as a valid config.notification_platform value for Verify PushTwiml
<emphasis>, <lang>, <p>, <prosody>, <s>, and <w>.Library - Fix
Library - Chore
Api
media_url property to be treated as PIIMessaging
Serverless
Verify
config.notification_token parameter.TemplateCustomSubstitutions on verification creationTemplateSid parameter public for Verification resource and DefaultTemplateSid parameter public for Service resource. (breaking change)Library - Feature
Library - Fix
Api
emergency_address_status values in /IncomingPhoneNumbers response. (breaking change)emergency_address_status values in /IncomingPhoneNumbers response.Messaging
Video
AudioOnly to create roomApi
emergency_address_status attribute to /IncomingPhoneNumbers response.siprec resourceConversations
NewMessage type of push notificationsFlex
flex_insights_hr object to Flex ConfigurationNumbers
Serverless
Taskrouter
If-Match Header based on ETag for Worker Delete (breaking change)If-Match Header based on Etag for Reservation UpdateIf-Match Header based on ETag for Worker UpdateIf-Match Header based on ETag for Worker DeleteETag as Response Header to WorkerTrunking
transfer_caller_id property on Trunks.Verify
whatsapp channel.Library - Feature
Events
Messaging
Api
siprec resourcesiprec resourceMessaging
Verify
Library - Fix
Library - Chore
Api
calls-transfers) to usage recordsflex-usage) to usage recordsConversations
Order query parameter to Message resource read operationInsights
partial to enum processing_state_requestMessaging
Pricing
Verify
TemplateSid optional parameter on Verification creation.Order to the list Challenges endpoint to define the list order.Api
price, call_sid_to_coach, and uri data types for Conference, Participant, and Recording (breaking change)time_limit in the call api public. (breaking change)domain_sid in sip_credential_list_mapping and sip_ip_access_control_list_mapping APIs (breaking change)Insights
Messaging
Taskrouter
X-Rate-Limit-Limit, X-Rate-Limit-Remaining, and X-Rate-Limit-Config as Response Headers to all TaskRouter endpointsVerify
TemplateSid optional parameter on Verification creation.whatsapp as a channel type in the verifications API.Library - Chore
Conversations
Taskrouter
links to the activity resourceVerify
Version to Verify Factors Webhooks to add new fields without breaking old Webhooks.Conversations
last_read_message_index and unread_messages_count type in User Conversation's resource (breaking change)Messaging
Conversations
bindingSupersim
Taskrouter
transcribe & transcription_configuration form params in Reservation update endpoint to have private visibility (breaking change)transcribe & transcription_configuration form params to Reservation update endpointTwiml
modify event to statusCallbackEvent for <Conference>.Library - Chore
Api
status enum for Messages to include 'canceled'update_status enum for Messages to include 'canceled'Trusthub
Library - Fix
Events
Verify
challenge adding the maximum and minimum expected lengths of some fields.notification by updating the documentation of the field ttl.Library - Chore
Events
Messaging
sid field to Preregistered US App To Person responseSupersim
unique_name in Sim, Fleet, NAP resources as not PIIVideo
Library - Chore
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.Library - Fix
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
Library - Chore
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>.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
Library - Fix
Library - Chore
Events
Messaging
Studio
Verify
api.verify.totp beta feature.Twiml
<VirtualAgent> nounEvents
Messaging
Trusthub
Verify
Library - Fix
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
Twiml
refer_url and refer_method to Dial.Studio
Supersim
CommandsUrl and CommandsMethod on a FleetTwiml
status_callback and status_callback_method to Stream.Api
Conversations
last_read_message_index type in Participant's resource (breaking change)Insights
created_time to call summary.Sync
Video
Library - Fix
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.Api
RecordingTrack parameter for create calls, create participants, and create call recordingsTwiml
recordingTrack to Dial.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.Library - Chore
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.Library - Fix
Library - Feature
Library - Chore
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
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)Api
call_reason in the participant create requestMessaging
Serverless
Video
Accounts
Conversations
Events
Library - Fix
Conversations
Messaging
Numbers
Proxy
Supersim
AccountSid parameter to Sim resource update requestready status as an available status for a Sim resourceLibrary - Fix
Ai
Bulkexports
Messaging
Numbers
Routes
Trunking
transfer_mode property on Trunks.Library - Docs
Library - Chore
Conversations
Events
Proxy
Supersim
Wireless
Start and End parameters from the Data Sessions list endpoint. (breaking change)Messaging
Proxy
Verify
CustomFriendlyName optional parameter on Verification creation.Challenge resource to update documentation of both details and hidden_details properties.Api
Supersim
Library - Fix
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)Library - Fix
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.Library - Docs
Api
pstnconnectivity to usage_record APINotify
Preview
BrandsInformation endpoint now returns a single BrandsInformationSupersim
Autopilot
Contacts
Numbers
provisionally-approved as a Bundle statusPreview
kyc-apipreview API from API Definitions (breaking change)BrandsInformation endpoint to query brands information stored in KYCApi
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
Library - Fix
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
Library - Chore
Library - Feature
Preview
Dispatch version to previewStudio
Supersim
Library - Fix
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 detailsTwiml
speech_model for the Gather verbLibrary - Fix
Library - Chore
Studio
warnings attribute v2 flow POST apiLibrary - Fix
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)Library - Fix
Library - Fix
Library - Feature
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)Library - Docs
Library - Fix
Library - Feature
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)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 providedApi
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
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>Library - Fix
Numbers
Studio
Twiml
speech_model to Gather verbPreview
/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.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
Library
Api
twiml parameter for call createChat
delete method in UserChannel resourceConversations
Taskrouter
Twiml
mixed_track value from <Stream> (breaking change)<Receive> optional attributesLibrary
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> verbLibrary
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 PollyLibrary
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)Library
Conversations
Supersim
Library
Numbers
Preview
/CPS, /CurrentCall, and /Devices. Please use Authorization: Bearer <xCNAM JWT> (breaking change)Voice
Library
Api
Conversations
Flex
features_enabled and serverless_service_sids to Flex ConfigurationMessaging
Preview
CallSid to /BrandedCalls endpointLibrary
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 verbPreview
Twilio-Sandbox-Mode to mock all Voice dependenciesTwiml
<Siprec> noun<Stream> noun<Start> and <Stop>Library
Insights
properties to summary.Preview
Twiml
<Conference> recording events (breaking change)Library
Api
friendly_name optional for applications createas_of date to Usage Record API callsWireless
Library
Autopilot
Preview
X-XCNAM-Sensitive headers (breaking change)Verify
MessagingConfiguration resource to verify serviceLibrary
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 casingLibrary
Verify
approved to status enumLibrary
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)Serverless
Wireless
imeisv to Data Session resource.Library
Api
verified property to AddressesNumbers
Proxy
Library
Flex
Numbers
Proxy
Serverless
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.Library
Api
machine_detection_speech_threshold, machine_detection_speech_end_threshold, machine_detection_silence_timeout optional params to Call create requestFlex
Twiml
de1 to <Conference> regionsLibrary
Api
Authy
Iam
Verify
Video
enqueued state to CompositionTwiml
Dial noun.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.Library
Video
Twiml
language enum for Gather to fix language code for Filipino (Philippines) and include additional supported languages (breaking change)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.Chat
Proxy
Insights
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)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.Messaging
Twiml
master-card to mastercard as cardType for Pay and Prompt, remove attribute credential_sid from Pay (breaking change)Api
Proxy
Verify
Locale optional parameter on Verification creation.Api
Twiml
Pay verbLibrary
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)Preview
Video
Twiml
debug to GatherparticipantIdentity to RoomLibrary
Api
call_sid_to_coach parameter in participant to be previewPreview
totp in Authy preview endpointslatest in Authy Challenges endpointsVoice
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 resourceLibrary
Api
Chat
Preview
Actions endpoints and remove ResponseUrl from assistants on the Understand apiPricing
Preview
ttl from AssistantsStudio
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 RoomsLibrary
Twiml
Library
Api
cidr_prefix_length param to SIP IpAddresses APIStudio
Video
Library
Api
Call Recording Controls feature support in helper librariesLibrary
Api
Video
ContentDisposition when obtaining media URLs for Room Recordings and CompositionsLibrary
Twiml
Library
Chat
Lookups
fraud lookup typeLibrary
Api
Studio
Trunking
Library
Chat
Monitor
Wireless
maturity to ga for all wireless apisLibrary
Video
VideoLayout object. (breaking change)Twiml
Library
Preview
Studio
Video
size type to long. (breaking change)Lookups
fraud lookups (breaking change)Preview
BuildDuration and ErrorCode to Understand ModelBuildStudio
Api
caller_id param to Outbound Calls APItrim recording Outbound Calls API functionality in helper librariesVideo
room_sid to Composition resource.Twiml
input on GatherLibrary
toJSON methods on all instance objects to allow serialization to json and remove circular references.Studio
Important Notice
Api
trim param to Outbound Calls APILookups
fraud lookup typeNumbers
Video
SEQUENCE value to available layouts, and trim and reuse params.Api
AnnounceUrl and AnnounceMethod params for conference announceChat
Api
studio-engagements usage keyPreview
Studio
Video
SubscribedTracks.SubscribedTracks.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.Api
voip, national, shared_cost, and machine_to_machine sub-resources to /2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{IsoCountryCode}/Preview
verification_type and verification_document_sid to HostedNumberOrders.Proxy
Twiml
priority and timeout properties to Task TwiML.recording_status_callback_event for Dial verb and for ConferenceApi
Preview
status and email query param filters for AuthorizationDocument list endpointProxy
Video
media_region and video_codecsWireless
operator_mcc and operator_mnc in DataSessions subresource from integer to stringSync
data parameter on the following actions is now optional: "Update Document", "Update Map Item", "Update List Item"Video
RoomParticipant to ParticipantAccounts
Preview
iso_country as required field for creating a HostedNumberOrder.Proxy
Api
Video
ParticipantsChat
TwiML
Api
address_sid param to IncomingPhoneNumbers create and updateApi
smart_encoded param for Messagesidentity_sid param to IncomingPhoneNumbers create and updatePreview
Proxy
Wireless
ip_address to sim resourcePreview
acc_security (authy-phone-verification) initial api-definitionsTaskrouter
Chat
Notify
data, apn, gcm, fcm, sms parameters in Notifications create resource are objects instead of strings. (breaking change)Taskrouter
Video
Api
sip_registration property on SIP DomainsSync
Wireless
Api
status enum for Recordings to include 'failed'error_code property on RecordingsChat
Video
media_region parameter when creating a room, which controls which region media will be served out of.video_codec enum and video_codecs parameter, which can be set to either VP8 or H264 during room creation.Api
Chat
Preview
Sync
Api
auto_correct_address param for Addresses create and updateVideo
video_codec enum and video_codecs parameter, which can be set to either VP8 or H264 during room creation.This release adds Beta and Preview products to main artifact.
Previously, Beta and Preview products were only included in the alpha artifact. They are now being included in the main artifact to ease product discoverability and the collective operational overhead of maintaining multiple artifacts per library.
Api
encryption_type property on Recordings (breaking change)status enum for Messages to include 'accepted'Messaging
Notify
ToBinding optional parameter on Notifications resource creation. Accepted values are json strings.Preview
sms_application_sid to HostedNumberOrders.Taskrouter
jsonwebtoken from 5.4.x to 7.4.1.xmlbuilder from 8.2.2 to 9.0.1.Api
AnnounceMethod parameter naming for consistencyNotify
ToBinding optional parameter on Notifications resource creation. Accepted values are json strings.Preview
verification_attempts to HostedNumberOrders.status_callback_url and status_callback_method to HostedNumberOrders.Video
DateCreatedAfter and DateCreatedBefore.Ttl parameter (in seconds, default value is 3600).SourceSid, Status, DateCreatedAfter and DateCreatedBefore to the convenience method for retrieving Room recordings.Wireless
<Sim> to TwiML.locality field to AvailablePhoneNumbers.origin field to IncomingPhoneNumbers.inLocality parameter to AvailablePhoneNumbers.origin parameter to IncomingPhoneNumbers.getPage method for reentrant paging to all list resources.Recordings resource to RoomRecordings to avoid class name conflict (backwards incompatible).New Major Version
The newest version of the twilio-node helper library!
This version brings a host of changes to update and modernize the twilio-node helper library. It is auto-generated to produce a more consistent and correct product.