twilio 3.23.0 → 3.25.0

package/lib/rest/autopilot/v1/assistant/task/sample.js

@@ -62,7 +62,7 @@ SampleList = function SampleList(version, assistantSid, taskSid) {
    *
    * @param {object} [opts] - Options for request
    * @param {string} [opts.language] -
-   *          An ISO language-country string that specifies the language used for this sample. For example: en-US.
+   *          An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this sample. For example: `en-US`.
    * @param {number} [opts.limit] -
    *         Upper limit for the number of records to return.
    *         each() guarantees never to return more than limit.
@@ -149,7 +149,7 @@ SampleList = function SampleList(version, assistantSid, taskSid) {
    *
    * @param {object} [opts] - Options for request
    * @param {string} [opts.language] -
-   *          An ISO language-country string that specifies the language used for this sample. For example: en-US.
+   *          An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this sample. For example: `en-US`.
    * @param {number} [opts.limit] -
    *         Upper limit for the number of records to return.
    *         list() guarantees never to return more than limit.
@@ -206,7 +206,7 @@ SampleList = function SampleList(version, assistantSid, taskSid) {
    *
    * @param {object} [opts] - Options for request
    * @param {string} [opts.language] -
-   *          An ISO language-country string that specifies the language used for this sample. For example: en-US.
+   *          An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this sample. For example: `en-US`.
    * @param {string} [opts.pageToken] - PageToken provided by the API
    * @param {number} [opts.pageNumber] -
    *          Page Number, this value is simply for client state
@@ -287,11 +287,11 @@ SampleList = function SampleList(version, assistantSid, taskSid) {
    *
    * @param {object} opts - Options for request
    * @param {string} opts.language -
-   *          An ISO language-country string that specifies the language used for this sample. For example: en-US.
+   *          An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this sample. For example: `en-US`.
    * @param {string} opts.taggedText -
-   *          The text example of how end-users may express this task. The sample may contain Field tag blocks.
+   *          The text example of how end-users may express this task. The sample may contain [Field tag blocks](https://www.twilio.com/docs/autopilot/api/task-sample#field-tagging).
    * @param {string} [opts.sourceChannel] -
-   *          The communication channel from which the sample was captured. It can be: voice, sms, chat, alexa, google-assistant, or slack. If not included the value will be null
+   *          The communication channel from which the sample was captured. It can be: voice, sms, chat, alexa, google-assistant, or slack. If not included, the value will be `null`
    * @param {function} [callback] - Callback to handle processed record
    *
    * @returns {Promise} Resolves to processed SampleInstance
@@ -342,7 +342,8 @@ SampleList = function SampleList(version, assistantSid, taskSid) {
   /**
    * Constructs a sample
    *
-   * @param {string} sid - The sid
+   * @param {string} sid -
+   *          A 34-character string that uniquely identifies this resource.
    *
    * @returns {Twilio.Autopilot.V1.AssistantContext.TaskContext.SampleContext}
    */
@@ -406,21 +407,21 @@ SamplePage.prototype.getInstance = function getInstance(payload) {
  * @property {string} taskSid -
  *          The unique ID of the Task associated with this Sample.
  * @property {string} language -
- *          An ISO language-country string that specifies the language used for this sample. For example: en-US.
+ *          An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this sample. For example: `en-US`.
  * @property {string} assistantSid - The unique ID of the Assistant.
  * @property {string} sid -
- *          A 34 character string that uniquely identifies this resource.
+ *          A 34-character string that uniquely identifies this resource.
  * @property {string} taggedText -
- *          The text example of how end-users may express this task. The sample may contain Field tag blocks.
+ *          The text example of how end-users may express this task. The sample may contain [Field tag blocks](https://www.twilio.com/docs/autopilot/api/task-sample#field-tagging).
  * @property {string} url - The url
  * @property {string} sourceChannel -
- *          The communication channel from which the sample was captured. It can be: voice, sms, chat, alexa, google-assistant, or slack. If not included the value will be null
+ *          The communication channel from which the sample was captured. It can be: voice, sms, chat, alexa, google-assistant, or slack. If not included, the value will be `null`
  *
  * @param {V1} version - Version of the resource
  * @param {SamplePayload} payload - The instance payload
  * @param {sid} assistantSid - The unique ID of the Assistant.
  * @param {sid} taskSid - The unique ID of the Task associated with this Sample.
- * @param {sid} sid - The sid
+ * @param {sid} sid - A 34-character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 SampleInstance = function SampleInstance(version, payload, assistantSid,
@@ -479,11 +480,11 @@ SampleInstance.prototype.fetch = function fetch(callback) {
  *
  * @param {object} [opts] - Options for request
  * @param {string} [opts.language] -
- *          An ISO language-country string that specifies the language used for this sample. For example: en-US.
+ *          An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this sample. For example: `en-US`.
  * @param {string} [opts.taggedText] -
- *          The text example of how end-users may express this task. The sample may contain Field tag blocks.
+ *          The text example of how end-users may express this task. The sample may contain [Field tag blocks](https://www.twilio.com/docs/autopilot/api/task-sample#field-tagging).
  * @param {string} [opts.sourceChannel] -
- *          The communication channel from which the sample was captured. It can be: voice, sms, chat, alexa, google-assistant, or slack. If not included the value will be null
+ *          The communication channel from which the sample was captured. It can be: voice, sms, chat, alexa, google-assistant, or slack. If not included, the value will be `null`
  * @param {function} [callback] - Callback to handle processed record
  *
  * @returns {Promise} Resolves to processed SampleInstance
@@ -530,9 +531,10 @@ SampleInstance.prototype.toJSON = function toJSON() {
  * Initialize the SampleContextPLEASE 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 {V1} version - Version of the resource
- * @param {sid_like} assistantSid - The assistant_sid
- * @param {sid_like} taskSid - The task_sid
- * @param {sid} sid - The sid
+ * @param {sid_like} assistantSid - The unique ID of the Assistant.
+ * @param {sid_like} taskSid -
+ *          The unique ID of the Task associated with this Sample.
+ * @param {sid} sid - A 34-character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 SampleContext = function SampleContext(version, assistantSid, taskSid, sid) {
@@ -585,11 +587,11 @@ SampleContext.prototype.fetch = function fetch(callback) {
  *
  * @param {object} [opts] - Options for request
  * @param {string} [opts.language] -
- *          An ISO language-country string that specifies the language used for this sample. For example: en-US.
+ *          An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this sample. For example: `en-US`.
  * @param {string} [opts.taggedText] -
- *          The text example of how end-users may express this task. The sample may contain Field tag blocks.
+ *          The text example of how end-users may express this task. The sample may contain [Field tag blocks](https://www.twilio.com/docs/autopilot/api/task-sample#field-tagging).
  * @param {string} [opts.sourceChannel] -
- *          The communication channel from which the sample was captured. It can be: voice, sms, chat, alexa, google-assistant, or slack. If not included the value will be null
+ *          The communication channel from which the sample was captured. It can be: voice, sms, chat, alexa, google-assistant, or slack. If not included, the value will be `null`
  * @param {function} [callback] - Callback to handle processed record
  *
  * @returns {Promise} Resolves to processed SampleInstance

package/lib/rest/autopilot/v1/assistant/task/taskActions.d.ts

@@ -24,7 +24,7 @@ declare function TaskActionsList(version: V1, assistantSid: string, taskSid: str
 /**
  * Options to pass to update
  *
- * @property actions - The JSON actions that instruct the Assistant how to perform this task.
+ * @property actions - The JSON [actions](https://www.twilio.com/docs/autopilot/actions) that instruct the Assistant how to perform this task.
  */
 interface TaskActionsInstanceUpdateOptions {
   actions?: string;
@@ -92,7 +92,7 @@ declare class TaskActionsInstance extends SerializableClass {
    * @property assistantSid - The unique ID of the parent Assistant.
    * @property taskSid - The unique ID of the Task.
    * @property url - The url
-   * @property data - The data
+   * @property data - The JSON [actions](https://www.twilio.com/docs/autopilot/actions) that instruct the Assistant how to perform this task.
    *
    * @param version - Version of the resource
    * @param payload - The instance payload

package/lib/rest/autopilot/v1/assistant/task/taskActions.js

@@ -110,7 +110,8 @@ TaskActionsPage.prototype.getInstance = function getInstance(payload) {
  * @property {string} assistantSid - The unique ID of the parent Assistant.
  * @property {string} taskSid - The unique ID of the Task.
  * @property {string} url - The url
- * @property {string} data - The data
+ * @property {string} data -
+ *          The JSON [actions](https://www.twilio.com/docs/autopilot/actions) that instruct the Assistant how to perform this task.
  *
  * @param {V1} version - Version of the resource
  * @param {TaskActionsPayload} payload - The instance payload
@@ -168,7 +169,7 @@ TaskActionsInstance.prototype.fetch = function fetch(callback) {
  *
  * @param {object} [opts] - Options for request
  * @param {string} [opts.actions] -
- *          The JSON actions that instruct the Assistant how to perform this task.
+ *          The JSON [actions](https://www.twilio.com/docs/autopilot/actions) that instruct the Assistant how to perform this task.
  * @param {function} [callback] - Callback to handle processed record
  *
  * @returns {Promise} Resolves to processed TaskActionsInstance
@@ -256,7 +257,7 @@ TaskActionsContext.prototype.fetch = function fetch(callback) {
  *
  * @param {object} [opts] - Options for request
  * @param {string} [opts.actions] -
- *          The JSON actions that instruct the Assistant how to perform this task.
+ *          The JSON [actions](https://www.twilio.com/docs/autopilot/actions) that instruct the Assistant how to perform this task.
  * @param {function} [callback] - Callback to handle processed record
  *
  * @returns {Promise} Resolves to processed TaskActionsInstance

package/lib/rest/autopilot/v1/assistant/task/taskStatistics.d.ts

@@ -15,7 +15,7 @@ import { SerializableClass } from '../../../../../interfaces';
  * 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 assistantSid - The unique ID of the parent Assistant.
+ * @param assistantSid - The unique ID of the Assistant.
  * @param taskSid - The unique ID of the Task associated with this Field.
  */
 declare function TaskStatisticsList(version: V1, assistantSid: string, taskSid: string): TaskStatisticsListInstance;
@@ -54,8 +54,8 @@ declare class TaskStatisticsContext {
    * Initialize the TaskStatisticsContextPLEASE 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 assistantSid - The assistant_sid
-   * @param taskSid - The task_sid
+   * @param assistantSid - The unique ID of the Assistant.
+   * @param taskSid - The unique ID of the Task associated with this Field.
    */
   constructor(version: V1, assistantSid: string, taskSid: string);
 
@@ -72,8 +72,8 @@ declare class TaskStatisticsInstance extends SerializableClass {
   /**
    * Initialize the TaskStatisticsContextPLEASE 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.
    *
-   * @property accountSid - The unique ID of the Account that created this Field.
-   * @property assistantSid - The unique ID of the parent Assistant.
+   * @property accountSid - The unique ID of the Account that created this resource.
+   * @property assistantSid - The unique ID of the Assistant.
    * @property taskSid - The unique ID of the Task associated with this Field.
    * @property samplesCount - The total number of Samples associated with this Task.
    * @property fieldsCount - The total number of Fields associated with this Task.
@@ -81,7 +81,7 @@ declare class TaskStatisticsInstance extends SerializableClass {
    *
    * @param version - Version of the resource
    * @param payload - The instance payload
-   * @param assistantSid - The unique ID of the parent Assistant.
+   * @param assistantSid - The unique ID of the Assistant.
    * @param taskSid - The unique ID of the Task associated with this Field.
    */
   constructor(version: V1, payload: TaskStatisticsPayload, assistantSid: string, taskSid: string);

package/lib/rest/autopilot/v1/assistant/task/taskStatistics.js

@@ -27,7 +27,7 @@ var TaskStatisticsContext;
  * 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 {Twilio.Autopilot.V1} version - Version of the resource
- * @param {string} assistantSid - The unique ID of the parent Assistant.
+ * @param {string} assistantSid - The unique ID of the Assistant.
  * @param {string} taskSid - The unique ID of the Task associated with this Field.
  */
 /* jshint ignore:end */
@@ -111,8 +111,8 @@ TaskStatisticsPage.prototype.getInstance = function getInstance(payload) {
  * Initialize the TaskStatisticsContextPLEASE 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.
  *
  * @property {string} accountSid -
- *          The unique ID of the Account that created this Field.
- * @property {string} assistantSid - The unique ID of the parent Assistant.
+ *          The unique ID of the Account that created this resource.
+ * @property {string} assistantSid - The unique ID of the Assistant.
  * @property {string} taskSid -
  *          The unique ID of the Task associated with this Field.
  * @property {number} samplesCount -
@@ -123,7 +123,7 @@ TaskStatisticsPage.prototype.getInstance = function getInstance(payload) {
  *
  * @param {V1} version - Version of the resource
  * @param {TaskStatisticsPayload} payload - The instance payload
- * @param {sid} assistantSid - The unique ID of the parent Assistant.
+ * @param {sid} assistantSid - The unique ID of the Assistant.
  * @param {sid} taskSid - The unique ID of the Task associated with this Field.
  */
 /* jshint ignore:end */
@@ -197,8 +197,9 @@ TaskStatisticsInstance.prototype.toJSON = function toJSON() {
  * Initialize the TaskStatisticsContextPLEASE 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 {V1} version - Version of the resource
- * @param {sid_like} assistantSid - The assistant_sid
- * @param {sid_like} taskSid - The task_sid
+ * @param {sid_like} assistantSid - The unique ID of the Assistant.
+ * @param {sid_like} taskSid -
+ *          The unique ID of the Task associated with this Field.
  */
 /* jshint ignore:end */
 TaskStatisticsContext = function TaskStatisticsContext(version, assistantSid,

package/lib/rest/autopilot/v1/assistant/task.d.ts

@@ -31,8 +31,8 @@ declare function TaskList(version: V1, assistantSid: string): TaskListInstance;
 /**
  * Options to pass to update
  *
- * @property actions - The actions
- * @property actionsUrl - The actions_url
+ * @property actions - A user-provided JSON object encoded as a string to specify the actions for this task. It is optional and non-unique.
+ * @property actionsUrl - User-provided HTTP endpoint where the assistant can fetch actions.
  * @property friendlyName - A user-provided string that identifies this resource. It is non-unique and can be up to 255 characters long.
  * @property uniqueName - A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
  */
@@ -72,7 +72,7 @@ interface TaskListInstance {
   /**
    * Constructs a task
    *
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   get(sid: string): TaskContext;
   /**
@@ -109,8 +109,8 @@ interface TaskListInstance {
 /**
  * Options to pass to create
  *
- * @property actions - The actions
- * @property actionsUrl - The actions_url
+ * @property actions - A user-provided JSON object encoded as a string to specify the actions for this task. It is optional and non-unique.
+ * @property actionsUrl - User-provided HTTP endpoint where the assistant can fetch actions.
  * @property friendlyName - A user-provided string that identifies this resource. It is non-unique and can be up to 255 characters long.
  * @property uniqueName - A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
  */
@@ -209,8 +209,8 @@ declare class TaskContext {
    * @property statistics - statistics resource
    *
    * @param version - Version of the resource
-   * @param assistantSid - The assistant_sid
-   * @param sid - The sid
+   * @param assistantSid - The unique ID of the Assistant.
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   constructor(version: V1, assistantSid: string, sid: string);
 
@@ -250,15 +250,15 @@ declare class TaskInstance extends SerializableClass {
    * @property friendlyName - A user-provided string that identifies this resource. It is non-unique and can be up to 255 characters long.
    * @property links - The links
    * @property assistantSid - The unique ID of the Assistant.
-   * @property sid - A 34 character string that uniquely identifies this resource.
+   * @property sid - A 34-character string that uniquely identifies this resource.
    * @property uniqueName - A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
-   * @property actionsUrl - User-provided HTTP endpoint where the assistant can fetch actions.
+   * @property actionsUrl - A user-provided HTTP endpoint where the assistant can fetch actions.
    * @property url - The url
    *
    * @param version - Version of the resource
    * @param payload - The instance payload
    * @param assistantSid - The unique ID of the Assistant.
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   constructor(version: V1, payload: TaskPayload, assistantSid: string, sid: string);
 

package/lib/rest/autopilot/v1/assistant/task.js

@@ -287,8 +287,10 @@ TaskList = function TaskList(version, assistantSid) {
    *          A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
    * @param {string} [opts.friendlyName] -
    *          A user-provided string that identifies this resource. It is non-unique and can be up to 255 characters long.
-   * @param {string} [opts.actions] - The actions
-   * @param {string} [opts.actionsUrl] - The actions_url
+   * @param {string} [opts.actions] -
+   *          A user-provided JSON object encoded as a string to specify the actions for this task. It is optional and non-unique.
+   * @param {string} [opts.actionsUrl] -
+   *          User-provided HTTP endpoint where the assistant can fetch actions.
    * @param {function} [callback] - Callback to handle processed record
    *
    * @returns {Promise} Resolves to processed TaskInstance
@@ -336,7 +338,8 @@ TaskList = function TaskList(version, assistantSid) {
   /**
    * Constructs a task
    *
-   * @param {string} sid - The sid
+   * @param {string} sid -
+   *          A 34-character string that uniquely identifies this resource.
    *
    * @returns {Twilio.Autopilot.V1.AssistantContext.TaskContext}
    */
@@ -397,17 +400,18 @@ TaskPage.prototype.getInstance = function getInstance(payload) {
  * @property {string} links - The links
  * @property {string} assistantSid - The unique ID of the Assistant.
  * @property {string} sid -
- *          A 34 character string that uniquely identifies this resource.
+ *          A 34-character string that uniquely identifies this resource.
  * @property {string} uniqueName -
  *          A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
  * @property {string} actionsUrl -
- *          User-provided HTTP endpoint where the assistant can fetch actions.
+ *          A user-provided HTTP endpoint where the assistant can fetch actions.
  * @property {string} url - The url
  *
  * @param {V1} version - Version of the resource
  * @param {TaskPayload} payload - The instance payload
  * @param {sid} assistantSid - The unique ID of the Assistant.
- * @param {sid_like} sid - The sid
+ * @param {sid_like} sid -
+ *          A 34-character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 TaskInstance = function TaskInstance(version, payload, assistantSid, sid) {
@@ -463,8 +467,10 @@ TaskInstance.prototype.fetch = function fetch(callback) {
  *          A user-provided string that identifies this resource. It is non-unique and can be up to 255 characters long.
  * @param {string} [opts.uniqueName] -
  *          A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
- * @param {string} [opts.actions] - The actions
- * @param {string} [opts.actionsUrl] - The actions_url
+ * @param {string} [opts.actions] -
+ *          A user-provided JSON object encoded as a string to specify the actions for this task. It is optional and non-unique.
+ * @param {string} [opts.actionsUrl] -
+ *          User-provided HTTP endpoint where the assistant can fetch actions.
  * @param {function} [callback] - Callback to handle processed record
  *
  * @returns {Promise} Resolves to processed TaskInstance
@@ -564,8 +570,9 @@ TaskInstance.prototype.toJSON = function toJSON() {
  *          statistics resource
  *
  * @param {V1} version - Version of the resource
- * @param {sid_like} assistantSid - The assistant_sid
- * @param {sid_like} sid - The sid
+ * @param {sid_like} assistantSid - The unique ID of the Assistant.
+ * @param {sid_like} sid -
+ *          A 34-character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 TaskContext = function TaskContext(version, assistantSid, sid) {
@@ -626,8 +633,10 @@ TaskContext.prototype.fetch = function fetch(callback) {
  *          A user-provided string that identifies this resource. It is non-unique and can be up to 255 characters long.
  * @param {string} [opts.uniqueName] -
  *          A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
- * @param {string} [opts.actions] - The actions
- * @param {string} [opts.actionsUrl] - The actions_url
+ * @param {string} [opts.actions] -
+ *          A user-provided JSON object encoded as a string to specify the actions for this task. It is optional and non-unique.
+ * @param {string} [opts.actionsUrl] -
+ *          User-provided HTTP endpoint where the assistant can fetch actions.
  * @param {function} [callback] - Callback to handle processed record
  *
  * @returns {Promise} Resolves to processed TaskInstance

package/lib/rest/autopilot/v1/assistant.d.ts

@@ -36,12 +36,12 @@ declare function AssistantList(version: V1): AssistantListInstance;
 /**
  * Options to pass to update
  *
- * @property callbackEvents - The callback_events
+ * @property callbackEvents - A space-separated list of callback events that will trigger callbacks
  * @property callbackUrl - The callback_url
- * @property defaults - A JSON object that defines the assistant's default tasks for various scenarios
+ * @property defaults - A JSON object that defines the assistant's [default tasks](https://www.twilio.com/docs/autopilot/api/assistant/defaults) for various scenarios
  * @property friendlyName - A text description for the Assistant. It is non-unique and can be up to 255 characters long.
- * @property logQueries - A boolean that specifies whether queries should be logged for 30 days further training. If false, no queries will be stored, if true, queries will be stored for 30 days and deleted thereafter. Defaults to true if no value is provided.
- * @property styleSheet - A JSON object that defines the assistant style sheet
+ * @property logQueries - A boolean that specifies whether queries should be logged for 30 days past training. If `false`, no queries will be stored. If `true`, queries will be stored for 30 days and deleted thereafter. Defaults to `true` if no value is provided.
+ * @property styleSheet - A JSON object that defines the assistant [style sheet](https://www.twilio.com/docs/autopilot/api/assistant/stylesheet)
  * @property uniqueName - A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
  */
 interface AssistantInstanceUpdateOptions {
@@ -83,7 +83,7 @@ interface AssistantListInstance {
   /**
    * Constructs a assistant
    *
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   get(sid: string): AssistantContext;
   /**
@@ -120,12 +120,12 @@ interface AssistantListInstance {
 /**
  * Options to pass to create
  *
- * @property callbackEvents - The callback_events
+ * @property callbackEvents - A space-separated list of callback events that will trigger callbacks
  * @property callbackUrl - The callback_url
- * @property defaults - A JSON object that defines the assistant's default tasks for various scenarios
+ * @property defaults - A JSON object that defines the assistant's [default tasks](https://www.twilio.com/docs/autopilot/api/assistant/defaults) for various scenarios
  * @property friendlyName - A text description for the Assistant. It is non-unique and can be up to 255 characters long.
- * @property logQueries - A boolean that specifies whether queries should be logged for 30 days further training. If false, no queries will be stored, if true, queries will be stored for 30 days and deleted thereafter. Defaults to true if no value is provided.
- * @property styleSheet - A JSON object that defines the assistant style sheet
+ * @property logQueries - A boolean that specifies whether queries should be logged for 30 days past training. If `false`, no queries will be stored. If `true`, queries will be stored for 30 days and deleted thereafter. Defaults to `true` if no value is provided.
+ * @property styleSheet - A JSON object that defines the assistant [style sheet](https://www.twilio.com/docs/autopilot/api/assistant/stylesheet)
  * @property uniqueName - A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
  */
 interface AssistantListInstanceCreateOptions {
@@ -230,7 +230,7 @@ declare class AssistantContext {
    * @property dialogues - dialogues resource
    *
    * @param version - Version of the resource
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   constructor(version: V1, sid: string);
 
@@ -271,18 +271,18 @@ declare class AssistantInstance extends SerializableClass {
    * @property dateCreated - The date that this resource was created
    * @property dateUpdated - The date that this resource was last updated
    * @property friendlyName - A text description for the Assistant. It is non-unique and can be up to 255 characters long.
-   * @property latestModelBuildSid - The unique ID (Sid) of the latest model build. Null if no model has been built.
+   * @property latestModelBuildSid - The latest_model_build_sid
    * @property links - The links
-   * @property logQueries - A boolean that specifies whether queries should be logged for 30 days further training. If false, no queries will be stored, if true, queries will be stored for 30 days and deleted thereafter.
-   * @property sid - A 34 character string that uniquely identifies this resource.
-   * @property uniqueName - A user-provided string that uniquely identifies this resource as an alternative to the sid. You can use the unique name in the URL path. Unique up to 64 characters long.
+   * @property logQueries - A boolean that specifies whether queries should be logged for 30 days past training. If `false`, no queries will be stored. If `true`, queries will be stored for 30 days and deleted thereafter.
+   * @property sid - A 34-character string that uniquely identifies this resource.
+   * @property uniqueName - A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
    * @property url - The url
    * @property callbackUrl - The callback_url
    * @property callbackEvents - The callback_events
    *
    * @param version - Version of the resource
    * @param payload - The instance payload
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   constructor(version: V1, payload: AssistantPayload, sid: string);
 

package/lib/rest/autopilot/v1/assistant.js

@@ -288,15 +288,16 @@ AssistantList = function AssistantList(version) {
    * @param {string} [opts.friendlyName] -
    *          A text description for the Assistant. It is non-unique and can be up to 255 characters long.
    * @param {boolean} [opts.logQueries] -
-   *          A boolean that specifies whether queries should be logged for 30 days further training. If false, no queries will be stored, if true, queries will be stored for 30 days and deleted thereafter. Defaults to true if no value is provided.
+   *          A boolean that specifies whether queries should be logged for 30 days past training. If `false`, no queries will be stored. If `true`, queries will be stored for 30 days and deleted thereafter. Defaults to `true` if no value is provided.
    * @param {string} [opts.uniqueName] -
    *          A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
    * @param {string} [opts.callbackUrl] - The callback_url
-   * @param {string} [opts.callbackEvents] - The callback_events
+   * @param {string} [opts.callbackEvents] -
+   *          A space-separated list of callback events that will trigger callbacks
    * @param {string} [opts.styleSheet] -
-   *          A JSON object that defines the assistant style sheet
+   *          A JSON object that defines the assistant [style sheet](https://www.twilio.com/docs/autopilot/api/assistant/stylesheet)
    * @param {string} [opts.defaults] -
-   *          A JSON object that defines the assistant's default tasks for various scenarios
+   *          A JSON object that defines the assistant's [default tasks](https://www.twilio.com/docs/autopilot/api/assistant/defaults) for various scenarios
    * @param {function} [callback] - Callback to handle processed record
    *
    * @returns {Promise} Resolves to processed AssistantInstance
@@ -341,7 +342,8 @@ AssistantList = function AssistantList(version) {
   /**
    * Constructs a assistant
    *
-   * @param {string} sid - The sid
+   * @param {string} sid -
+   *          A 34-character string that uniquely identifies this resource.
    *
    * @returns {Twilio.Autopilot.V1.AssistantContext}
    */
@@ -399,22 +401,22 @@ AssistantPage.prototype.getInstance = function getInstance(payload) {
  * @property {Date} dateUpdated - The date that this resource was last updated
  * @property {string} friendlyName -
  *          A text description for the Assistant. It is non-unique and can be up to 255 characters long.
- * @property {string} latestModelBuildSid -
- *          The unique ID (Sid) of the latest model build. Null if no model has been built.
+ * @property {string} latestModelBuildSid - The latest_model_build_sid
  * @property {string} links - The links
  * @property {boolean} logQueries -
- *          A boolean that specifies whether queries should be logged for 30 days further training. If false, no queries will be stored, if true, queries will be stored for 30 days and deleted thereafter.
+ *          A boolean that specifies whether queries should be logged for 30 days past training. If `false`, no queries will be stored. If `true`, queries will be stored for 30 days and deleted thereafter.
  * @property {string} sid -
- *          A 34 character string that uniquely identifies this resource.
+ *          A 34-character string that uniquely identifies this resource.
  * @property {string} uniqueName -
- *          A user-provided string that uniquely identifies this resource as an alternative to the sid. You can use the unique name in the URL path. Unique up to 64 characters long.
+ *          A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
  * @property {string} url - The url
  * @property {string} callbackUrl - The callback_url
  * @property {string} callbackEvents - The callback_events
  *
  * @param {V1} version - Version of the resource
  * @param {AssistantPayload} payload - The instance payload
- * @param {sid_like} sid - The sid
+ * @param {sid_like} sid -
+ *          A 34-character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 AssistantInstance = function AssistantInstance(version, payload, sid) {
@@ -471,15 +473,16 @@ AssistantInstance.prototype.fetch = function fetch(callback) {
  * @param {string} [opts.friendlyName] -
  *          A text description for the Assistant. It is non-unique and can be up to 255 characters long.
  * @param {boolean} [opts.logQueries] -
- *          A boolean that specifies whether queries should be logged for 30 days further training. If false, no queries will be stored, if true, queries will be stored for 30 days and deleted thereafter. Defaults to true if no value is provided.
+ *          A boolean that specifies whether queries should be logged for 30 days past training. If `false`, no queries will be stored. If `true`, queries will be stored for 30 days and deleted thereafter. Defaults to `true` if no value is provided.
  * @param {string} [opts.uniqueName] -
  *          A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
  * @param {string} [opts.callbackUrl] - The callback_url
- * @param {string} [opts.callbackEvents] - The callback_events
+ * @param {string} [opts.callbackEvents] -
+ *          A space-separated list of callback events that will trigger callbacks
  * @param {string} [opts.styleSheet] -
- *          A JSON object that defines the assistant style sheet
+ *          A JSON object that defines the assistant [style sheet](https://www.twilio.com/docs/autopilot/api/assistant/stylesheet)
  * @param {string} [opts.defaults] -
- *          A JSON object that defines the assistant's default tasks for various scenarios
+ *          A JSON object that defines the assistant's [default tasks](https://www.twilio.com/docs/autopilot/api/assistant/defaults) for various scenarios
  * @param {function} [callback] - Callback to handle processed record
  *
  * @returns {Promise} Resolves to processed AssistantInstance
@@ -617,7 +620,8 @@ AssistantInstance.prototype.toJSON = function toJSON() {
  *          dialogues resource
  *
  * @param {V1} version - Version of the resource
- * @param {sid_like} sid - The sid
+ * @param {sid_like} sid -
+ *          A 34-character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 AssistantContext = function AssistantContext(version, sid) {
@@ -675,15 +679,16 @@ AssistantContext.prototype.fetch = function fetch(callback) {
  * @param {string} [opts.friendlyName] -
  *          A text description for the Assistant. It is non-unique and can be up to 255 characters long.
  * @param {boolean} [opts.logQueries] -
- *          A boolean that specifies whether queries should be logged for 30 days further training. If false, no queries will be stored, if true, queries will be stored for 30 days and deleted thereafter. Defaults to true if no value is provided.
+ *          A boolean that specifies whether queries should be logged for 30 days past training. If `false`, no queries will be stored. If `true`, queries will be stored for 30 days and deleted thereafter. Defaults to `true` if no value is provided.
  * @param {string} [opts.uniqueName] -
  *          A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
  * @param {string} [opts.callbackUrl] - The callback_url
- * @param {string} [opts.callbackEvents] - The callback_events
+ * @param {string} [opts.callbackEvents] -
+ *          A space-separated list of callback events that will trigger callbacks
  * @param {string} [opts.styleSheet] -
- *          A JSON object that defines the assistant style sheet
+ *          A JSON object that defines the assistant [style sheet](https://www.twilio.com/docs/autopilot/api/assistant/stylesheet)
  * @param {string} [opts.defaults] -
- *          A JSON object that defines the assistant's default tasks for various scenarios
+ *          A JSON object that defines the assistant's [default tasks](https://www.twilio.com/docs/autopilot/api/assistant/defaults) for various scenarios
  * @param {function} [callback] - Callback to handle processed record
  *
  * @returns {Promise} Resolves to processed AssistantInstance