twilio 3.77.2 → 3.79.0

package/lib/rest/api/v2010/account/usage/trigger.d.ts

@@ -14,7 +14,7 @@ type TriggerRecurring = 'daily'|'monthly'|'yearly'|'alltime';
 
 type TriggerTriggerField = 'count'|'usage'|'price';
 
-type TriggerUsageCategory = 'a2p-registration-fees'|'agent-conference'|'answering-machine-detection'|'authy-authentications'|'authy-calls-outbound'|'authy-monthly-fees'|'authy-phone-intelligence'|'authy-phone-verifications'|'authy-sms-outbound'|'call-progess-events'|'calleridlookups'|'calls'|'calls-client'|'calls-globalconference'|'calls-inbound'|'calls-inbound-local'|'calls-inbound-mobile'|'calls-inbound-tollfree'|'calls-outbound'|'calls-pay-verb-transactions'|'calls-recordings'|'calls-sip'|'calls-sip-inbound'|'calls-sip-outbound'|'calls-transfers'|'carrier-lookups'|'conversations'|'conversations-api-requests'|'conversations-conversation-events'|'conversations-endpoint-connectivity'|'conversations-events'|'conversations-participant-events'|'conversations-participants'|'cps'|'flex-usage'|'fraud-lookups'|'group-rooms'|'group-rooms-data-track'|'group-rooms-encrypted-media-recorded'|'group-rooms-media-downloaded'|'group-rooms-media-recorded'|'group-rooms-media-routed'|'group-rooms-media-stored'|'group-rooms-participant-minutes'|'group-rooms-recorded-minutes'|'imp-v1-usage'|'lookups'|'marketplace'|'marketplace-algorithmia-named-entity-recognition'|'marketplace-cadence-transcription'|'marketplace-cadence-translation'|'marketplace-capio-speech-to-text'|'marketplace-convriza-ababa'|'marketplace-deepgram-phrase-detector'|'marketplace-digital-segment-business-info'|'marketplace-facebook-offline-conversions'|'marketplace-google-speech-to-text'|'marketplace-ibm-watson-message-insights'|'marketplace-ibm-watson-message-sentiment'|'marketplace-ibm-watson-recording-analysis'|'marketplace-ibm-watson-tone-analyzer'|'marketplace-icehook-systems-scout'|'marketplace-infogroup-dataaxle-bizinfo'|'marketplace-keen-io-contact-center-analytics'|'marketplace-marchex-cleancall'|'marketplace-marchex-sentiment-analysis-for-sms'|'marketplace-marketplace-nextcaller-social-id'|'marketplace-mobile-commons-opt-out-classifier'|'marketplace-nexiwave-voicemail-to-text'|'marketplace-nextcaller-advanced-caller-identification'|'marketplace-nomorobo-spam-score'|'marketplace-payfone-tcpa-compliance'|'marketplace-remeeting-automatic-speech-recognition'|'marketplace-tcpa-defense-solutions-blacklist-feed'|'marketplace-telo-opencnam'|'marketplace-truecnam-true-spam'|'marketplace-twilio-caller-name-lookup-us'|'marketplace-twilio-carrier-information-lookup'|'marketplace-voicebase-pci'|'marketplace-voicebase-transcription'|'marketplace-voicebase-transcription-custom-vocabulary'|'marketplace-whitepages-pro-caller-identification'|'marketplace-whitepages-pro-phone-intelligence'|'marketplace-whitepages-pro-phone-reputation'|'marketplace-wolfarm-spoken-results'|'marketplace-wolfram-short-answer'|'marketplace-ytica-contact-center-reporting-analytics'|'mediastorage'|'mms'|'mms-inbound'|'mms-inbound-longcode'|'mms-inbound-shortcode'|'mms-messages-carrierfees'|'mms-outbound'|'mms-outbound-longcode'|'mms-outbound-shortcode'|'monitor-reads'|'monitor-storage'|'monitor-writes'|'notify'|'notify-actions-attempts'|'notify-channels'|'number-format-lookups'|'pchat'|'pchat-users'|'peer-to-peer-rooms-participant-minutes'|'pfax'|'pfax-minutes'|'pfax-minutes-inbound'|'pfax-minutes-outbound'|'pfax-pages'|'phonenumbers'|'phonenumbers-cps'|'phonenumbers-emergency'|'phonenumbers-local'|'phonenumbers-mobile'|'phonenumbers-setups'|'phonenumbers-tollfree'|'premiumsupport'|'proxy'|'proxy-active-sessions'|'pstnconnectivity'|'pv'|'pv-composition-media-downloaded'|'pv-composition-media-encrypted'|'pv-composition-media-stored'|'pv-composition-minutes'|'pv-recording-compositions'|'pv-room-participants'|'pv-room-participants-au1'|'pv-room-participants-br1'|'pv-room-participants-ie1'|'pv-room-participants-jp1'|'pv-room-participants-sg1'|'pv-room-participants-us1'|'pv-room-participants-us2'|'pv-rooms'|'pv-sip-endpoint-registrations'|'recordings'|'recordingstorage'|'rooms-group-bandwidth'|'rooms-group-minutes'|'rooms-peer-to-peer-minutes'|'shortcodes'|'shortcodes-customerowned'|'shortcodes-mms-enablement'|'shortcodes-mps'|'shortcodes-random'|'shortcodes-uk'|'shortcodes-vanity'|'small-group-rooms'|'small-group-rooms-data-track'|'small-group-rooms-participant-minutes'|'sms'|'sms-inbound'|'sms-inbound-longcode'|'sms-inbound-shortcode'|'sms-messages-carrierfees'|'sms-messages-features'|'sms-messages-features-senderid'|'sms-outbound'|'sms-outbound-content-inspection'|'sms-outbound-longcode'|'sms-outbound-shortcode'|'speech-recognition'|'studio-engagements'|'sync'|'sync-actions'|'sync-endpoint-hours'|'sync-endpoint-hours-above-daily-cap'|'taskrouter-tasks'|'totalprice'|'transcriptions'|'trunking-cps'|'trunking-emergency-calls'|'trunking-origination'|'trunking-origination-local'|'trunking-origination-mobile'|'trunking-origination-tollfree'|'trunking-recordings'|'trunking-secure'|'trunking-termination'|'turnmegabytes'|'turnmegabytes-australia'|'turnmegabytes-brasil'|'turnmegabytes-germany'|'turnmegabytes-india'|'turnmegabytes-ireland'|'turnmegabytes-japan'|'turnmegabytes-singapore'|'turnmegabytes-useast'|'turnmegabytes-uswest'|'twilio-interconnect'|'verify-push'|'verify-totp'|'verify-whatsapp-conversations-business-initiated'|'video-recordings'|'voice-insights'|'voice-insights-client-insights-on-demand-minute'|'voice-insights-ptsn-insights-on-demand-minute'|'voice-insights-sip-interface-insights-on-demand-minute'|'voice-insights-sip-trunking-insights-on-demand-minute'|'wireless'|'wireless-orders'|'wireless-orders-artwork'|'wireless-orders-bulk'|'wireless-orders-esim'|'wireless-orders-starter'|'wireless-usage'|'wireless-usage-commands'|'wireless-usage-commands-africa'|'wireless-usage-commands-asia'|'wireless-usage-commands-centralandsouthamerica'|'wireless-usage-commands-europe'|'wireless-usage-commands-home'|'wireless-usage-commands-northamerica'|'wireless-usage-commands-oceania'|'wireless-usage-commands-roaming'|'wireless-usage-data'|'wireless-usage-data-africa'|'wireless-usage-data-asia'|'wireless-usage-data-centralandsouthamerica'|'wireless-usage-data-custom-additionalmb'|'wireless-usage-data-custom-first5mb'|'wireless-usage-data-domestic-roaming'|'wireless-usage-data-europe'|'wireless-usage-data-individual-additionalgb'|'wireless-usage-data-individual-firstgb'|'wireless-usage-data-international-roaming-canada'|'wireless-usage-data-international-roaming-india'|'wireless-usage-data-international-roaming-mexico'|'wireless-usage-data-northamerica'|'wireless-usage-data-oceania'|'wireless-usage-data-pooled'|'wireless-usage-data-pooled-downlink'|'wireless-usage-data-pooled-uplink'|'wireless-usage-mrc'|'wireless-usage-mrc-custom'|'wireless-usage-mrc-individual'|'wireless-usage-mrc-pooled'|'wireless-usage-mrc-suspended'|'wireless-usage-sms'|'wireless-usage-voice';
+type TriggerUsageCategory = 'a2p-registration-fees'|'agent-conference'|'amazon-polly'|'answering-machine-detection'|'authy-authentications'|'authy-calls-outbound'|'authy-monthly-fees'|'authy-phone-intelligence'|'authy-phone-verifications'|'authy-sms-outbound'|'call-progess-events'|'calleridlookups'|'calls'|'calls-client'|'calls-globalconference'|'calls-inbound'|'calls-inbound-local'|'calls-inbound-mobile'|'calls-inbound-tollfree'|'calls-outbound'|'calls-pay-verb-transactions'|'calls-recordings'|'calls-sip'|'calls-sip-inbound'|'calls-sip-outbound'|'calls-transfers'|'carrier-lookups'|'conversations'|'conversations-api-requests'|'conversations-conversation-events'|'conversations-endpoint-connectivity'|'conversations-events'|'conversations-participant-events'|'conversations-participants'|'cps'|'flex-usage'|'fraud-lookups'|'group-rooms'|'group-rooms-data-track'|'group-rooms-encrypted-media-recorded'|'group-rooms-media-downloaded'|'group-rooms-media-recorded'|'group-rooms-media-routed'|'group-rooms-media-stored'|'group-rooms-participant-minutes'|'group-rooms-recorded-minutes'|'imp-v1-usage'|'lookups'|'marketplace'|'marketplace-algorithmia-named-entity-recognition'|'marketplace-cadence-transcription'|'marketplace-cadence-translation'|'marketplace-capio-speech-to-text'|'marketplace-convriza-ababa'|'marketplace-deepgram-phrase-detector'|'marketplace-digital-segment-business-info'|'marketplace-facebook-offline-conversions'|'marketplace-google-speech-to-text'|'marketplace-ibm-watson-message-insights'|'marketplace-ibm-watson-message-sentiment'|'marketplace-ibm-watson-recording-analysis'|'marketplace-ibm-watson-tone-analyzer'|'marketplace-icehook-systems-scout'|'marketplace-infogroup-dataaxle-bizinfo'|'marketplace-keen-io-contact-center-analytics'|'marketplace-marchex-cleancall'|'marketplace-marchex-sentiment-analysis-for-sms'|'marketplace-marketplace-nextcaller-social-id'|'marketplace-mobile-commons-opt-out-classifier'|'marketplace-nexiwave-voicemail-to-text'|'marketplace-nextcaller-advanced-caller-identification'|'marketplace-nomorobo-spam-score'|'marketplace-payfone-tcpa-compliance'|'marketplace-remeeting-automatic-speech-recognition'|'marketplace-tcpa-defense-solutions-blacklist-feed'|'marketplace-telo-opencnam'|'marketplace-truecnam-true-spam'|'marketplace-twilio-caller-name-lookup-us'|'marketplace-twilio-carrier-information-lookup'|'marketplace-voicebase-pci'|'marketplace-voicebase-transcription'|'marketplace-voicebase-transcription-custom-vocabulary'|'marketplace-whitepages-pro-caller-identification'|'marketplace-whitepages-pro-phone-intelligence'|'marketplace-whitepages-pro-phone-reputation'|'marketplace-wolfarm-spoken-results'|'marketplace-wolfram-short-answer'|'marketplace-ytica-contact-center-reporting-analytics'|'mediastorage'|'mms'|'mms-inbound'|'mms-inbound-longcode'|'mms-inbound-shortcode'|'mms-messages-carrierfees'|'mms-outbound'|'mms-outbound-longcode'|'mms-outbound-shortcode'|'monitor-reads'|'monitor-storage'|'monitor-writes'|'notify'|'notify-actions-attempts'|'notify-channels'|'number-format-lookups'|'pchat'|'pchat-users'|'peer-to-peer-rooms-participant-minutes'|'pfax'|'pfax-minutes'|'pfax-minutes-inbound'|'pfax-minutes-outbound'|'pfax-pages'|'phonenumbers'|'phonenumbers-cps'|'phonenumbers-emergency'|'phonenumbers-local'|'phonenumbers-mobile'|'phonenumbers-setups'|'phonenumbers-tollfree'|'premiumsupport'|'proxy'|'proxy-active-sessions'|'pstnconnectivity'|'pv'|'pv-composition-media-downloaded'|'pv-composition-media-encrypted'|'pv-composition-media-stored'|'pv-composition-minutes'|'pv-recording-compositions'|'pv-room-participants'|'pv-room-participants-au1'|'pv-room-participants-br1'|'pv-room-participants-ie1'|'pv-room-participants-jp1'|'pv-room-participants-sg1'|'pv-room-participants-us1'|'pv-room-participants-us2'|'pv-rooms'|'pv-sip-endpoint-registrations'|'recordings'|'recordingstorage'|'rooms-group-bandwidth'|'rooms-group-minutes'|'rooms-peer-to-peer-minutes'|'shortcodes'|'shortcodes-customerowned'|'shortcodes-mms-enablement'|'shortcodes-mps'|'shortcodes-random'|'shortcodes-uk'|'shortcodes-vanity'|'small-group-rooms'|'small-group-rooms-data-track'|'small-group-rooms-participant-minutes'|'sms'|'sms-inbound'|'sms-inbound-longcode'|'sms-inbound-shortcode'|'sms-messages-carrierfees'|'sms-messages-features'|'sms-messages-features-senderid'|'sms-outbound'|'sms-outbound-content-inspection'|'sms-outbound-longcode'|'sms-outbound-shortcode'|'speech-recognition'|'studio-engagements'|'sync'|'sync-actions'|'sync-endpoint-hours'|'sync-endpoint-hours-above-daily-cap'|'taskrouter-tasks'|'totalprice'|'transcriptions'|'trunking-cps'|'trunking-emergency-calls'|'trunking-origination'|'trunking-origination-local'|'trunking-origination-mobile'|'trunking-origination-tollfree'|'trunking-recordings'|'trunking-secure'|'trunking-termination'|'turnmegabytes'|'turnmegabytes-australia'|'turnmegabytes-brasil'|'turnmegabytes-germany'|'turnmegabytes-india'|'turnmegabytes-ireland'|'turnmegabytes-japan'|'turnmegabytes-singapore'|'turnmegabytes-useast'|'turnmegabytes-uswest'|'twilio-interconnect'|'verify-push'|'verify-totp'|'verify-whatsapp-conversations-business-initiated'|'video-recordings'|'voice-insights'|'voice-insights-client-insights-on-demand-minute'|'voice-insights-ptsn-insights-on-demand-minute'|'voice-insights-sip-interface-insights-on-demand-minute'|'voice-insights-sip-trunking-insights-on-demand-minute'|'wireless'|'wireless-orders'|'wireless-orders-artwork'|'wireless-orders-bulk'|'wireless-orders-esim'|'wireless-orders-starter'|'wireless-usage'|'wireless-usage-commands'|'wireless-usage-commands-africa'|'wireless-usage-commands-asia'|'wireless-usage-commands-centralandsouthamerica'|'wireless-usage-commands-europe'|'wireless-usage-commands-home'|'wireless-usage-commands-northamerica'|'wireless-usage-commands-oceania'|'wireless-usage-commands-roaming'|'wireless-usage-data'|'wireless-usage-data-africa'|'wireless-usage-data-asia'|'wireless-usage-data-centralandsouthamerica'|'wireless-usage-data-custom-additionalmb'|'wireless-usage-data-custom-first5mb'|'wireless-usage-data-domestic-roaming'|'wireless-usage-data-europe'|'wireless-usage-data-individual-additionalgb'|'wireless-usage-data-individual-firstgb'|'wireless-usage-data-international-roaming-canada'|'wireless-usage-data-international-roaming-india'|'wireless-usage-data-international-roaming-mexico'|'wireless-usage-data-northamerica'|'wireless-usage-data-oceania'|'wireless-usage-data-pooled'|'wireless-usage-data-pooled-downlink'|'wireless-usage-data-pooled-uplink'|'wireless-usage-mrc'|'wireless-usage-mrc-custom'|'wireless-usage-mrc-individual'|'wireless-usage-mrc-pooled'|'wireless-usage-mrc-suspended'|'wireless-usage-sms'|'wireless-usage-voice';
 
 /**
  * Initialize the TriggerList

package/lib/rest/conversations/v1/conversation/participant.js

@@ -505,7 +505,8 @@ ParticipantPage.prototype[util.inspect.custom] = function inspect(depth,
  * @param {ParticipantPayload} payload - The instance payload
  * @param {sid} conversationSid -
  *          The unique ID of the Conversation for this participant.
- * @param {sid} sid - A 34 character string that uniquely identifies this resource.
+ * @param {sid_like} sid -
+ *          A 34 character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 ParticipantInstance = function ParticipantInstance(version, payload,
@@ -651,7 +652,8 @@ ParticipantInstance.prototype[util.inspect.custom] = function inspect(depth,
  * @param {V1} version - Version of the resource
  * @param {sid_like} conversationSid -
  *          The unique ID of the Conversation for this participant.
- * @param {sid} sid - A 34 character string that uniquely identifies this resource.
+ * @param {sid_like} sid -
+ *          A 34 character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 ParticipantContext = function ParticipantContext(version, conversationSid, sid)

package/lib/rest/conversations/v1/service/conversation/participant.js

@@ -527,7 +527,8 @@ ParticipantPage.prototype[util.inspect.custom] = function inspect(depth,
  *          The SID of the Conversation Service that the resource is associated with.
  * @param {sid} conversationSid -
  *          The unique ID of the Conversation for this participant.
- * @param {sid} sid - A 34 character string that uniquely identifies this resource.
+ * @param {sid_like} sid -
+ *          A 34 character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 ParticipantInstance = function ParticipantInstance(version, payload,
@@ -682,7 +683,8 @@ ParticipantInstance.prototype[util.inspect.custom] = function inspect(depth,
  *          The SID of the Conversation Service that the resource is associated with.
  * @param {sid_like} conversationSid -
  *          The unique ID of the Conversation for this participant.
- * @param {sid} sid - A 34 character string that uniquely identifies this resource.
+ * @param {sid_like} sid -
+ *          A 34 character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 ParticipantContext = function ParticipantContext(version, chatServiceSid,

package/lib/rest/insights/V1.d.ts

@@ -7,8 +7,6 @@
 
 import Insights = require('../Insights');
 import Version = require('../../base/Version');
-import { AnnotationList } from './v1/annotation';
-import { AnnotationListInstance } from './v1/annotation';
 import { CallList } from './v1/call';
 import { CallListInstance } from './v1/call';
 import { CallSummariesList } from './v1/callSummaries';
@@ -29,7 +27,6 @@ declare class V1 extends Version {
    */
   constructor(domain: Insights);
 
