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
Removed the deprecated header-based-versioning unified specs, consolidating audiences onto the path-based api.twilio.com/v1 surface.
Library - Chore
Twiml
audio_format and sample_rate to Stream for HDCodecApi
criteria field description.readOnly on the snapshot count fields (profileCount, partitionCount) from the shared schema to the response usage sites, so the counts stay read-only in responses (no change for API consumers).Get* operations to Fetch* to match the operationId standard: FetchCohort, FetchSnapshot, FetchOperation.ExpressionId schema and made the operation error example cohort-native, so no aud_ identifiers remain in the spec.libraryVisibility: hidden across the whole surface (info, path items, and operations).api.twilio.com/v1 surface.api.twilio.com/v1.downstreamServiceName to audiences-domain.api.unified.version.preview beta feature.storeType enum from MEMORA to TWILIO.x-rate-limit to the audiences API.TwimlProcessStatusCallbackEvents parameter to CreateTwimlProcess endpointtwiml_process resource alongside twiml_session (twiml_session is deprecated and will be removed in a future release)Audiences
AdminFetchRecordAdminFetchCohortAdminFetchCohortSnapshotAdminFetchCohortOperationResourceLabelsCriteriaCreateCohortListCohortSnapshotsCreateCohortSnapshotFetchCohortSnapshotListCohortSnapshotProfilesCriteriaCohortCohortSnapshotCohortOperationResultCohortOperationFetchCohortFetchCohortSnapshotFetchCohortOperationResourceLabelsCapabilities
Conversations
Data-ingress
/v1/DataSyncs/{syncId} (FetchDataSync)/v1/CloudAppSources/{sourceId}/Objects (ListCloudAppObjects)/v1/WarehouseSources/{sourceId}/Preview (CreateWarehousePreview)/v1/WarehouseSources/{sourceId}/Preview/{operationId} (FetchWarehousePreview)/v1/DataSample/{operationId} (FetchDataSample)/v1/ControlPlane/CloudAppSources/{sourceId} (FetchCloudAppSource, PatchCloudAppSource, DeleteCloudAppSource)/v1/ControlPlane/CloudAppSources/{sourceId}/Datasets (ListCloudAppDatasets, CreateCloudAppDataset)/v1/ControlPlane/CloudAppSources/{sourceId}/Datasets/{datasetId} (FetchCloudAppDataset, PatchCloudAppDataset, DeleteCloudAppDataset)/v1/ControlPlane/WarehouseSources/{sourceId} (FetchWarehouseSource, PatchWarehouseSource, DeleteWarehouseSource)/v1/ControlPlane/WarehouseSources/{sourceId}/Datasets (ListWarehouseDatasets, CreateWarehouseDataset)/v1/DataSyncs/{SyncId} (FetchDataSync)/v1/CloudAppSources/{SourceId}/Objects (ListCloudAppObjects)/v1/WarehouseSources/{SourceId}/Preview (CreateWarehousePreview)/v1/WarehouseSources/{SourceId}/Preview/{OperationId} (FetchWarehousePreview)/v1/DataSample/{OperationId} (FetchDataSample)/v1/ControlPlane/CloudAppSources/{SourceId} (FetchCloudAppSource, PatchCloudAppSource, DeleteCloudAppSource)/v1/ControlPlane/CloudAppSources/{SourceId}/Datasets (ListCloudAppDatasets, CreateCloudAppDataset)/v1/ControlPlane/CloudAppSources/{SourceId}/Datasets/{DatasetId} (FetchCloudAppDataset, PatchCloudAppDataset, DeleteCloudAppDataset)/v1/ControlPlane/WarehouseSources/{SourceId} (FetchWarehouseSource, PatchWarehouseSource, DeleteWarehouseSource)/v1/ControlPlane/WarehouseSources/{SourceId}/Datasets (ListWarehouseDatasets, CreateWarehouseDataset)Destinations
GET from the method enum on the webhook destination type's config optionsCDP to the categories enum on DestinationTypeCreateDestinationUpdateDestinationDeleteDestinationCredentialInputDestinationCredentialOptionsListDestinationTypesGetDestinationTypeCreateDestinationUpdateDestinationListDestinationTypes and GetDestinationType unauthenticated (security: []).iamOperation, addAuthorizationHeader, and betaFeature from these operations.Iam
Intelligence
rule.operators[] parameter override field to `POST /v3/RuleExecutionsPOST /v3/RuleExecutionsKnowledge
WebSourceDetails: errorsdownstreamServiceName from memora-domain to enterprise-knowledge-domain for all operationsMemory
/v1/ControlPlane/TraitExtractionStrategies (AdminListTraitExtractionStrategies)/v1/ControlPlane/TraitExtractionStrategies/{traitStrategyId} (AdminFetchTraitExtractionStrategy)DataMappingCore description: the PATCH body requires at least one field./v1/ControlPlane/ObservationExtractionStrategies (ListObservationExtractionStrategies, CreateObservationExtractionStrategy)/v1/ControlPlane/ObservationExtractionStrategies/{observationExtractionStrategyId} (FetchObservationExtractionStrategy, UpdateObservationExtractionStrategy, DeleteObservationExtractionStrategy)CreateObservationExtractionStrategyInput description to document that at least one of allowedCategories/prohibitedCategories must be provided with a non-empty list/v1/Stores/{storeId}/Profiles/BulkDeletions (CreateProfilesBulkDeletion)UpdateStore, UpdateTraitGroup, UpdateDataMapping, and UpdateTraitExtractionStrategy now require a body with at least one property. An empty {} gets a 400.Routes
GET/POST /v3/ShortCodes/{isoCountryCode}/{shortCode} to assign and fetch the Inbound Processing Region for short codesVerify
aaguid and date_last_approved to passkeys factors metadata.Voice
Webhooks
GET /v1/Webhooks/Settings now documents each item as the full Setting rather than SettingSummary, adding auth, signature, connection and edgeZones to the list response. The service already returned these fields; only the schema understated them. Additive for consumers — no field is removed or renamed. The now-unreferenced SettingSummary schema is removed.One column per quarter.
Hid the deprecated Audiences/Snapshots paths and /preview/Operations/{operationId} .
Library - Fix
Audiences
FetchCohortSnapshot operation./preview/Audiences (AdminListAudiences)/preview/Audiences/{audienceId} (AdminGetAudience)/preview/Snapshots (AdminListSnapshots)/preview/Snapshots/{snapshotId} (AdminGetSnapshot)/preview/Operations/{operationId} (AdminGetOperation)/preview/Snapshots/{cohortSnapshotId}/Operations (AdminListSnapshotOperations)/preview/Snapshots/{snapshotId}/Operations (ListAdminSnapshotOperations)AdminGetCohort -> FetchAdminCohort) to meet standard.info libraryVisibility to hidden to exclude this admin spec from generation.pageSize/pageToken query parameters to ListAdminSnapshotOperations, the only list operation missing them./preview/Cohorts (AdminListCohorts)/preview/Cohorts/{cohortId} (AdminGetCohort)/preview/CohortSnapshots (AdminListCohortSnapshots)/preview/CohortSnapshots/{cohortSnapshotId} (AdminGetCohortSnapshot)/preview/CohortOperations/{cohortOperationId} (AdminGetCohortOperation)Get* operations to Fetch* to match the operationId standard: FetchCohort, FetchCohortSnapshot, FetchCohortOperation. The transpiler skips operations whose operationId does not start with a standard keyword, which had been dropping all three from generated output.libraryVisibility to private (was hidden) so the spec is eligible for the private docs pipeline./preview/Audiences (ListAudiences, CreateAudience)/preview/Audiences/{audienceId} (FetchAudience, UpdateAudience, DeleteAudience)/preview/Snapshots (ListSnapshots, CreateSnapshot)/preview/Snapshots/{snapshotId} (FetchSnapshot, DeleteSnapshot)/preview/Snapshots/{snapshotId}/Profiles (ListSnapshotProfiles)/preview/Operations/{operationId} (FetchOperation)Get* operations to Fetch* to match the operationId standard./preview/Operations/{operationId}.Conversations
VIDEO to the Conversations v2 Communication channel enum.Data-ingress
Destinations
prod-ie1 to supportedRealms and iamOperationEnabledRealms for all endpointsadmin-api placeholder from supportedRealms on the public endpoints;admin_openapi.yaml./v1/ControlPlane/Destinations (AdminListDestinations)/v1/ControlPlane/Destinations/{destinationId} (AdminGetDestination)/v1/ControlPlane/Subscriptions (AdminListSubscriptions)/v1/ControlPlane/Subscriptions/{subscriptionId} (AdminGetSubscription)/v1/ControlPlane/Subscriptions/{subscriptionId}/EventTypes (AdminListSubscribedEvents)/v1/ControlPlane/Subscriptions/{subscriptionId}/EventTypes/{eventType} (AdminGetSubscribedEvent)CreateDestinationDestinationType: releaseStatusDestinationType: maturity/v1/Sends/Cohorts (sendCohort)sendTransactionalsendTransactional: X-Twilio-VersionSuppressionsGroupSuppressionsGroup: typeSuppressionsGroup: modeSuppressionsGlobalSuppressionsGlobal: typeSuppressionsGlobal: modeSuppressionsLongRunningOperationResponseSendEmailSendEmail: Content-Encoding, Idempotency-KeyEnvelopeSuppressionsGroupSuppressionsGlobalIam
Instrumentation
IdempotencyKeyHeader to Create/Patch/Delete AutoInstrumentationRule; corrected the shared header's descriptionoperationId/createdAt to LongRunningOperationResponse; corrected example status from RUNNING to PENDINGSignal.timestamp → occurredAt, HourlyStats.hourTimestamp → hourAt; uppercased Signal.type and ListSignals' signalType enums to SCREAMING_SNAKE_CASEUserBehaviors request/response fields to camelCase; added the summaryDelivery webhook callbackPaginationMeta (added required key, corrected pageSize bounds) and all 6 list operations (ListEventSources, ListEventSourceDatasets, ListEventSchemas, ListAutoInstrumentationRules, ListSignals, ListSignalStats) to the meta envelope; added ListSignalStats' 500 responsesupportedRealms to dev-us1 only; POST /v1/UserBehaviors (AnalyzeUserBehaviors) keeps its own dev-us1/stage-us1 override (prod withheld pending stage validation) — every other operation is now dev-onlytdi_ TTID prefix throughout (path params, examples, transaction URLs) to events_; unified dataset/schema ID formats (tdi_dat_/tdi_dataset_ → events_dataset_, tdi_schema_ → events_evsch_); fixed rule-version examples to match the real version: integer fieldoperationId to use the domain-agnostic proc_job_ TTID prefix; corrected the OperationId parameter's length constraint (max=34 → max=35) and added a patterntdi_ prefix length: IngestEventBatch's sourceId path parameter (maxLength 37 → 40); removed the stale, redundant Twilio-Write-Key header parameterAutoInstrumentationRuleId regex patterninfo.title ("Twilio Data Ingress - Instrumentation API" → "Events Domain - Instrumentation API")/v1/UserBehaviors (AnalyzeUserBehaviors)/v1/ControlPlane/…):/v1/ControlPlane/EventSources (CreateEventSource, ListEventSources)/v1/ControlPlane/EventSources/{sourceId} (FetchEventSource, PatchEventSource, DeleteEventSource)/v1/ControlPlane/EventSources/{sourceId}/WriteKeys (CreateWriteKey, ListWriteKeys)/v1/ControlPlane/EventSources/{sourceId}/WriteKeys/{writeKey} (DeleteWriteKey)/v1/ControlPlane/EventSources/{sourceId}/Datasets (CreateEventSourceDataset, ListEventSourceDatasets)/v1/ControlPlane/EventSources/{sourceId}/Datasets/{datasetId} (FetchEventSourceDataset, PatchEventSourceDataset, DeleteEventSourceDataset)/v1/ControlPlane/EventSources/{sourceId}/EventSchemas (CreateEventSchema, ListEventSchemas)/v1/ControlPlane/EventSources/{sourceId}/EventSchemas/{schemaId} (FetchEventSchema, PatchEventSchema, DeleteEventSchema)/v1/ControlPlane/EventSources/{sourceId}/AutoInstrumentationRules (CreateAutoInstrumentationRule, ListAutoInstrumentationRules)/v1/ControlPlane/EventSources/{sourceId}/AutoInstrumentationRules/{autoInstrumentationRuleId} (FetchAutoInstrumentationRule, PatchAutoInstrumentationRule, DeleteAutoInstrumentationRule)/v1/ControlPlane/EventSources/{sourceId}/AutoInstrumentationRules/{autoInstrumentationRuleId}/Versions (ListAutoInstrumentationRuleVersions)/v1/ControlPlane/EventSources/{sourceId}/AutoInstrumentationRules/{autoInstrumentationRuleId}/Versions/{version} (FetchAutoInstrumentationRuleVersion)/v1/ControlPlane/Datasets (ListDatasets)/v1/ControlPlane/Datasets/{datasetId} (FetchDataset)/v1/ControlPlane/Operations/{operationId} (FetchControlPlaneOperationStatus)/v1/ControlPlane/Datasets (ListDatasets)/v1/ControlPlane/Datasets/{datasetId} (FetchDataset)/v1/EventSources/…):/v1/EventSources/{sourceId}/Batch (IngestEventBatch)/v1/EventSources/{sourceId}/AutoInstrumentationRules/{autoInstrumentationRuleId}/Preview (TriggerAutoInstrumentationPreview)/v1/EventSources/{sourceId}/AutoInstrumentationRules/{autoInstrumentationRuleId}/Preview/{operationId} (GetAutoInstrumentationPreviewResult)/v1/EventSources/…):/v1/EventSources/{sourceId}/Signals (IngestSignals, ListSignals)/v1/EventSources/{sourceId}/Signals/{signalKey} (GetSignalBySignalKey)/v1/EventSources/{sourceId}/SignalStats (ListSignalStats)Knowledge
KnowledgeErrorInstance, KnowledgeErrorGrouperrors field to WebSourceDetails for reporting web crawl errorsMemory
CSV and DATASET values from the DataMappingType enum.INGRESS, DATASET_CLOUDAPP, and DATASET_WAREHOUSE are the only valid values now.DataMappingFromCSV and DataMappingFromDataSet schemas and theironeOf/discriminator entries on DataMappingFromTypes, along with the correspondingCSV/DATASET discriminator mapping keys.type: CSV or type: DATASET on AdminListDataMappingsDataMappingType gains INGRESS, DATASET_CLOUDAPP, and DATASET_WAREHOUSE.CSV and DATASET remain valid and unchanged; they are deprecated aliases andDataMappingFromTypes gains three oneOf members and three discriminator keys:DataMappingFromIngress (renames DataMappingFromCSV),DataMappingFromCloudAppDataSet and DataMappingFromWarehouseDataSetDataMappingFromDataSet, distinguishing a cloud-app-backedCSV and DATASET payloads are/v1/ControlPlane/TraitExtractionStrategies (ListTraitExtractionStrategies, CreateTraitExtractionStrategy)/v1/ControlPlane/TraitExtractionStrategies/{traitStrategyId} (FetchTraitExtractionStrategy, UpdateTraitExtractionStrategy, DeleteTraitExtractionStrategy)CSV and DATASET values from the DataMappingType enum.INGRESS, DATASET_CLOUDAPP, and DATASET_WAREHOUSE are the only valid values now.DataMappingFromCSV and DataMappingFromDataSet schemas and theironeOf/discriminator entries on DataMappingFromTypes, along with the correspondingCSV/DATASET discriminator mapping keys.type: CSV or type: DATASET on CreateDataMapping orUpdateDataMapping (or filtering ListDataMappings/ListDataMappingSuggestions byDataMappingType gains INGRESS, DATASET_CLOUDAPP, and DATASET_WAREHOUSE.CSV and DATASET remain valid and unchanged; they are deprecated aliases andDataMappingFromTypes gains three oneOf members and three discriminator keys:DataMappingFromIngress (renames DataMappingFromCSV),DataMappingFromCloudAppDataSet and DataMappingFromWarehouseDataSetDataMappingFromDataSet, distinguishing a cloud-app-backedCSV and DATASET payloads areMessaging
/v1/Channels/WhatsApp/Senders) from RestProxy; the sender was routed to the sunsetting messaging-whatsapp-k8s-orch downstream. Use the Senders v2 API (/v2/Channels/Senders) instead.Verify
Templates optional parameter on Verification creation (a stringified JSON array of sid/substitutions entries). When provided, Templates takes precedence over TemplateSid.Voice
links.conversation to Transcription resources as the absolute Conversations API URL for theconversationId. It is present once the transcript has been stored; the links objectmediaUrl from CreateRequestWithMediaUrl's required fields so a request with neither sourceId nor mediaUrl reaches the downstream service, which rejects it with the specific error code 17500 instead of a generic gateway 400additionalProperties: false on both CreateRequestWithSourceId and CreateRequestWithMediaUrl so the two oneOf variants stay mutually exclusive: sourceId is undeclared on the media-URL variant and mediaUrl is undeclared on the source-ID variant, keeping every request shape resolvable to exactly one variantWebhooks
Remove <Assistant> noun from <Connect> verb as part of the AI Assistants deprecation (breaking change)
Library - Chore
Library - Fix
Twiml
<Assistant> noun from <Connect> verb as part of the AI Assistants deprecation (breaking change)passports attribute to <Dial> verb for SHAKEN/STIR passport passthroughAccounts
SuppressEmailNotification parameter to the Secondary Auth Token and Auth Token promotion endpoints. Set it to true to suppress the email notification sent to account owners and administrators. Defaults to false, preserving existing behavior.Ai
Api
uri property to the twiml_session resourceData-ingress
/v1/DataQuery (Realtime DataQuery)/v1/DataQuery (Realtime DataQuery)OAuthJWTBearerCredentials: privateKey, privateKeyPassphrase/v1/DataSyncs/{syncId} (FetchDataSync)/v1/CloudAppSources/{sourceId}/Objects (ListCloudAppObjects)/v1/WarehouseSources/{sourceId}/Preview (CreateWarehousePreview)/v1/WarehouseSources/{sourceId}/Preview/{operationId} (FetchWarehousePreview)/v1/DataSample/{operationId} (FetchDataSample)/v1/ControlPlane/CloudAppSources/{sourceId} (FetchCloudAppSource, PatchCloudAppSource, DeleteCloudAppSource)/v1/ControlPlane/CloudAppSources/{sourceId}/Datasets (ListCloudAppDatasets, CreateCloudAppDataset)/v1/ControlPlane/CloudAppSources/{sourceId}/Datasets/{datasetId} (FetchCloudAppDataset, PatchCloudAppDataset, DeleteCloudAppDataset)/v1/ControlPlane/WarehouseSources/{sourceId} (FetchWarehouseSource, PatchWarehouseSource, DeleteWarehouseSource)/v1/ControlPlane/WarehouseSources/{sourceId}/Datasets (ListWarehouseDatasets, CreateWarehouseDataset)/v1/DataSyncs/{SyncId} (FetchDataSync)/v1/CloudAppSources/{SourceId}/Objects (ListCloudAppObjects)/v1/WarehouseSources/{SourceId}/Preview (CreateWarehousePreview)/v1/WarehouseSources/{SourceId}/Preview/{OperationId} (FetchWarehousePreview)/v1/DataSample/{OperationId} (FetchDataSample)/v1/ControlPlane/CloudAppSources/{SourceId} (FetchCloudAppSource, PatchCloudAppSource, DeleteCloudAppSource)/v1/ControlPlane/CloudAppSources/{SourceId}/Datasets (ListCloudAppDatasets, CreateCloudAppDataset)/v1/ControlPlane/CloudAppSources/{SourceId}/Datasets/{DatasetId} (FetchCloudAppDataset, PatchCloudAppDataset, DeleteCloudAppDataset)/v1/ControlPlane/WarehouseSources/{SourceId} (FetchWarehouseSource, PatchWarehouseSource, DeleteWarehouseSource)/v1/ControlPlane/WarehouseSources/{SourceId}/Datasets (ListWarehouseDatasets, CreateWarehouseDataset)/v1/EventSources/{sourceId}/Signals (ListSignals)/v1/EventSources/{sourceId}/Signals/{signalKey} (GetSignalBySignalKey)/v1/EventSources/{sourceId}/SignalStats (ListSignalStats)/v1/ControlPlane/EventSources (CreateEventSource, ListEventSources)/v1/ControlPlane/EventSources/{SourceId} (FetchEventSource, PatchEventSource, DeleteEventSource)/v1/ControlPlane/EventSources/{SourceId}/WriteKeys (CreateWriteKey, ListWriteKeys)/v1/ControlPlane/EventSources/{SourceId}/WriteKeys/{WriteKey} (DeleteWriteKey)/v1/ControlPlane/EventSources/{SourceId}/Datasets (CreateEventSourceDataset, ListEventSourceDatasets)/v1/ControlPlane/EventSources/{SourceId}/Datasets/{DatasetId} (FetchEventSourceDataset, PatchEventSourceDataset, DeleteEventSourceDataset)/v1/ControlPlane/EventSources/{SourceId}/EventSchemas (CreateEventSchema, ListEventSchemas)/v1/ControlPlane/EventSources/{SourceId}/EventSchemas/{SchemaId} (FetchEventSchema, PatchEventSchema, DeleteEventSchema)/v1/ControlPlane/AutoInstrumentationRule (CreateAutoInstrumentationRule, ListAutoInstrumentationRules)/v1/ControlPlane/AutoInstrumentationRule/{AutoInstrumentationRuleId} (FetchAutoInstrumentationRule, PatchAutoInstrumentationRule, DeleteAutoInstrumentationRule)/v1/ControlPlane/AutoInstrumentationRule/{AutoInstrumentationRuleId}/Versions (ListAutoInstrumentationRuleVersions)/v1/ControlPlane/AutoInstrumentationRule/{AutoInstrumentationRuleId}/Versions/{Version} (FetchAutoInstrumentationRuleVersion)/v1/DataSyncs/{syncId} (FetchDataSync)/v1/CloudAppSources/{sourceId}/Objects (ListCloudAppObjects)/v1/WarehouseSources/{sourceId}/Preview (CreateWarehousePreview)/v1/WarehouseSources/{sourceId}/Preview/{operationId} (FetchWarehousePreview)/v1/DataSample/{operationId} (FetchDataSample)/v1/ControlPlane/CloudAppSources/{sourceId} (FetchCloudAppSource, PatchCloudAppSource, DeleteCloudAppSource)/v1/ControlPlane/CloudAppSources/{sourceId}/Datasets (ListCloudAppDatasets, CreateCloudAppDataset)/v1/ControlPlane/CloudAppSources/{sourceId}/Datasets/{datasetId} (FetchCloudAppDataset, PatchCloudAppDataset, DeleteCloudAppDataset)/v1/ControlPlane/WarehouseSources/{sourceId} (FetchWarehouseSource, PatchWarehouseSource, DeleteWarehouseSource)/v1/ControlPlane/WarehouseSources/{sourceId}/Datasets (ListWarehouseDatasets, CreateWarehouseDataset)/v1/DataSyncs/{SyncId} (FetchDataSync)/v1/CloudAppSources/{SourceId}/Objects (ListCloudAppObjects)/v1/WarehouseSources/{SourceId}/Preview (CreateWarehousePreview)/v1/WarehouseSources/{SourceId}/Preview/{OperationId} (FetchWarehousePreview)/v1/DataSample/{OperationId} (FetchDataSample)/v1/ControlPlane/CloudAppSources/{SourceId} (FetchCloudAppSource, PatchCloudAppSource, DeleteCloudAppSource)/v1/ControlPlane/CloudAppSources/{SourceId}/Datasets (ListCloudAppDatasets, CreateCloudAppDataset)/v1/ControlPlane/CloudAppSources/{SourceId}/Datasets/{DatasetId} (FetchCloudAppDataset, PatchCloudAppDataset, DeleteCloudAppDataset)/v1/ControlPlane/WarehouseSources/{SourceId} (FetchWarehouseSource, PatchWarehouseSource, DeleteWarehouseSource)/v1/ControlPlane/WarehouseSources/{SourceId}/Datasets (ListWarehouseDatasets, CreateWarehouseDataset)Deletions
POST / GET /v1/UserDataDeletions, GET /v1/UserDataDeletions/{deletionId},GET /v1/Operations/{operationId}).Destinations
ListDestinationSupportedEventTypesListDestinationSupportedEventTypes/v1/Catalog/DestinationSupportedEventTypes (ListDestinationSupportedEventTypes)/v1/ControlPlane/Subscriptions/{subscriptionId}/EventTypes (ListSubscribedEvents, CreateSubscribedEvent)/v1/ControlPlane/Subscriptions/{subscriptionId}/EventTypes/{eventType} (GetSubscribedEvent, UpdateSubscribedEvent, DeleteSubscribedEvent)/v1/ControlPlane/Subscriptions/{subscriptionId}/SubscribedEvents (ListSubscribedEvents, CreateSubscribedEvent)/v1/ControlPlane/Subscriptions/{subscriptionId}/SubscribedEvents/{eventType} (GetSubscribedEvent, UpdateSubscribedEvent, DeleteSubscribedEvent)/v1/Catalog/DestinationEventTypes (ListDestinationEventTypes)SubscriptionResponse: eventTypesDestinationType: documentationUrl, maturity, tier, categoriesmeta is now a required property in the response of ListDestinations, ListSubscriptions, and ListSubscribedEventsCreateSubscribedEvent request body schema consolidated onto SubscribedEventInput (previously SubscribedEventCreate, a duplicate schema)ListDestinations, ListSubscriptions, and ListSubscribedEvents/v1/Catalog/DestinationEventTypes (ListDestinationEventTypes)ListDestinations: namePrefixUpdateSubscriptionSubscriptionUpdate: eventTypesEvents
stage-ie1 realm support for EventTypes and Schemas endpoints (datataps-catalog)Memory
Events endpoints from the spec, as they were hidden, never implemented, and are not part of the public APIpageSize, pageToken, and orderBy query parameters to ListProfileImportsV2, plus a meta object in its response, to support pagination.ListProfileImportsV2 description to document the new pagination behavior.CreateProfilesImportV2 to match the real S3 bucket naming convention.meta.key example on ListProfileTraits's response (was profiles, now traits) to accurately describe which response field it points to.matchingRules description in IdentityResolutionSettingsCore to remove compound AND rule documentationcode from 99999 to 999999pageSize description on the pagination Meta schema to clarify it reflects the number of items actually returned, not the requested or default page size.ListProfiles response schema references from ProfileID/ProfilesMeta to IdentityProfileID/IdentityProfilesMeta (new IdentityProfilesMeta schema added; ProfileID/ProfilesMeta retained for other operations).CreateDataMappingSuggestionFetchDataMappingSuggestion/v1/ControlPlane/Stores/{storeId}/DataMappings/Suggestions (ListDataMappingSuggestions, CreateDataMappingSuggestion)/v1/ControlPlane/Stores/{storeId}/DataMappings/Suggestions/{suggestionId} (FetchDataMappingSuggestion)instance to list for all endpoints that don't end with a /{param}UpdateProfileTraitsUpdateProfileTraitsMappingTraitItem: fieldNameadditionalProperties from allof schemas since it isn't supported and causes invalid lint errors on example blocks.UpdateProfileTraitsFetchIdentityResolutionSettingsMappingTraitItem: fieldNameoccurredAt, content, or sourceUpdateProfileTraitsUpdateProfileTraitsTraitDefinition: validationRuleMappingTraitItem: fieldNameMessaging_admin
/v1/Messaging/IntelligentAlertsEvents/*, routing to intelligent-alerts-api via messaging-monkey-backend. Account SID is a required query parameter (accountSid) on all three endpoints.Release Notes Conversations update actions api visibility Memory 2026-05-07 Content updates : include store api Docs
Conversations
Memory
Set recording_configuration_id attribute to public visibility in <Conference> , <Dial> , <Record> verbs and <Recording> noun
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 injectionBump version to 6.0.0 (major version release)
Library - Breaking Changes
Library - Breaking Changes
Added stage-us1 to supportedRealms for all endpoints
Data-ingress
LongRunningOperationResponseLongRunningOperationResponse to headers/v1/ControlPlane/Operations/{OperationId} (GetControlPlaneOperationStatus)Memory
/v1/ControlPlane/Operations/{operationId} (FetchOperation)PR #1178 : upgrade axios to ^1.13.5 to remediate CVE-2026-25639 . Thanks to @Copilot !
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)Remove inequality examples from Calls StartTime and EndTime filter descriptions
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)PR #1170 : Regional API domain processing. Thanks to @manisha1997 !
Library - Chore
Twiml
recording_configuration attribute to <Recording> nounApi
type property to /IncomingPhoneNumbers resourceMemory
/v1/Stores/{storeId}/Profiles/{profileId} (added delete)PR #1169: upgrade package qs to fix CVE-2025-15284 vulnerability. Thanks to @kridai!
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
PR #1161: reinstate npm install before npm publish. Thanks to @tiwarishubham635!
Library - Chore
Api
clientNotificationUrl for create call apiclientNotificationUrl for create participant apiPR #1161: reinstate npm install before npm publish. Thanks to @tiwarishubham635!
Library - Chore
Corrected the type used for phone number capabilities when accessed through a Trunk. (breaking change)
Library - Chore
Library - Feature
Trunking
Trusthub
PR #1154: Regional API domain processing. Thanks to @manisha1997!
Library - Chore
Api
twiml_session resource for callstwiml_session resource for callsMonitor
Trusthub
Added initial Memory API endpoints with darkseagreen badge status
Memory
Add support for noun under verb
Twiml
<ConversationRelaySession><Recording> noun under <Start> verbAdd error as possible transcript status
Ai
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
Updated description for property CallerDisplayName for participant create request
Api
CallerDisplayName for participant create requestCallerDisplayName for participant create requestAccounts
PR #1139: change oauth token endpoint. Thanks to @tiwarishubham635!
Library - Chore
Insights
field with key in Request Filters and Response Metadata Filters and for Reports APIPR #1137: revert esm changes. Thanks to @manisha1997!
Library - Chore
Api
CallerDisplayName for conference participant outboundto in the participant create requestPR #1131: upgrade axios due to security vulnerability. Thanks to @tiwarishubham635!
Library - 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>Remove usage category enum from usage record and usage triggers API (breaking change)
PR #1116: upgrade typescript and typedoc version. Thanks to @tiwarishubham635!
Library - Chore
Studio
type to Step resource APIsVerify
PR #1112: add close-stale-issues workflow. Thanks to @tiwarishubham635!
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 creationRemove SinkSid parameter when updating subscriptions. (breaking change)
Library - Chore
Events
SinkSid parameter when updating subscriptions. (breaking change)Twiml
update team name for web_channel, webchat_init_token, webchat_refresh_token
PR #1091: Remove references to microvisor. Thanks to @akhani18!
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> verbPR #1097: Remove knowledge library. Thanks to @krishnakalluri!
Library - 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.PR #1088: add public key client validation. Thanks to @tiwarishubham635!
Library - Feature
Library - Chore
Api
usage_record APINumbers
Verify
ienum type for Channels in Verify Attempts APIPR #1063: Logging. Thanks to @ari-at-backbone!
Library - Fix
Accounts
Api
friendly_name, date_created and date_updated properties to type string.Twiml
<ConversationRelay> and <Assistant>PR #1078: fixed axios vulnerability by upgrading 1.7.4 to 1.8.3. Thanks to @sujay-neglur!
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 resourcePR #1083: fix message on unit tests. Thanks to @tiwarishubham635!
Library - Chore
Studio
Update Safelist API docs as part of prefix supoort
Accounts
Flex
first_name, last_name, and friendly_name from the Flex User APIMessaging
Convert Twiml Attribute speechModel of type enum to string (breaking change)
Library - Feature
Library - Chore
Api
emergency_enabled field for Address Service endpointsMessaging
Numbers
Twiml
speechModel of type enum to string (breaking change)Adding Digital Transfers APIs under v1/Interactions
Flex
Numbers
Trusthub
PR #1070: update axios version. Thanks to @manisha1997!
Library - Chore
Api
base/api/v2010/validation_request.json.Intelligence
Messaging
Video
PR #1061: validate Twilio signatures with escaped and unescaped query string values fixes #1059. Thanks to @leon19!
Library - Fix
Api
conference/call recordings and recording_transcriptions.Events
Insights
Lookups
parnter_sub_id query parameter to the lookup requestAdds validity period Default value in service resource documentation
Change beta feature flag to use v2/BulkHostedNumberOrders
PR #1058: add v22 support. Thanks to @manisha1997!
Library - Chore
Library - Feature
Add optional parameter intelligence_service to transcription
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> verbPR #1040: pass http agent options to client. Thanks to @tiwarishubham635!
Library - 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 reservationExpose ConversationWithParticipants resource that allows creating a conversation with participants
Conversations
Add response key country to fetch AvailablePhoneNumber resource by specific country.
Api
country to fetch AvailablePhoneNumber resource by specific country.Messaging
Add A2P external campaign CnpMigration flag
Messaging
Numbers
Verify
SnaClientToken optional parameter on Verification check.EnableSnaClientToken optional parameter for Verification creation.PR #1037: Sync for IoT has reached EOL; removing reference to Deployed Devices. Thanks to @wanjunsli!
Library - Chore
Accounts
Serverless
Update operator_type to include general-availablity and deprecated
Intelligence
Numbers
Change typing of Port In Request date_created field to date_time instead of date (breaking change)
Library - Chore
Iam
Numbers
PR #1030: removing preview_iam references. Thanks to @tiwarishubham635!
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 docsDeprecate account flag api.twilio-intelligence.v2
Add beta feature request managed cert
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> nounRename the status_last_time_updated_timestamp field to last_updated in the Get Port In Phone Number API (breaking change)
Library - 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
Update examples for phone_number_quality_score
Api
Lookups
phone_number_quality_scoreMessaging
Deleted language_code parameter from updating service in v2 (breaking change)
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 docsPR #1018: upgrading jsonwebtoken to fix vulnerability. Thanks to @tiwarishubham635!
Library - Chore
Library - Docs
Flex
ui_version to web_channels APIMessaging
Numbers
Correct conference filtering by date_created and date_updated documentation, clarifying that times are UTC.
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 verbPR #1014: remove media reference. Thanks to @tiwarishubham635!
Library - 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) voicesAdd new APIs for vendor authorize and token endpoints
Note: This release contains breaking changes, check our upgrade guide for detailed migration notes.
Deprecated
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
Your coding agent can read these notes before it upgrades. Set up the MCP server →