twilio 3.23.0 → 3.25.0

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

@@ -59,7 +59,7 @@ interface ModelBuildListInstance {
   /**
    * Constructs a model_build
    *
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   get(sid: string): ModelBuildContext;
   /**
@@ -187,8 +187,8 @@ declare class ModelBuildContext {
    * Initialize the ModelBuildContextPLEASE 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 sid - The sid
+   * @param assistantSid - The unique ID of the parent Assistant.
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   constructor(version: V1, assistantSid: string, sid: string);
 
@@ -222,7 +222,7 @@ declare class ModelBuildInstance extends SerializableClass {
    * @property dateCreated - The date that this resource was created
    * @property dateUpdated - The date that this resource was last updated
    * @property assistantSid - The unique ID of the parent Assistant.
-   * @property sid - A 34 character string that uniquely identifies this resource.
+   * @property sid - A 34-character string that uniquely identifies this resource.
    * @property status - A string that described the model build status. The values can be: `enqueued`, `building`, `completed`, `failed`
    * @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
@@ -232,7 +232,7 @@ declare class ModelBuildInstance extends SerializableClass {
    * @param version - Version of the resource
    * @param payload - The instance payload
    * @param assistantSid - The unique ID of the parent Assistant.
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   constructor(version: V1, payload: ModelBuildPayload, assistantSid: string, sid: string);
 

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

@@ -325,7 +325,8 @@ ModelBuildList = function ModelBuildList(version, assistantSid) {
   /**
    * Constructs a model_build
    *
-   * @param {string} sid - The sid
+   * @param {string} sid -
+   *          A 34-character string that uniquely identifies this resource.
    *
    * @returns {Twilio.Autopilot.V1.AssistantContext.ModelBuildContext}
    */
@@ -383,7 +384,7 @@ ModelBuildPage.prototype.getInstance = function getInstance(payload) {
  * @property {Date} dateUpdated - The date that this resource was last updated
  * @property {string} assistantSid - The unique ID of the parent Assistant.
  * @property {string} sid -
- *          A 34 character string that uniquely identifies this resource.
+ *          A 34-character string that uniquely identifies this resource.
  * @property {model_build.status} status -
  *          A string that described the model build status. The values can be: `enqueued`, `building`, `completed`, `failed`
  * @property {string} uniqueName -
@@ -396,7 +397,8 @@ ModelBuildPage.prototype.getInstance = function getInstance(payload) {
  * @param {V1} version - Version of the resource
  * @param {ModelBuildPayload} payload - The instance payload
  * @param {sid} assistantSid - The unique ID of the parent Assistant.
- * @param {sid_like} sid - The sid
+ * @param {sid_like} sid -
+ *          A 34-character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 ModelBuildInstance = function ModelBuildInstance(version, payload, assistantSid,
@@ -501,8 +503,9 @@ ModelBuildInstance.prototype.toJSON = function toJSON() {
  * Initialize the ModelBuildContextPLEASE 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} sid - The sid
+ * @param {sid_like} assistantSid - The unique ID of the parent Assistant.
+ * @param {sid_like} sid -
+ *          A 34-character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 ModelBuildContext = function ModelBuildContext(version, assistantSid, sid) {

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

@@ -22,7 +22,7 @@ declare function QueryList(version: V1, assistantSid: string): QueryListInstance
 /**
  * Options to pass to update
  *
- * @property sampleSid - The sample_sid
+ * @property sampleSid - An optional reference to the Sample created from this query.
  * @property status - A string that described the query status. The values can be: `pending_review`, `reviewed`, `discarded`
  */
 interface QueryInstanceUpdateOptions {
@@ -59,7 +59,7 @@ interface QueryListInstance {
   /**
    * Constructs a query
    *
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   get(sid: string): QueryContext;
   /**
@@ -96,8 +96,8 @@ interface QueryListInstance {
 /**
  * Options to pass to create
  *
- * @property language - An ISO language-country string that specifies the language used for this query. For example: en-US.
- * @property modelBuild - The Model Build Sid or unique name of the Model Build to be queried.
+ * @property language - An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this query. For example: `en-US`.
+ * @property modelBuild - The Sid or unique name of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) to be queried.
  * @property query - A user-provided string that uniquely identifies this resource as an alternative to the sid. It can be up to 2048 characters long.
  * @property tasks - Constraints the query to a set of tasks. Useful when you need to constrain the paths the user can take. Tasks should be comma separated task-unique-name-1, task-unique-name-2
  */
@@ -115,12 +115,12 @@ interface QueryListInstanceCreateOptions {
  *                         Function to process each record. If this and a positional
  *                         callback are passed, this one will be used
  * @property done - Function to be called upon completion of streaming
- * @property language - An ISO language-country string that specifies the language used for this query. For example: en-US.
+ * @property language - An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this query. For example: `en-US`.
  * @property limit -
  *                         Upper limit for the number of records to return.
  *                         each() guarantees never to return more than limit.
  *                         Default is no limit
- * @property modelBuild - The Model Build Sid or unique name of the Model Build to be queried.
+ * @property modelBuild - The Sid or unique name of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) to be queried.
  * @property pageSize -
  *                         Number of records to fetch per request,
  *                         when not set will use the default value of 50 records.
@@ -142,12 +142,12 @@ interface QueryListInstanceEachOptions {
 /**
  * Options to pass to list
  *
- * @property language - An ISO language-country string that specifies the language used for this query. For example: en-US.
+ * @property language - An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this query. For example: `en-US`.
  * @property limit -
  *                         Upper limit for the number of records to return.
  *                         list() guarantees never to return more than limit.
  *                         Default is no limit
- * @property modelBuild - The Model Build Sid or unique name of the Model Build to be queried.
+ * @property modelBuild - The Sid or unique name of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) to be queried.
  * @property pageSize -
  *                         Number of records to fetch per request,
  *                         when not set will use the default value of 50 records.
@@ -167,8 +167,8 @@ interface QueryListInstanceOptions {
 /**
  * Options to pass to page
  *
- * @property language - An ISO language-country string that specifies the language used for this query. For example: en-US.
- * @property modelBuild - The Model Build Sid or unique name of the Model Build to be queried.
+ * @property language - An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this query. For example: `en-US`.
+ * @property modelBuild - The Sid or unique name of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) to be queried.
  * @property pageNumber - Page Number, this value is simply for client state
  * @property pageSize - Number of records to return, defaults to 50
  * @property pageToken - PageToken provided by the API
@@ -212,8 +212,8 @@ declare class QueryContext {
    * Initialize the QueryContextPLEASE 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 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);
 
@@ -246,13 +246,13 @@ declare class QueryInstance extends SerializableClass {
    * @property accountSid - The unique ID of the Account that created this Query.
    * @property dateCreated - The date that this resource was created
    * @property dateUpdated - The date that this resource was last updated
-   * @property results - The natural language analysis results which include the Task recognized, the confidence score and a list of identified Fields.
-   * @property language - An ISO language-country string that specifies the language used for this query. For example: en-US
-   * @property modelBuildSid - The unique ID of the Model Build queried.
+   * @property results - The natural language analysis results which include the [Task](https://www.twilio.com/docs/autopilot/api/task) recognized, the confidence score, and a list of identified [Fields](https://www.twilio.com/docs/autopilot/api/task-field).
+   * @property language - An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this query. For example: `en-US`
+   * @property modelBuildSid - The unique ID of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) queried.
    * @property query - The end-user's natural language input.
    * @property sampleSid - An optional reference to the Sample created from this query.
    * @property assistantSid - The unique ID of the parent Assistant.
-   * @property sid - A 34 character string that uniquely identifies this resource.
+   * @property sid - A 34-character string that uniquely identifies this resource.
    * @property status - A string that describes the query status. The values can be: `pending_review`, `reviewed`, `discarded`
    * @property url - The url
    * @property sourceChannel - The communication channel where this end-user input came from
@@ -260,7 +260,7 @@ declare class QueryInstance extends SerializableClass {
    * @param version - Version of the resource
    * @param payload - The instance payload
    * @param assistantSid - The unique ID of the parent Assistant.
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   constructor(version: V1, payload: QueryPayload, assistantSid: string, sid: string);
 

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

@@ -61,9 +61,9 @@ QueryList = function QueryList(version, assistantSid) {
    *
    * @param {object} [opts] - Options for request
    * @param {string} [opts.language] -
-   *          An ISO language-country string that specifies the language used for this query. 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 query. For example: `en-US`.
    * @param {string} [opts.modelBuild] -
-   *          The Model Build Sid or unique name of the Model Build to be queried.
+   *          The Sid or unique name of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) to be queried.
    * @param {string} [opts.status] -
    *          A string that described the query status. The values can be: `pending_review`, `reviewed`, `discarded`
    * @param {number} [opts.limit] -
@@ -152,9 +152,9 @@ QueryList = function QueryList(version, assistantSid) {
    *
    * @param {object} [opts] - Options for request
    * @param {string} [opts.language] -
-   *          An ISO language-country string that specifies the language used for this query. 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 query. For example: `en-US`.
    * @param {string} [opts.modelBuild] -
-   *          The Model Build Sid or unique name of the Model Build to be queried.
+   *          The Sid or unique name of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) to be queried.
    * @param {string} [opts.status] -
    *          A string that described the query status. The values can be: `pending_review`, `reviewed`, `discarded`
    * @param {number} [opts.limit] -
@@ -213,9 +213,9 @@ QueryList = function QueryList(version, assistantSid) {
    *
    * @param {object} [opts] - Options for request
    * @param {string} [opts.language] -
-   *          An ISO language-country string that specifies the language used for this query. 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 query. For example: `en-US`.
    * @param {string} [opts.modelBuild] -
-   *          The Model Build Sid or unique name of the Model Build to be queried.
+   *          The Sid or unique name of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) to be queried.
    * @param {string} [opts.status] -
    *          A string that described the query status. The values can be: `pending_review`, `reviewed`, `discarded`
    * @param {string} [opts.pageToken] - PageToken provided by the API
@@ -300,13 +300,13 @@ QueryList = function QueryList(version, assistantSid) {
    *
    * @param {object} opts - Options for request
    * @param {string} opts.language -
-   *          An ISO language-country string that specifies the language used for this query. 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 query. For example: `en-US`.
    * @param {string} opts.query -
    *          A user-provided string that uniquely identifies this resource as an alternative to the sid. It can be up to 2048 characters long.
    * @param {string} [opts.tasks] -
    *          Constraints the query to a set of tasks. Useful when you need to constrain the paths the user can take. Tasks should be comma separated task-unique-name-1, task-unique-name-2
    * @param {string} [opts.modelBuild] -
-   *          The Model Build Sid or unique name of the Model Build to be queried.
+   *          The Sid or unique name of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) to be queried.
    * @param {function} [callback] - Callback to handle processed record
    *
    * @returns {Promise} Resolves to processed QueryInstance
@@ -357,7 +357,8 @@ QueryList = function QueryList(version, assistantSid) {
   /**
    * Constructs a query
    *
-   * @param {string} sid - The sid
+   * @param {string} sid -
+   *          A 34-character string that uniquely identifies this resource.
    *
    * @returns {Twilio.Autopilot.V1.AssistantContext.QueryContext}
    */
@@ -414,16 +415,17 @@ QueryPage.prototype.getInstance = function getInstance(payload) {
  * @property {Date} dateCreated - The date that this resource was created
  * @property {Date} dateUpdated - The date that this resource was last updated
  * @property {string} results -
- *          The natural language analysis results which include the Task recognized, the confidence score and a list of identified Fields.
+ *          The natural language analysis results which include the [Task](https://www.twilio.com/docs/autopilot/api/task) recognized, the confidence score, and a list of identified [Fields](https://www.twilio.com/docs/autopilot/api/task-field).
  * @property {string} language -
- *          An ISO language-country string that specifies the language used for this query. For example: en-US
- * @property {string} modelBuildSid - The unique ID of the Model Build queried.
+ *          An [ISO language-country string](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) that specifies the language used for this query. For example: `en-US`
+ * @property {string} modelBuildSid -
+ *          The unique ID of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) queried.
  * @property {string} query - The end-user's natural language input.
  * @property {string} sampleSid -
  *          An optional reference to the Sample created from this query.
  * @property {string} assistantSid - The unique ID of the parent Assistant.
  * @property {string} sid -
- *          A 34 character string that uniquely identifies this resource.
+ *          A 34-character string that uniquely identifies this resource.
  * @property {string} status -
  *          A string that describes the query status. The values can be: `pending_review`, `reviewed`, `discarded`
  * @property {string} url - The url
@@ -433,7 +435,8 @@ QueryPage.prototype.getInstance = function getInstance(payload) {
  * @param {V1} version - Version of the resource
  * @param {QueryPayload} payload - The instance payload
  * @param {sid} assistantSid - The unique ID of the parent Assistant.
- * @param {sid_like} sid - The sid
+ * @param {sid_like} sid -
+ *          A 34-character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 QueryInstance = function QueryInstance(version, payload, assistantSid, sid) {
@@ -488,7 +491,8 @@ QueryInstance.prototype.fetch = function fetch(callback) {
  * update a QueryInstance
  *
  * @param {object} [opts] - Options for request
- * @param {string} [opts.sampleSid] - The sample_sid
+ * @param {string} [opts.sampleSid] -
+ *          An optional reference to the Sample created from this query.
  * @param {string} [opts.status] -
  *          A string that described the query status. The values can be: `pending_review`, `reviewed`, `discarded`
  * @param {function} [callback] - Callback to handle processed record
@@ -537,8 +541,9 @@ QueryInstance.prototype.toJSON = function toJSON() {
  * Initialize the QueryContextPLEASE 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} 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 */
 QueryContext = function QueryContext(version, assistantSid, sid) {
@@ -589,7 +594,8 @@ QueryContext.prototype.fetch = function fetch(callback) {
  * update a QueryInstance
  *
  * @param {object} [opts] - Options for request
- * @param {string} [opts.sampleSid] - The sample_sid
+ * @param {string} [opts.sampleSid] -
+ *          An optional reference to the Sample created from this query.
  * @param {string} [opts.status] -
  *          A string that described the query status. The values can be: `pending_review`, `reviewed`, `discarded`
  * @param {function} [callback] - Callback to handle processed record

package/lib/rest/autopilot/v1/assistant/task/field.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 FieldList(version: V1, assistantSid: string, taskSid: string): FieldListInstance;
@@ -49,7 +49,7 @@ interface FieldListInstance {
   /**
    * Constructs a field
    *
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   get(sid: string): FieldContext;
   /**
@@ -86,7 +86,7 @@ interface FieldListInstance {
 /**
  * Options to pass to create
  *
- * @property fieldType - The unique name or sid of the FieldType. It can be any Built-in Field Type or the unique_name or sid of a custom Field Type.
+ * @property fieldType - The Field Type of this field. It can be either a Built-in Field Type or the unique_name or sid of a custom Field Type.
  * @property uniqueName - A user-provided string that uniquely identifies this resource as an alternative to the sid. Unique up to 64 characters long.
  */
 interface FieldListInstanceCreateOptions {
@@ -177,9 +177,9 @@ declare class FieldContext {
    * Initialize the FieldContextPLEASE 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 sid - The sid
+   * @param assistantSid - The unique ID of the Assistant.
+   * @param taskSid - The unique ID of the Task associated with this Field.
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   constructor(version: V1, assistantSid: string, taskSid: string, sid: string);
 
@@ -205,18 +205,18 @@ declare class FieldInstance extends SerializableClass {
    * @property accountSid - The unique ID of the Account that created this Field.
    * @property dateCreated - The date that this resource was created
    * @property dateUpdated - The date that this resource was last updated
-   * @property fieldType - The Field Type of this field. It can be any Built-in Field Type or unique_name or the Field Type sid of a custom Field Type.
+   * @property fieldType - The Field Type of this field. It can be either a Built-in Field Type or the unique_name or sid of a custom Field Type.
    * @property taskSid - The unique ID of the Task associated with this Field.
-   * @property assistantSid - The unique ID of the parent Assistant.
-   * @property sid - A 34 character string that uniquely identifies this resource.
+   * @property assistantSid - The unique ID of the Assistant.
+   * @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
    *
    * @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.
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   constructor(version: V1, payload: FieldPayload, assistantSid: string, taskSid: string, sid: string);
 

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

@@ -27,7 +27,7 @@ var FieldContext;
  * 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 */
@@ -280,7 +280,7 @@ FieldList = function FieldList(version, assistantSid, taskSid) {
    *
    * @param {object} opts - Options for request
    * @param {string} opts.fieldType -
-   *          The unique name or sid of the FieldType. It can be any Built-in Field Type or the unique_name or sid of a custom Field Type.
+   *          The Field Type of this field. It can be either a Built-in Field Type or the unique_name or sid of a custom Field Type.
    * @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 {function} [callback] - Callback to handle processed record
@@ -332,7 +332,8 @@ FieldList = function FieldList(version, assistantSid, taskSid) {
   /**
    * Constructs a field
    *
-   * @param {string} sid - The sid
+   * @param {string} sid -
+   *          A 34-character string that uniquely identifies this resource.
    *
    * @returns {Twilio.Autopilot.V1.AssistantContext.TaskContext.FieldContext}
    */
@@ -394,21 +395,22 @@ FieldPage.prototype.getInstance = function getInstance(payload) {
  * @property {Date} dateCreated - The date that this resource was created
  * @property {Date} dateUpdated - The date that this resource was last updated
  * @property {string} fieldType -
- *          The Field Type of this field. It can be any Built-in Field Type or unique_name or the Field Type sid of a custom Field Type.
+ *          The Field Type of this field. It can be either a Built-in Field Type or the unique_name or sid of a custom Field Type.
  * @property {string} taskSid -
  *          The unique ID of the Task associated with this Field.
- * @property {string} assistantSid - The unique ID of the parent Assistant.
+ * @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} url - The url
  *
  * @param {V1} version - Version of the resource
  * @param {FieldPayload} 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.
- * @param {sid_like} sid - The sid
+ * @param {sid_like} sid -
+ *          A 34-character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 FieldInstance = function FieldInstance(version, payload, assistantSid, taskSid,
@@ -497,9 +499,11 @@ FieldInstance.prototype.toJSON = function toJSON() {
  * Initialize the FieldContextPLEASE 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} 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 Field.
+ * @param {sid_like} sid -
+ *          A 34-character string that uniquely identifies this resource.
  */
 /* jshint ignore:end */
 FieldContext = function FieldContext(version, assistantSid, taskSid, sid) {

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

@@ -23,9 +23,9 @@ declare function SampleList(version: V1, assistantSid: string, taskSid: string):
 /**
  * Options to pass to update
  *
- * @property language - An ISO language-country string that specifies the language used for this sample. For example: en-US.
- * @property 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
- * @property taggedText - The text example of how end-users may express this task. The sample may contain Field tag blocks.
+ * @property language - 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 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`
+ * @property taggedText - 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).
  */
 interface SampleInstanceUpdateOptions {
   language?: string;
@@ -62,7 +62,7 @@ interface SampleListInstance {
   /**
    * Constructs a sample
    *
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   get(sid: string): SampleContext;
   /**
@@ -99,9 +99,9 @@ interface SampleListInstance {
 /**
  * Options to pass to create
  *
- * @property language - An ISO language-country string that specifies the language used for this sample. For example: en-US.
- * @property 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
- * @property taggedText - The text example of how end-users may express this task. The sample may contain Field tag blocks.
+ * @property language - 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 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`
+ * @property taggedText - 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).
  */
 interface SampleListInstanceCreateOptions {
   language: string;
@@ -116,7 +116,7 @@ interface SampleListInstanceCreateOptions {
  *                         Function to process each record. If this and a positional
  *                         callback are passed, this one will be used
  * @property done - Function to be called upon completion of streaming
- * @property language - An ISO language-country string that specifies the language used for this sample. For example: en-US.
+ * @property language - 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 limit -
  *                         Upper limit for the number of records to return.
  *                         each() guarantees never to return more than limit.
@@ -139,7 +139,7 @@ interface SampleListInstanceEachOptions {
 /**
  * Options to pass to list
  *
- * @property language - An ISO language-country string that specifies the language used for this sample. For example: en-US.
+ * @property language - 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 limit -
  *                         Upper limit for the number of records to return.
  *                         list() guarantees never to return more than limit.
@@ -160,7 +160,7 @@ interface SampleListInstanceOptions {
 /**
  * Options to pass to page
  *
- * @property language - An ISO language-country string that specifies the language used for this sample. For example: en-US.
+ * @property language - 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 pageNumber - Page Number, this value is simply for client state
  * @property pageSize - Number of records to return, defaults to 50
  * @property pageToken - PageToken provided by the API
@@ -199,9 +199,9 @@ declare class SampleContext {
    * 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 version - Version of the resource
-   * @param assistantSid - The assistant_sid
-   * @param taskSid - The task_sid
-   * @param sid - The sid
+   * @param assistantSid - The unique ID of the Assistant.
+   * @param taskSid - The unique ID of the Task associated with this Sample.
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   constructor(version: V1, assistantSid: string, taskSid: string, sid: string);
 
@@ -235,18 +235,18 @@ declare class SampleInstance extends SerializableClass {
    * @property dateCreated - The date that this resource was created
    * @property dateUpdated - The date that this resource was last updated
    * @property taskSid - The unique ID of the Task associated with this Sample.
-   * @property language - An ISO language-country string that specifies the language used for this sample. For example: en-US.
+   * @property language - 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 assistantSid - The unique ID of the Assistant.
-   * @property sid - A 34 character string that uniquely identifies this resource.
-   * @property taggedText - The text example of how end-users may express this task. The sample may contain Field tag blocks.
+   * @property sid - A 34-character string that uniquely identifies this resource.
+   * @property taggedText - 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 url - The url
-   * @property 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
+   * @property 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`
    *
    * @param version - Version of the resource
    * @param payload - The instance payload
    * @param assistantSid - The unique ID of the Assistant.
    * @param taskSid - The unique ID of the Task associated with this Sample.
-   * @param sid - The sid
+   * @param sid - A 34-character string that uniquely identifies this resource.
    */
   constructor(version: V1, payload: SamplePayload, assistantSid: string, taskSid: string, sid: string);