-  readonly annotation: AnnotationListInstance;
   readonly callSummaries: CallSummariesListInstance;
   readonly calls: CallListInstance;
   readonly conferences: ConferenceListInstance;

package/lib/rest/insights/V1.js

@@ -10,7 +10,6 @@
 /* jshint ignore:end */
 
 var _ = require('lodash');  /* jshint ignore:line */
-var AnnotationList = require('./v1/annotation').AnnotationList;
 var CallList = require('./v1/call').CallList;
 var CallSummariesList = require('./v1/callSummaries').CallSummariesList;
 var ConferenceList = require('./v1/conference').ConferenceList;
@@ -26,7 +25,6 @@ var Version = require('../../base/Version');  /* jshint ignore:line */
  * @constructor Twilio.Insights.V1
  *
  * @property {Twilio.Insights.V1.SettingList} settings - settings resource
- * @property {Twilio.Insights.V1.AnnotationList} annotation - annotation resource
  * @property {Twilio.Insights.V1.CallList} calls - calls resource
  * @property {Twilio.Insights.V1.CallSummariesList} callSummaries -
  *          callSummaries resource
@@ -41,7 +39,6 @@ function V1(domain) {
 
   // Resources
   this._settings = undefined;
-  this._annotation = undefined;
   this._calls = undefined;
   this._callSummaries = undefined;
   this._conferences = undefined;
@@ -59,14 +56,6 @@ Object.defineProperty(V1.prototype,
     }
 });
 
-Object.defineProperty(V1.prototype,
-  'annotation', {
-    get: function() {
-      this._annotation = this._annotation || new AnnotationList(this);
-      return this._annotation;
-    }
-});
-
 Object.defineProperty(V1.prototype,
   'calls', {
     get: function() {

package/lib/rest/insights/v1/{annotation.d.ts → call/annotation.d.ts}

@@ -5,10 +5,10 @@
  *       /       /
  */
 
-import Page = require('../../../base/Page');
-import Response = require('../../../http/response');
-import V1 = require('../V1');
-import { SerializableClass } from '../../../interfaces';
+import Page = require('../../../../base/Page');
+import Response = require('../../../../http/response');
+import V1 = require('../../V1');
+import { SerializableClass } from '../../../../interfaces';
 
 type AnnotationAnsweredBy = 'unknown_answered_by'|'human'|'machine';
 
@@ -19,20 +19,24 @@ type AnnotationQualityIssues = 'unknown_quality_issue'|'no_quality_issue'|'low_v
 /**
  * Initialize the AnnotationList
  *
+ * PLEASE NOTE that this class contains beta products that are subject to change.
+ * Use them with caution.
+ *
  * @param version - Version of the resource
+ * @param callSid - Call SID.
  */
-declare function AnnotationList(version: V1): AnnotationListInstance;
+declare function AnnotationList(version: V1, callSid: string): AnnotationListInstance;
 
 /**
  * Options to pass to update
  *
- * @property answeredBy - The answered_by
- * @property callScore - The call_score
- * @property comment - The comment
- * @property connectivityIssue - The connectivity_issue
- * @property incident - The incident
- * @property qualityIssues - The quality_issues
- * @property spam - The spam
+ * @property answeredBy - Indicates the answering entity as determined by Answering Machine Detection.
+ * @property callScore - Call Score
+ * @property comment - User comments
+ * @property connectivityIssue - Indicates if the call had any connectivity issue
+ * @property incident - Call tag for incidents or support ticket
+ * @property qualityIssues - Indicates if the call had audio quality issues.
+ * @property spam - Call spam indicator
  */
 interface AnnotationInstanceUpdateOptions {
   answeredBy?: AnnotationAnsweredBy;
@@ -51,10 +55,8 @@ interface AnnotationListInstance {
   (sid: string): AnnotationContext;
   /**
    * Constructs a annotation
-   *
-   * @param callSid - The call_sid
    */
-  get(callSid: string): AnnotationContext;
+  get(): AnnotationContext;
   /**
    * Provide a user-friendly representation
    */
@@ -78,6 +80,7 @@ interface AnnotationResource {
 }
 
 interface AnnotationSolution {
+  callSid?: string;
 }
 
 
@@ -85,8 +88,11 @@ declare class AnnotationContext {
   /**
    * Initialize the AnnotationContext
    *
+   * PLEASE NOTE that this class contains beta products that are subject to change.
+   * Use them with caution.
+   *
    * @param version - Version of the resource
-   * @param callSid - The call_sid
+   * @param callSid - Call SID.
    */
   constructor(version: V1, callSid: string);
 
@@ -120,9 +126,12 @@ declare class AnnotationInstance extends SerializableClass {
   /**
    * Initialize the AnnotationContext
    *
+   * PLEASE NOTE that this class contains beta products that are subject to change.
+   * Use them with caution.
+   *
    * @param version - Version of the resource
    * @param payload - The instance payload
-   * @param callSid - The call_sid
+   * @param callSid - Call SID.
    */
   constructor(version: V1, payload: AnnotationPayload, callSid: string);
 
@@ -167,6 +176,9 @@ declare class AnnotationPage extends Page<V1, AnnotationPayload, AnnotationResou
   /**
    * Initialize the AnnotationPage
    *
+   * PLEASE NOTE that this class contains beta products that are subject to change.
+   * Use them with caution.
+   *
    * @param version - Version of the resource
    * @param response - Response from the API
    * @param solution - Path solution

package/lib/rest/insights/v1/{annotation.js → call/annotation.js}

@@ -12,11 +12,11 @@
 var Q = require('q');  /* jshint ignore:line */
 var _ = require('lodash');  /* jshint ignore:line */
 var util = require('util');  /* jshint ignore:line */
-var Page = require('../../../base/Page');  /* jshint ignore:line */
+var Page = require('../../../../base/Page');  /* jshint ignore:line */
 var deserialize = require(
-    '../../../base/deserialize');  /* jshint ignore:line */
-var serialize = require('../../../base/serialize');  /* jshint ignore:line */
-var values = require('../../../base/values');  /* jshint ignore:line */
+    '../../../../base/deserialize');  /* jshint ignore:line */
+var serialize = require('../../../../base/serialize');  /* jshint ignore:line */
+var values = require('../../../../base/values');  /* jshint ignore:line */
 
 var AnnotationList;
 var AnnotationPage;
@@ -27,20 +27,24 @@ var AnnotationContext;
 /**
  * Initialize the AnnotationList
  *
- * @constructor Twilio.Insights.V1.AnnotationList
+ * PLEASE NOTE that this class contains beta products that are subject to change.
+ * Use them with caution.
+ *
+ * @constructor Twilio.Insights.V1.CallContext.AnnotationList
  *
  * @param {Twilio.Insights.V1} version - Version of the resource
+ * @param {string} callSid - Call SID.
  */
 /* jshint ignore:end */
-AnnotationList = function AnnotationList(version) {
+AnnotationList = function AnnotationList(version, callSid) {
   /* jshint ignore:start */
   /**
    * @function annotation
-   * @memberof Twilio.Insights.V1#
+   * @memberof Twilio.Insights.V1.CallContext#
    *
    * @param {string} sid - sid of instance
    *
-   * @returns {Twilio.Insights.V1.AnnotationContext}
+   * @returns {Twilio.Insights.V1.CallContext.AnnotationContext}
    */
   /* jshint ignore:end */
   function AnnotationListInstance(sid) {
@@ -49,21 +53,19 @@ AnnotationList = function AnnotationList(version) {
 
   AnnotationListInstance._version = version;
   // Path Solution
-  AnnotationListInstance._solution = {};
+  AnnotationListInstance._solution = {callSid: callSid};
   /* jshint ignore:start */
   /**
    * Constructs a annotation
    *
    * @function get
-   * @memberof Twilio.Insights.V1.AnnotationList#
-   *
-   * @param {string} callSid - The call_sid
+   * @memberof Twilio.Insights.V1.CallContext.AnnotationList#
    *
-   * @returns {Twilio.Insights.V1.AnnotationContext}
+   * @returns {Twilio.Insights.V1.CallContext.AnnotationContext}
    */
   /* jshint ignore:end */
-  AnnotationListInstance.get = function get(callSid) {
-    return new AnnotationContext(this._version, callSid);
+  AnnotationListInstance.get = function get() {
+    return new AnnotationContext(this._version, this._solution.callSid);
   };
 
   /* jshint ignore:start */
@@ -71,7 +73,7 @@ AnnotationList = function AnnotationList(version) {
    * Provide a user-friendly representation
    *
    * @function toJSON
-   * @memberof Twilio.Insights.V1.AnnotationList#
+   * @memberof Twilio.Insights.V1.CallContext.AnnotationList#
    *
    * @returns Object
    */
@@ -92,7 +94,10 @@ AnnotationList = function AnnotationList(version) {
 /**
  * Initialize the AnnotationPage
  *
- * @constructor Twilio.Insights.V1.AnnotationPage
+ * PLEASE NOTE that this class contains beta products that are subject to change.
+ * Use them with caution.
+ *
+ * @constructor Twilio.Insights.V1.CallContext.AnnotationPage
  *
  * @param {V1} version - Version of the resource
  * @param {Response<string>} response - Response from the API
@@ -116,7 +121,7 @@ AnnotationPage.prototype.constructor = AnnotationPage;
  * Build an instance of AnnotationInstance
  *
  * @function getInstance
- * @memberof Twilio.Insights.V1.AnnotationPage#
+ * @memberof Twilio.Insights.V1.CallContext.AnnotationPage#
  *
  * @param {AnnotationPayload} payload - Payload response from the API
  *
@@ -124,7 +129,7 @@ AnnotationPage.prototype.constructor = AnnotationPage;
  */
 /* jshint ignore:end */
 AnnotationPage.prototype.getInstance = function getInstance(payload) {
-  return new AnnotationInstance(this._version, payload);
+  return new AnnotationInstance(this._version, payload, this._solution.callSid);
 };
 
 /* jshint ignore:start */
@@ -132,7 +137,7 @@ AnnotationPage.prototype.getInstance = function getInstance(payload) {
  * Provide a user-friendly representation
  *
  * @function toJSON
- * @memberof Twilio.Insights.V1.AnnotationPage#
+ * @memberof Twilio.Insights.V1.CallContext.AnnotationPage#
  *
  * @returns Object
  */
@@ -157,23 +162,28 @@ AnnotationPage.prototype[util.inspect.custom] = function inspect(depth, options)
 /**
  * Initialize the AnnotationContext
  *
- * @constructor Twilio.Insights.V1.AnnotationInstance
+ * PLEASE NOTE that this class contains beta products that are subject to change.
+ * Use them with caution.
  *
- * @property {string} callSid - The call_sid
- * @property {string} accountSid - The account_sid
- * @property {annotation.answered_by} answeredBy - The answered_by
+ * @constructor Twilio.Insights.V1.CallContext.AnnotationInstance
+ *
+ * @property {string} callSid - Call SID.
+ * @property {string} accountSid - Account SID.
+ * @property {annotation.answered_by} answeredBy -
+ *          Indicates the answering entity as determined by Answering Machine Detection.
  * @property {annotation.connectivity_issue} connectivityIssue -
- *          The connectivity_issue
- * @property {string} qualityIssues - The quality_issues
- * @property {boolean} spam - The spam
- * @property {number} callScore - The call_score
- * @property {string} comment - The comment
- * @property {string} incident - The incident
- * @property {string} url - The url
+ *          Indicates if the call had any connectivity issue
+ * @property {string} qualityIssues -
+ *          Indicates if the call had audio quality issues.
+ * @property {boolean} spam - Call spam indicator
+ * @property {number} callScore - Call Score
+ * @property {string} comment - User comments
+ * @property {string} incident - Call tag for incidents or support ticket
+ * @property {string} url - The URL of this resource.
  *
  * @param {V1} version - Version of the resource
  * @param {AnnotationPayload} payload - The instance payload
- * @param {sid} callSid - The call_sid
+ * @param {sid} callSid - Call SID.
  */
 /* jshint ignore:end */
 AnnotationInstance = function AnnotationInstance(version, payload, callSid) {
@@ -193,7 +203,7 @@ AnnotationInstance = function AnnotationInstance(version, payload, callSid) {
 
   // Context
   this._context = undefined;
-  this._solution = {callSid: callSid || this.callSid, };
+  this._solution = {callSid: callSid, };
 };
 
 Object.defineProperty(AnnotationInstance.prototype,
@@ -212,17 +222,19 @@ Object.defineProperty(AnnotationInstance.prototype,
  * update a AnnotationInstance
  *
  * @function update
- * @memberof Twilio.Insights.V1.AnnotationInstance#
+ * @memberof Twilio.Insights.V1.CallContext.AnnotationInstance#
  *
  * @param {object} [opts] - Options for request
- * @param {annotation.answered_by} [opts.answeredBy] - The answered_by
+ * @param {annotation.answered_by} [opts.answeredBy] -
+ *          Indicates the answering entity as determined by Answering Machine Detection.
  * @param {annotation.connectivity_issue} [opts.connectivityIssue] -
- *          The connectivity_issue
- * @param {string} [opts.qualityIssues] - The quality_issues
- * @param {boolean} [opts.spam] - The spam
- * @param {number} [opts.callScore] - The call_score
- * @param {string} [opts.comment] - The comment
- * @param {string} [opts.incident] - The incident
+ *          Indicates if the call had any connectivity issue
+ * @param {string} [opts.qualityIssues] -
+ *          Indicates if the call had audio quality issues.
+ * @param {boolean} [opts.spam] - Call spam indicator
+ * @param {number} [opts.callScore] - Call Score
+ * @param {string} [opts.comment] - User comments
+ * @param {string} [opts.incident] - Call tag for incidents or support ticket
  * @param {function} [callback] - Callback to handle processed record
  *
  * @returns {Promise} Resolves to processed AnnotationInstance
@@ -237,7 +249,7 @@ AnnotationInstance.prototype.update = function update(opts, callback) {
  * fetch a AnnotationInstance
  *
  * @function fetch
- * @memberof Twilio.Insights.V1.AnnotationInstance#
+ * @memberof Twilio.Insights.V1.CallContext.AnnotationInstance#
  *
  * @param {function} [callback] - Callback to handle processed record
  *
@@ -253,7 +265,7 @@ AnnotationInstance.prototype.fetch = function fetch(callback) {
  * Provide a user-friendly representation
  *
  * @function toJSON
- * @memberof Twilio.Insights.V1.AnnotationInstance#
+ * @memberof Twilio.Insights.V1.CallContext.AnnotationInstance#
  *
  * @returns Object
  */
@@ -278,10 +290,13 @@ AnnotationInstance.prototype[util.inspect.custom] = function inspect(depth,
 /**
  * Initialize the AnnotationContext
  *
- * @constructor Twilio.Insights.V1.AnnotationContext
+ * PLEASE NOTE that this class contains beta products that are subject to change.
+ * Use them with caution.
+ *
+ * @constructor Twilio.Insights.V1.CallContext.AnnotationContext
  *
  * @param {V1} version - Version of the resource
- * @param {sid} callSid - The call_sid
+ * @param {sid} callSid - Call SID.
  */
 /* jshint ignore:end */
 AnnotationContext = function AnnotationContext(version, callSid) {
@@ -297,17 +312,19 @@ AnnotationContext = function AnnotationContext(version, callSid) {
  * update a AnnotationInstance
  *
  * @function update
- * @memberof Twilio.Insights.V1.AnnotationContext#
+ * @memberof Twilio.Insights.V1.CallContext.AnnotationContext#
  *
  * @param {object} [opts] - Options for request
- * @param {annotation.answered_by} [opts.answeredBy] - The answered_by
+ * @param {annotation.answered_by} [opts.answeredBy] -
+ *          Indicates the answering entity as determined by Answering Machine Detection.
  * @param {annotation.connectivity_issue} [opts.connectivityIssue] -
- *          The connectivity_issue
- * @param {string} [opts.qualityIssues] - The quality_issues
- * @param {boolean} [opts.spam] - The spam
- * @param {number} [opts.callScore] - The call_score
- * @param {string} [opts.comment] - The comment
- * @param {string} [opts.incident] - The incident
+ *          Indicates if the call had any connectivity issue
+ * @param {string} [opts.qualityIssues] -
+ *          Indicates if the call had audio quality issues.
+ * @param {boolean} [opts.spam] - Call spam indicator
+ * @param {number} [opts.callScore] - Call Score
+ * @param {string} [opts.comment] - User comments
+ * @param {string} [opts.incident] - Call tag for incidents or support ticket
  * @param {function} [callback] - Callback to handle processed record
  *
  * @returns {Promise} Resolves to processed AnnotationInstance
@@ -353,7 +370,7 @@ AnnotationContext.prototype.update = function update(opts, callback) {
  * fetch a AnnotationInstance
  *
  * @function fetch
- * @memberof Twilio.Insights.V1.AnnotationContext#
+ * @memberof Twilio.Insights.V1.CallContext.AnnotationContext#
  *
  * @param {function} [callback] - Callback to handle processed record
  *
@@ -384,7 +401,7 @@ AnnotationContext.prototype.fetch = function fetch(callback) {
  * Provide a user-friendly representation
  *
  * @function toJSON
- * @memberof Twilio.Insights.V1.AnnotationContext#
+ * @memberof Twilio.Insights.V1.CallContext.AnnotationContext#
  *
  * @returns Object
  */

package/lib/rest/insights/v1/call/summary.d.ts

@@ -53,6 +53,7 @@ interface CallSummaryPayload extends CallSummaryResource, Page.TwilioResponsePay
 
 interface CallSummaryResource {
   account_sid: string;
+  annotation: object;
   attributes: object;
   call_sid: string;
   call_state: CallSummaryCallState;
@@ -121,6 +122,7 @@ declare class CallSummaryInstance extends SerializableClass {
 
   private _proxy: CallSummaryContext;
   accountSid: string;
+  annotation: any;
   attributes: any;
   callSid: string;
   callState: CallSummaryCallState;

package/lib/rest/insights/v1/call/summary.js

@@ -179,6 +179,7 @@ CallSummaryPage.prototype[util.inspect.custom] = function inspect(depth,
  * @property {object} attributes - The attributes
  * @property {object} properties - The properties
  * @property {object} trust - The trust
+ * @property {object} annotation - The annotation
  *
  * @param {V1} version - Version of the resource
  * @param {CallSummaryPayload} payload - The instance payload
@@ -210,6 +211,7 @@ CallSummaryInstance = function CallSummaryInstance(version, payload, callSid) {
   this.attributes = payload.attributes; // jshint ignore:line
   this.properties = payload.properties; // jshint ignore:line
   this.trust = payload.trust; // jshint ignore:line
+  this.annotation = payload.annotation; // jshint ignore:line
 
   // Context
   this._context = undefined;

package/lib/rest/insights/v1/call.d.ts

@@ -8,6 +8,8 @@
 import Page = require('../../../base/Page');
 import Response = require('../../../http/response');
 import V1 = require('../V1');
+import { AnnotationList } from './call/annotation';
+import { AnnotationListInstance } from './call/annotation';
 import { CallSummaryList } from './call/summary';
 import { CallSummaryListInstance } from './call/summary';
 import { EventList } from './call/event';
@@ -19,10 +21,6 @@ import { SerializableClass } from '../../../interfaces';
 /**
  * Initialize the CallList
  *
- * PLEASE NOTE that this class contains preview products that are subject to
- * change. Use them with caution. If you currently do not have developer preview
- * access, please contact help@twilio.com.
- *
  * @param version - Version of the resource
  */
 declare function CallList(version: V1): CallListInstance;
@@ -61,15 +59,12 @@ declare class CallContext {
   /**
    * Initialize the CallContext
    *
-   * PLEASE NOTE that this class contains preview products that are subject to
-   * change. Use them with caution. If you currently do not have developer preview
-   * access, please contact help@twilio.com.
-   *
    * @param version - Version of the resource
    * @param sid - The sid
    */
   constructor(version: V1, sid: string);
 
+  annotation: AnnotationListInstance;
   events: EventListInstance;
   /**
    * fetch a CallInstance
@@ -90,10 +85,6 @@ declare class CallInstance extends SerializableClass {
   /**
    * Initialize the CallContext
    *
-   * PLEASE NOTE that this class contains preview products that are subject to
-   * change. Use them with caution. If you currently do not have developer preview
-   * access, please contact help@twilio.com.
-   *
    * @param version - Version of the resource
    * @param payload - The instance payload
    * @param sid - The sid
@@ -101,6 +92,10 @@ declare class CallInstance extends SerializableClass {
   constructor(version: V1, payload: CallPayload, sid: string);
 
   private _proxy: CallContext;
+  /**
+   * Access the annotation
+   */
+  annotation(): AnnotationListInstance;
   /**
    * Access the events
    */
@@ -133,10 +128,6 @@ declare class CallPage extends Page<V1, CallPayload, CallResource, CallInstance>
   /**
    * Initialize the CallPage
    *
-   * PLEASE NOTE that this class contains preview products that are subject to
-   * change. Use them with caution. If you currently do not have developer preview
-   * access, please contact help@twilio.com.
-   *
    * @param version - Version of the resource
    * @param response - Response from the API
    * @param solution - Path solution