diff --git a/lib/rest/accounts/v1/authTokenPromotion.ts b/lib/rest/accounts/v1/authTokenPromotion.ts index 8a43ca279a..cf77719fdc 100644 --- a/lib/rest/accounts/v1/authTokenPromotion.ts +++ b/lib/rest/accounts/v1/authTokenPromotion.ts @@ -110,19 +110,19 @@ export class AuthTokenPromotionInstance { } /** - * The SID of the Account that the secondary Auth Token was created for + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that the secondary Auth Token was created for. */ accountSid: string; /** - * The promoted Auth Token + * The promoted Auth Token that must be used to authenticate future API requests. */ authToken: string; /** - * The ISO 8601 formatted date and time in UTC when the resource was created + * The date and time in UTC when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 formatted date and time in UTC when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** diff --git a/lib/rest/accounts/v1/credential/aws.ts b/lib/rest/accounts/v1/credential/aws.ts index 6d35c28184..73d9663310 100644 --- a/lib/rest/accounts/v1/credential/aws.ts +++ b/lib/rest/accounts/v1/credential/aws.ts @@ -269,23 +269,23 @@ export class AwsInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the AWS resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the AWS resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** diff --git a/lib/rest/accounts/v1/credential/publicKey.ts b/lib/rest/accounts/v1/credential/publicKey.ts index 63c18eb722..42b0b3c48d 100644 --- a/lib/rest/accounts/v1/credential/publicKey.ts +++ b/lib/rest/accounts/v1/credential/publicKey.ts @@ -273,23 +273,23 @@ export class PublicKeyInstance { } /** - * The unique string that identifies the resource + * The unique string that that we created to identify the PublicKey resource. */ sid: string; /** - * The SID of the Account that created the Credential that the PublicKey resource belongs to + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Credential that the PublicKey resource belongs to. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** diff --git a/lib/rest/accounts/v1/secondaryAuthToken.ts b/lib/rest/accounts/v1/secondaryAuthToken.ts index 9b80c8b6f8..f99ee56c03 100644 --- a/lib/rest/accounts/v1/secondaryAuthToken.ts +++ b/lib/rest/accounts/v1/secondaryAuthToken.ts @@ -138,19 +138,19 @@ export class SecondaryAuthTokenInstance { } /** - * The SID of the Account that the secondary Auth Token was created for + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that the secondary Auth Token was created for. */ accountSid: string; /** - * The ISO 8601 formatted date and time in UTC when the resource was created + * The date and time in UTC when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 formatted date and time in UTC when the resource was last updated + * The date and time in UTC when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The generated secondary Auth Token + * The generated secondary Auth Token that can be used to authenticate future API requests. */ secondaryAuthToken: string; /** diff --git a/lib/rest/api/v2010/account.ts b/lib/rest/api/v2010/account.ts index a5b11c4932..2f48b49e37 100644 --- a/lib/rest/api/v2010/account.ts +++ b/lib/rest/api/v2010/account.ts @@ -502,23 +502,23 @@ export class AccountInstance { } /** - * The authorization token for this account + * The authorization token for this account. This token should be kept a secret, so no sharing. */ authToken: string; /** - * The date this account was created + * The date that this account was created, in GMT in RFC 2822 format */ dateCreated: Date; /** - * The date this account was last updated + * The date that this account was last updated, in GMT in RFC 2822 format. */ dateUpdated: Date; /** - * A human readable description of this account + * A human readable description of this account, up to 64 characters long. By default the FriendlyName is your email address. */ friendlyName: string; /** - * The unique 34 character id representing the parent of this account + * The unique 34 character id that represents the parent of this account. The OwnerAccountSid of a parent account is it\'s own sid. */ ownerAccountSid: string; /** @@ -527,7 +527,7 @@ export class AccountInstance { sid: string; status: AccountStatus; /** - * Account Instance Subresources + * A Map of various subresources available for the given Account Instance */ subresourceUris: Record; type: AccountType; diff --git a/lib/rest/api/v2010/account/address.ts b/lib/rest/api/v2010/account/address.ts index 3a030e1360..0bbd271f93 100644 --- a/lib/rest/api/v2010/account/address.ts +++ b/lib/rest/api/v2010/account/address.ts @@ -386,67 +386,67 @@ export class AddressInstance { } /** - * The SID of the Account that is responsible for the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that is responsible for the Address resource. */ accountSid: string; /** - * The city in which the address is located + * The city in which the address is located. */ city: string; /** - * The name associated with the address + * The name associated with the address.This property has a maximum length of 16 4-byte characters, or 21 3-byte characters. */ customerName: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The ISO country code of the address + * The ISO country code of the address. */ isoCountry: string; /** - * The postal code of the address + * The postal code of the address. */ postalCode: string; /** - * The state or region of the address + * The state or region of the address. */ region: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Address resource. */ sid: string; /** - * The number and street address of the address + * The number and street address of the address. */ street: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * Whether emergency calling has been enabled on this number + * Whether emergency calling has been enabled on this number. */ emergencyEnabled: boolean; /** - * Whether the address has been validated to comply with local regulation + * Whether the address has been validated to comply with local regulation. In countries that require valid addresses, an invalid address will not be accepted. `true` indicates the Address has been validated. `false` indicate the country doesn\'t require validation or the Address is not valid. */ validated: boolean; /** - * Whether the address has been verified to comply with regulation + * Whether the address has been verified to comply with regulation. In countries that require valid addresses, an invalid address will not be accepted. `true` indicates the Address has been verified. `false` indicate the country doesn\'t require verified or the Address is not valid. */ verified: boolean; /** - * The additional number and street address of the address + * The additional number and street address of the address. */ streetSecondary: string; diff --git a/lib/rest/api/v2010/account/address/dependentPhoneNumber.ts b/lib/rest/api/v2010/account/address/dependentPhoneNumber.ts index d368e08051..6faf1dc63e 100644 --- a/lib/rest/api/v2010/account/address/dependentPhoneNumber.ts +++ b/lib/rest/api/v2010/account/address/dependentPhoneNumber.ts @@ -371,101 +371,101 @@ export class DependentPhoneNumberInstance { } /** - * The unique string that identifies the resource + * The unique string that that we created to identify the DependentPhoneNumber resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the DependentPhoneNumber resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The URL we call when the phone number receives a call + * The URL we call when the phone number receives a call. The `voice_url` will not be used if a `voice_application_sid` or a `trunk_sid` is set. */ voiceUrl: string; /** - * The HTTP method used with the voice_url + * The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`. */ voiceMethod: DependentPhoneNumberVoiceMethod; /** - * The HTTP method used with voice_fallback_url + * The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`. */ voiceFallbackMethod: DependentPhoneNumberVoiceFallbackMethod; /** - * The URL we call when an error occurs in TwiML + * The URL that we call when an error occurs retrieving or executing the TwiML requested by `url`. */ voiceFallbackUrl: string; /** - * Whether to lookup the caller\'s name + * Whether we look up the caller\'s caller-ID name from the CNAM database. Can be: `true` or `false`. Caller ID lookups can cost $0.01 each. */ voiceCallerIdLookup: boolean; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The HTTP method used with sms_fallback_url + * The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`. */ smsFallbackMethod: DependentPhoneNumberSmsFallbackMethod; /** - * The URL that we call when an error occurs while retrieving or executing the TwiML + * The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`. */ smsFallbackUrl: string; /** - * The HTTP method to use with sms_url + * The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`. */ smsMethod: DependentPhoneNumberSmsMethod; /** - * The URL we call when the phone number receives an incoming SMS message + * The URL we call when the phone number receives an incoming SMS message. */ smsUrl: string; addressRequirements: DependentPhoneNumberAddressRequirement; /** - * Indicate if a phone can receive calls or messages + * The set of Boolean properties that indicates whether a phone number can receive calls or messages. Capabilities are `Voice`, `SMS`, and `MMS` and each capability can be: `true` or `false`. */ capabilities: any; /** - * The URL to send status information to your application + * The URL we call using the `status_callback_method` to send status information to your application. */ statusCallback: string; /** - * The HTTP method we use to call status_callback + * The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`. */ statusCallbackMethod: DependentPhoneNumberStatusCallbackMethod; /** - * The API version used to start a new TwiML session + * The API version used to start a new TwiML session. */ apiVersion: string; /** - * The SID of the application that handles SMS messages sent to the phone number + * The SID of the application that handles SMS messages sent to the phone number. If an `sms_application_sid` is present, we ignore all `sms_*_url` values and use those of the application. */ smsApplicationSid: string; /** - * The SID of the application that handles calls to the phone number + * The SID of the application that handles calls to the phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa. */ voiceApplicationSid: string; /** - * The SID of the Trunk that handles calls to the phone number + * The SID of the Trunk that handles calls to the phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa. */ trunkSid: string; emergencyStatus: DependentPhoneNumberEmergencyStatus; /** - * The emergency address configuration to use for emergency calling + * The SID of the emergency address configuration that we use for emergency calling from the phone number. */ emergencyAddressSid: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/application.ts b/lib/rest/api/v2010/account/application.ts index 0eb896528a..cc59a06816 100644 --- a/lib/rest/api/v2010/account/application.ts +++ b/lib/rest/api/v2010/account/application.ts @@ -439,83 +439,83 @@ export class ApplicationInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Application resource. */ accountSid: string; /** - * The API version used to start a new TwiML session + * The API version used to start a new TwiML session. */ apiVersion: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The URL to send message status information to your application + * The URL we call using a POST method to send message status information to your application. */ messageStatusCallback: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Application resource. */ sid: string; /** - * The HTTP method used with sms_fallback_url + * The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`. */ smsFallbackMethod: ApplicationSmsFallbackMethod; /** - * The URL that we call when an error occurs while retrieving or executing the TwiML + * The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`. */ smsFallbackUrl: string; /** - * The HTTP method to use with sms_url + * The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`. */ smsMethod: ApplicationSmsMethod; /** - * The URL to send status information to your application + * The URL we call using a POST method to send status information to your application about SMS messages that refer to the application. */ smsStatusCallback: string; /** - * The URL we call when the phone number receives an incoming SMS message + * The URL we call when the phone number receives an incoming SMS message. */ smsUrl: string; /** - * The URL to send status information to your application + * The URL we call using the `status_callback_method` to send status information to your application. */ statusCallback: string; /** - * The HTTP method we use to call status_callback + * The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`. */ statusCallbackMethod: ApplicationStatusCallbackMethod; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * Whether to lookup the caller\'s name + * Whether we look up the caller\'s caller-ID name from the CNAM database (additional charges apply). Can be: `true` or `false`. */ voiceCallerIdLookup: boolean; /** - * The HTTP method used with voice_fallback_url + * The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`. */ voiceFallbackMethod: ApplicationVoiceFallbackMethod; /** - * The URL we call when a TwiML error occurs + * The URL that we call when an error occurs retrieving or executing the TwiML requested by `url`. */ voiceFallbackUrl: string; /** - * The HTTP method used with the voice_url + * The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`. */ voiceMethod: ApplicationVoiceMethod; /** - * The URL we call when the phone number receives a call + * The URL we call when the phone number assigned to this application receives a call. */ voiceUrl: string; diff --git a/lib/rest/api/v2010/account/authorizedConnectApp.ts b/lib/rest/api/v2010/account/authorizedConnectApp.ts index 52c78f406a..b6a7545d33 100644 --- a/lib/rest/api/v2010/account/authorizedConnectApp.ts +++ b/lib/rest/api/v2010/account/authorizedConnectApp.ts @@ -194,43 +194,43 @@ export class AuthorizedConnectAppInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the AuthorizedConnectApp resource. */ accountSid: string; /** - * The company name set for the Connect App + * The company name set for the Connect App. */ connectAppCompanyName: string; /** - * A detailed description of the app + * A detailed description of the Connect App. */ connectAppDescription: string; /** - * The name of the Connect App + * The name of the Connect App. */ connectAppFriendlyName: string; /** - * The public URL for the Connect App + * The public URL for the Connect App. */ connectAppHomepageUrl: string; /** - * The SID that we assigned to the Connect App + * The SID that we assigned to the Connect App. */ connectAppSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * Permissions authorized to the app + * The set of permissions that you authorized for the Connect App. Can be: `get-all` or `post-all`. */ permissions: Array; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/availablePhoneNumberCountry.ts b/lib/rest/api/v2010/account/availablePhoneNumberCountry.ts index 4653e96991..fc187d2bd3 100644 --- a/lib/rest/api/v2010/account/availablePhoneNumberCountry.ts +++ b/lib/rest/api/v2010/account/availablePhoneNumberCountry.ts @@ -288,23 +288,23 @@ export class AvailablePhoneNumberCountryInstance { } /** - * The ISO-3166-1 country code of the country. + * The [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the country. */ countryCode: string; /** - * The name of the country + * The name of the country. */ country: string; /** - * The URI of the Country resource, relative to `https://api.twilio.com` + * The URI of the Country resource, relative to `https://api.twilio.com`. */ uri: string; /** - * Whether all phone numbers available in the country are new to the Twilio platform. + * Whether all phone numbers available in the country are new to the Twilio platform. `true` if they are and `false` if all numbers are not in the Twilio Phone Number Beta program. */ beta: boolean; /** - * A list of related resources identified by their relative URIs + * A list of related AvailablePhoneNumber resources identified by their URIs relative to `https://api.twilio.com`. */ subresourceUris: Record; diff --git a/lib/rest/api/v2010/account/availablePhoneNumberCountry/local.ts b/lib/rest/api/v2010/account/availablePhoneNumberCountry/local.ts index 9149065c93..dd956a7a6e 100644 --- a/lib/rest/api/v2010/account/availablePhoneNumberCountry/local.ts +++ b/lib/rest/api/v2010/account/availablePhoneNumberCountry/local.ts @@ -423,51 +423,51 @@ export class LocalInstance { } /** - * A formatted version of the phone number + * A formatted version of the phone number. */ friendlyName: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The LATA of this phone number + * The [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) of this phone number. Available for only phone numbers from the US and Canada. */ lata: string; /** - * The locality or city of this phone number\'s location + * The locality or city of this phone number\'s location. */ locality: string; /** - * The rate center of this phone number + * The [rate center](https://en.wikipedia.org/wiki/Telephone_exchange) of this phone number. Available for only phone numbers from the US and Canada. */ rateCenter: string; /** - * The latitude of this phone number\'s location + * The latitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ latitude: number; /** - * The longitude of this phone number\'s location + * The longitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ longitude: number; /** - * The two-letter state or province abbreviation of this phone number\'s location + * The two-letter state or province abbreviation of this phone number\'s location. Available for only phone numbers from the US and Canada. */ region: string; /** - * The postal or ZIP code of this phone number\'s location + * The postal or ZIP code of this phone number\'s location. Available for only phone numbers from the US and Canada. */ postalCode: string; /** - * The ISO country code of this phone number + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of this phone number. */ isoCountry: string; /** - * The type of Address resource the phone number requires + * The type of [Address](https://www.twilio.com/docs/usage/api/address) resource the phone number requires. Can be: `none`, `any`, `local`, or `foreign`. `none` means no address is required. `any` means an address is required, but it can be anywhere in the world. `local` means an address in the phone number\'s country is required. `foreign` means an address outside of the phone number\'s country is required. */ addressRequirements: string; /** - * Whether the phone number is new to the Twilio platform + * Whether the phone number is new to the Twilio platform. Can be: `true` or `false`. */ beta: boolean; capabilities: PhoneNumberCapabilities; diff --git a/lib/rest/api/v2010/account/availablePhoneNumberCountry/machineToMachine.ts b/lib/rest/api/v2010/account/availablePhoneNumberCountry/machineToMachine.ts index e0833e03d1..bdd047a8cc 100644 --- a/lib/rest/api/v2010/account/availablePhoneNumberCountry/machineToMachine.ts +++ b/lib/rest/api/v2010/account/availablePhoneNumberCountry/machineToMachine.ts @@ -434,51 +434,51 @@ export class MachineToMachineInstance { } /** - * A formatted version of the phone number + * A formatted version of the phone number. */ friendlyName: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The LATA of this phone number + * The [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) of this phone number. Available for only phone numbers from the US and Canada. */ lata: string; /** - * The locality or city of this phone number\'s location + * The locality or city of this phone number\'s location. */ locality: string; /** - * The rate center of this phone number + * The [rate center](https://en.wikipedia.org/wiki/Telephone_exchange) of this phone number. Available for only phone numbers from the US and Canada. */ rateCenter: string; /** - * The latitude of this phone number\'s location + * The latitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ latitude: number; /** - * The longitude of this phone number\'s location + * The longitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ longitude: number; /** - * The two-letter state or province abbreviation of this phone number\'s location + * The two-letter state or province abbreviation of this phone number\'s location. Available for only phone numbers from the US and Canada. */ region: string; /** - * The postal or ZIP code of this phone number\'s location + * The postal or ZIP code of this phone number\'s location. Available for only phone numbers from the US and Canada. */ postalCode: string; /** - * The ISO country code of this phone number + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of this phone number. */ isoCountry: string; /** - * The type of Address resource the phone number requires + * The type of [Address](https://www.twilio.com/docs/usage/api/address) resource the phone number requires. Can be: `none`, `any`, `local`, or `foreign`. `none` means no address is required. `any` means an address is required, but it can be anywhere in the world. `local` means an address in the phone number\'s country is required. `foreign` means an address outside of the phone number\'s country is required. */ addressRequirements: string; /** - * Whether the phone number is new to the Twilio platform + * Whether the phone number is new to the Twilio platform. Can be: `true` or `false`. */ beta: boolean; capabilities: PhoneNumberCapabilities; diff --git a/lib/rest/api/v2010/account/availablePhoneNumberCountry/mobile.ts b/lib/rest/api/v2010/account/availablePhoneNumberCountry/mobile.ts index 130f1148d1..cef6243042 100644 --- a/lib/rest/api/v2010/account/availablePhoneNumberCountry/mobile.ts +++ b/lib/rest/api/v2010/account/availablePhoneNumberCountry/mobile.ts @@ -424,51 +424,51 @@ export class MobileInstance { } /** - * A formatted version of the phone number + * A formatted version of the phone number. */ friendlyName: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The LATA of this phone number + * The [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) of this phone number. Available for only phone numbers from the US and Canada. */ lata: string; /** - * The locality or city of this phone number\'s location + * The locality or city of this phone number\'s location. */ locality: string; /** - * The rate center of this phone number + * The [rate center](https://en.wikipedia.org/wiki/Telephone_exchange) of this phone number. Available for only phone numbers from the US and Canada. */ rateCenter: string; /** - * The latitude of this phone number\'s location + * The latitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ latitude: number; /** - * The longitude of this phone number\'s location + * The longitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ longitude: number; /** - * The two-letter state or province abbreviation of this phone number\'s location + * The two-letter state or province abbreviation of this phone number\'s location. Available for only phone numbers from the US and Canada. */ region: string; /** - * The postal or ZIP code of this phone number\'s location + * The postal or ZIP code of this phone number\'s location. Available for only phone numbers from the US and Canada. */ postalCode: string; /** - * The ISO country code of this phone number + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of this phone number. */ isoCountry: string; /** - * The type of Address resource the phone number requires + * The type of [Address](https://www.twilio.com/docs/usage/api/address) resource the phone number requires. Can be: `none`, `any`, `local`, or `foreign`. `none` means no address is required. `any` means an address is required, but it can be anywhere in the world. `local` means an address in the phone number\'s country is required. `foreign` means an address outside of the phone number\'s country is required. */ addressRequirements: string; /** - * Whether the phone number is new to the Twilio platform + * Whether the phone number is new to the Twilio platform. Can be: `true` or `false`. */ beta: boolean; capabilities: PhoneNumberCapabilities; diff --git a/lib/rest/api/v2010/account/availablePhoneNumberCountry/national.ts b/lib/rest/api/v2010/account/availablePhoneNumberCountry/national.ts index efa987f577..702008f26f 100644 --- a/lib/rest/api/v2010/account/availablePhoneNumberCountry/national.ts +++ b/lib/rest/api/v2010/account/availablePhoneNumberCountry/national.ts @@ -425,51 +425,51 @@ export class NationalInstance { } /** - * A formatted version of the phone number + * A formatted version of the phone number. */ friendlyName: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The LATA of this phone number + * The [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) of this phone number. Available for only phone numbers from the US and Canada. */ lata: string; /** - * The locality or city of this phone number\'s location + * The locality or city of this phone number\'s location. */ locality: string; /** - * The rate center of this phone number + * The [rate center](https://en.wikipedia.org/wiki/Telephone_exchange) of this phone number. Available for only phone numbers from the US and Canada. */ rateCenter: string; /** - * The latitude of this phone number\'s location + * The latitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ latitude: number; /** - * The longitude of this phone number\'s location + * The longitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ longitude: number; /** - * The two-letter state or province abbreviation of this phone number\'s location + * The two-letter state or province abbreviation of this phone number\'s location. Available for only phone numbers from the US and Canada. */ region: string; /** - * The postal or ZIP code of this phone number\'s location + * The postal or ZIP code of this phone number\'s location. Available for only phone numbers from the US and Canada. */ postalCode: string; /** - * The ISO country code of this phone number + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of this phone number. */ isoCountry: string; /** - * The type of Address resource the phone number requires + * The type of [Address](https://www.twilio.com/docs/usage/api/address) resource the phone number requires. Can be: `none`, `any`, `local`, or `foreign`. `none` means no address is required. `any` means an address is required, but it can be anywhere in the world. `local` means an address in the phone number\'s country is required. `foreign` means an address outside of the phone number\'s country is required. */ addressRequirements: string; /** - * Whether the phone number is new to the Twilio platform + * Whether the phone number is new to the Twilio platform. Can be: `true` or `false`. */ beta: boolean; capabilities: PhoneNumberCapabilities; diff --git a/lib/rest/api/v2010/account/availablePhoneNumberCountry/sharedCost.ts b/lib/rest/api/v2010/account/availablePhoneNumberCountry/sharedCost.ts index 4a881d13e8..9a96faf3cb 100644 --- a/lib/rest/api/v2010/account/availablePhoneNumberCountry/sharedCost.ts +++ b/lib/rest/api/v2010/account/availablePhoneNumberCountry/sharedCost.ts @@ -425,51 +425,51 @@ export class SharedCostInstance { } /** - * A formatted version of the phone number + * A formatted version of the phone number. */ friendlyName: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The LATA of this phone number + * The [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) of this phone number. Available for only phone numbers from the US and Canada. */ lata: string; /** - * The locality or city of this phone number\'s location + * The locality or city of this phone number\'s location. */ locality: string; /** - * The rate center of this phone number + * The [rate center](https://en.wikipedia.org/wiki/Telephone_exchange) of this phone number. Available for only phone numbers from the US and Canada. */ rateCenter: string; /** - * The latitude of this phone number\'s location + * The latitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ latitude: number; /** - * The longitude of this phone number\'s location + * The longitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ longitude: number; /** - * The two-letter state or province abbreviation of this phone number\'s location + * The two-letter state or province abbreviation of this phone number\'s location. Available for only phone numbers from the US and Canada. */ region: string; /** - * The postal or ZIP code of this phone number\'s location + * The postal or ZIP code of this phone number\'s location. Available for only phone numbers from the US and Canada. */ postalCode: string; /** - * The ISO country code of this phone number + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of this phone number. */ isoCountry: string; /** - * The type of Address resource the phone number requires + * The type of [Address](https://www.twilio.com/docs/usage/api/address) resource the phone number requires. Can be: `none`, `any`, `local`, or `foreign`. `none` means no address is required. `any` means an address is required, but it can be anywhere in the world. `local` means an address in the phone number\'s country is required. `foreign` means an address outside of the phone number\'s country is required. */ addressRequirements: string; /** - * Whether the phone number is new to the Twilio platform + * Whether the phone number is new to the Twilio platform. Can be: `true` or `false`. */ beta: boolean; capabilities: PhoneNumberCapabilities; diff --git a/lib/rest/api/v2010/account/availablePhoneNumberCountry/tollFree.ts b/lib/rest/api/v2010/account/availablePhoneNumberCountry/tollFree.ts index 45e913d3e5..00ec93b9e8 100644 --- a/lib/rest/api/v2010/account/availablePhoneNumberCountry/tollFree.ts +++ b/lib/rest/api/v2010/account/availablePhoneNumberCountry/tollFree.ts @@ -425,51 +425,51 @@ export class TollFreeInstance { } /** - * A formatted version of the phone number + * A formatted version of the phone number. */ friendlyName: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The LATA of this phone number + * The [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) of this phone number. Available for only phone numbers from the US and Canada. */ lata: string; /** - * The locality or city of this phone number\'s location + * The locality or city of this phone number\'s location. */ locality: string; /** - * The rate center of this phone number + * The [rate center](https://en.wikipedia.org/wiki/Telephone_exchange) of this phone number. Available for only phone numbers from the US and Canada. */ rateCenter: string; /** - * The latitude of this phone number\'s location + * The latitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ latitude: number; /** - * The longitude of this phone number\'s location + * The longitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ longitude: number; /** - * The two-letter state or province abbreviation of this phone number\'s location + * The two-letter state or province abbreviation of this phone number\'s location. Available for only phone numbers from the US and Canada. */ region: string; /** - * The postal or ZIP code of this phone number\'s location + * The postal or ZIP code of this phone number\'s location. Available for only phone numbers from the US and Canada. */ postalCode: string; /** - * The ISO country code of this phone number + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of this phone number. */ isoCountry: string; /** - * The type of Address resource the phone number requires + * The type of [Address](https://www.twilio.com/docs/usage/api/address) resource the phone number requires. Can be: `none`, `any`, `local`, or `foreign`. `none` means no address is required. `any` means an address is required, but it can be anywhere in the world. `local` means an address in the phone number\'s country is required. `foreign` means an address outside of the phone number\'s country is required. */ addressRequirements: string; /** - * Whether the phone number is new to the Twilio platform + * Whether the phone number is new to the Twilio platform. Can be: `true` or `false`. */ beta: boolean; capabilities: PhoneNumberCapabilities; diff --git a/lib/rest/api/v2010/account/availablePhoneNumberCountry/voip.ts b/lib/rest/api/v2010/account/availablePhoneNumberCountry/voip.ts index e5827fa8f4..1241c55cee 100644 --- a/lib/rest/api/v2010/account/availablePhoneNumberCountry/voip.ts +++ b/lib/rest/api/v2010/account/availablePhoneNumberCountry/voip.ts @@ -423,51 +423,51 @@ export class VoipInstance { } /** - * A formatted version of the phone number + * A formatted version of the phone number. */ friendlyName: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The LATA of this phone number + * The [LATA](https://en.wikipedia.org/wiki/Local_access_and_transport_area) of this phone number. Available for only phone numbers from the US and Canada. */ lata: string; /** - * The locality or city of this phone number\'s location + * The locality or city of this phone number\'s location. */ locality: string; /** - * The rate center of this phone number + * The [rate center](https://en.wikipedia.org/wiki/Telephone_exchange) of this phone number. Available for only phone numbers from the US and Canada. */ rateCenter: string; /** - * The latitude of this phone number\'s location + * The latitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ latitude: number; /** - * The longitude of this phone number\'s location + * The longitude of this phone number\'s location. Available for only phone numbers from the US and Canada. */ longitude: number; /** - * The two-letter state or province abbreviation of this phone number\'s location + * The two-letter state or province abbreviation of this phone number\'s location. Available for only phone numbers from the US and Canada. */ region: string; /** - * The postal or ZIP code of this phone number\'s location + * The postal or ZIP code of this phone number\'s location. Available for only phone numbers from the US and Canada. */ postalCode: string; /** - * The ISO country code of this phone number + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of this phone number. */ isoCountry: string; /** - * The type of Address resource the phone number requires + * The type of [Address](https://www.twilio.com/docs/usage/api/address) resource the phone number requires. Can be: `none`, `any`, `local`, or `foreign`. `none` means no address is required. `any` means an address is required, but it can be anywhere in the world. `local` means an address in the phone number\'s country is required. `foreign` means an address outside of the phone number\'s country is required. */ addressRequirements: string; /** - * Whether the phone number is new to the Twilio platform + * Whether the phone number is new to the Twilio platform. Can be: `true` or `false`. */ beta: boolean; capabilities: PhoneNumberCapabilities; diff --git a/lib/rest/api/v2010/account/balance.ts b/lib/rest/api/v2010/account/balance.ts index 9fa998c882..5176639cd9 100644 --- a/lib/rest/api/v2010/account/balance.ts +++ b/lib/rest/api/v2010/account/balance.ts @@ -118,15 +118,15 @@ export class BalanceInstance { } /** - * Account Sid. + * The unique SID identifier of the Account. */ accountSid: string; /** - * Account balance + * The balance of the Account, in units specified by the unit parameter. Balance changes may not be reflected immediately. Child accounts do not contain balance information */ balance: string; /** - * Currency units + * The units of currency for the account balance */ currency: string; diff --git a/lib/rest/api/v2010/account/call.ts b/lib/rest/api/v2010/account/call.ts index 0da30ba96d..914f68c679 100644 --- a/lib/rest/api/v2010/account/call.ts +++ b/lib/rest/api/v2010/account/call.ts @@ -624,15 +624,15 @@ export class CallInstance { } /** - * The unique string that identifies this resource + * The unique string that we created to identify this Call resource. */ sid: string; /** - * The RFC 2822 date and time in GMT that this resource was created + * The date and time in GMT that this resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that this resource was last updated + * The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** @@ -640,23 +640,23 @@ export class CallInstance { */ parentCallSid: string; /** - * The SID of the Account that created this resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Call resource. */ accountSid: string; /** - * The phone number, SIP address or Client identifier that received this call. Phone numbers are in E.164 format (e.g., +16175551212). SIP addresses are formatted as `name@company.com`. Client identifiers are formatted `client:name`. + * The phone number, SIP address, Client identifier or SIM SID that received this call. Phone numbers are in [E.164](https://www.twilio.com/docs/glossary/what-e164) format (e.g., +16175551212). SIP addresses are formatted as `name@company.com`. Client identifiers are formatted `client:name`. SIM SIDs are formatted as `sim:sid`. */ to: string; /** - * The phone number, SIP address or Client identifier that received this call. Formatted for display. + * The phone number, SIP address or Client identifier that received this call. Formatted for display. Non-North American phone numbers are in [E.164](https://www.twilio.com/docs/glossary/what-e164) format (e.g., +442071838750). */ toFormatted: string; /** - * The phone number, SIP address or Client identifier that made this call. Phone numbers are in E.164 format (e.g., +16175551212). SIP addresses are formatted as `name@company.com`. Client identifiers are formatted `client:name`. + * The phone number, SIP address, Client identifier or SIM SID that made this call. Phone numbers are in [E.164](https://www.twilio.com/docs/glossary/what-e164) format (e.g., +16175551212). SIP addresses are formatted as `name@company.com`. Client identifiers are formatted `client:name`. SIM SIDs are formatted as `sim:sid`. */ from: string; /** - * The calling phone number, SIP address, or Client identifier formatted for display. + * The calling phone number, SIP address, or Client identifier formatted for display. Non-North American phone numbers are in [E.164](https://www.twilio.com/docs/glossary/what-e164) format (e.g., +442071838750). */ fromFormatted: string; /** @@ -665,15 +665,15 @@ export class CallInstance { phoneNumberSid: string; status: CallStatus; /** - * The start time of the call. Null if the call has not yet been dialed. + * The start time of the call, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. Empty if the call has not yet been dialed. */ startTime: Date; /** - * The end time of the call. Null if the call did not complete successfully. + * The time the call ended, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. Empty if the call did not complete successfully. */ endTime: Date; /** - * The length of the call in seconds. + * The length of the call in seconds. This value is empty for busy, failed, unanswered, or ongoing calls. */ duration: string; /** @@ -681,11 +681,11 @@ export class CallInstance { */ price: string; /** - * The currency in which `Price` is measured. + * The currency in which `Price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g., `USD`, `EUR`, `JPY`). Always capitalized for calls. */ priceUnit: string; /** - * A string describing the direction of the call. `inbound` for inbound calls, `outbound-api` for calls initiated via the REST API or `outbound-dial` for calls initiated by a `Dial` verb. + * A string describing the direction of the call. Can be: `inbound` for inbound calls, `outbound-api` for calls initiated via the REST API or `outbound-dial` for calls initiated by a `` verb. Using [Elastic SIP Trunking](https://www.twilio.com/docs/sip-trunking), the values can be [`trunking-terminating`](https://www.twilio.com/docs/sip-trunking#termination) for outgoing calls from your communications infrastructure to the PSTN or [`trunking-originating`](https://www.twilio.com/docs/sip-trunking#origination) for incoming calls to your communications infrastructure from the PSTN. */ direction: string; /** @@ -693,7 +693,7 @@ export class CallInstance { */ answeredBy: string; /** - * The API Version used to create the call + * The API version used to create the call. */ apiVersion: string; /** @@ -713,15 +713,15 @@ export class CallInstance { */ queueTime: string; /** - * The (optional) unique identifier of the trunk resource that was used for this call. + * The unique identifier of the trunk resource that was used for this call. The field is empty if the call was not made using a SIP trunk or if the call is not terminated. */ trunkSid: string; /** - * The URI of this resource, relative to `https://api.twilio.com` + * The URI of this resource, relative to `https://api.twilio.com`. */ uri: string; /** - * A list of related subresources identified by their relative URIs + * A list of subresources available to this call, identified by their URIs relative to `https://api.twilio.com`. */ subresourceUris: Record; diff --git a/lib/rest/api/v2010/account/call/event.ts b/lib/rest/api/v2010/account/call/event.ts index 56afac5e4a..24196a413c 100644 --- a/lib/rest/api/v2010/account/call/event.ts +++ b/lib/rest/api/v2010/account/call/event.ts @@ -255,11 +255,11 @@ export class EventInstance { } /** - * Call Request. + * Contains a dictionary representing the request of the call. */ request: any; /** - * Call Response with Events. + * Contains a dictionary representing the call response, including a list of the call events. */ response: any; diff --git a/lib/rest/api/v2010/account/call/feedback.ts b/lib/rest/api/v2010/account/call/feedback.ts index 873f3282de..f7be120c1a 100644 --- a/lib/rest/api/v2010/account/call/feedback.ts +++ b/lib/rest/api/v2010/account/call/feedback.ts @@ -227,27 +227,27 @@ export class FeedbackInstance { } /** - * The unique sid that identifies this account + * The unique id of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this resource. */ accountSid: string; /** - * The date this resource was created + * The date that this resource was created, given in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateCreated: Date; /** - * The date this resource was last updated + * The date that this resource was last updated, given in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateUpdated: Date; /** - * Issues experienced during the call + * A list of issues experienced during the call. The issues can be: `imperfect-audio`, `dropped-call`, `incorrect-caller-id`, `post-dial-delay`, `digits-not-captured`, `audio-latency`, `unsolicited-call`, or `one-way-audio`. */ issues: Array; /** - * 1 to 5 quality score + * `1` to `5` quality score where `1` represents imperfect experience and `5` represents a perfect call. */ qualityScore: number; /** - * A string that uniquely identifies this feedback resource + * A 34 character string that uniquely identifies this resource. */ sid: string; diff --git a/lib/rest/api/v2010/account/call/feedbackSummary.ts b/lib/rest/api/v2010/account/call/feedbackSummary.ts index f34bcc8c0e..c2d346077f 100644 --- a/lib/rest/api/v2010/account/call/feedbackSummary.ts +++ b/lib/rest/api/v2010/account/call/feedbackSummary.ts @@ -199,55 +199,55 @@ export class FeedbackSummaryInstance { } /** - * The unique sid that identifies this account + * The unique id of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this resource. */ accountSid: string; /** - * The total number of calls + * The total number of calls. */ callCount: number; /** - * The total number of calls with a feedback entry + * The total number of calls with a feedback entry. */ callFeedbackCount: number; /** - * The date this resource was created + * The date that this resource was created, given in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateCreated: Date; /** - * The date this resource was last updated + * The date that this resource was last updated, given in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateUpdated: Date; /** - * The latest feedback entry date in the summary + * The last date for which feedback entries are included in this Feedback Summary, formatted as `YYYY-MM-DD` and specified in UTC. */ endDate: Date; /** - * Whether the feedback summary includes subaccounts + * Whether the feedback summary includes subaccounts; `true` if it does, otherwise `false`. */ includeSubaccounts: boolean; /** - * Issues experienced during the call + * A list of issues experienced during the call. The issues can be: `imperfect-audio`, `dropped-call`, `incorrect-caller-id`, `post-dial-delay`, `digits-not-captured`, `audio-latency`, or `one-way-audio`. */ issues: Array; /** - * The average QualityScore of the feedback entries + * The average QualityScore of the feedback entries. */ qualityScoreAverage: number; /** - * The median QualityScore of the feedback entries + * The median QualityScore of the feedback entries. */ qualityScoreMedian: number; /** - * The standard deviation of the quality scores + * The standard deviation of the quality scores. */ qualityScoreStandardDeviation: number; /** - * A string that uniquely identifies this feedback entry + * A 34 character string that uniquely identifies this resource. */ sid: string; /** - * The earliest feedback entry date in the summary + * The first date for which feedback entries are included in this feedback summary, formatted as `YYYY-MM-DD` and specified in UTC. */ startDate: Date; status: CallFeedbackSummaryStatus; diff --git a/lib/rest/api/v2010/account/call/notification.ts b/lib/rest/api/v2010/account/call/notification.ts index 7be285c795..b23b5a59a1 100644 --- a/lib/rest/api/v2010/account/call/notification.ts +++ b/lib/rest/api/v2010/account/call/notification.ts @@ -238,71 +238,71 @@ export class NotificationInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Call Notification resource. */ accountSid: string; /** - * The API version used to create the Call Notification resource + * The API version used to create the Call Notification resource. */ apiVersion: string; /** - * The SID of the Call the resource is associated with + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Call Notification resource is associated with. */ callSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * A unique error code corresponding to the notification + * A unique error code for the error condition that is described in our [Error Dictionary](https://www.twilio.com/docs/api/errors). */ errorCode: string; /** - * An integer log level + * An integer log level that corresponds to the type of notification: `0` is ERROR, `1` is WARNING. */ log: string; /** - * The date the notification was generated + * The date the notification was actually generated in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. Message buffering can cause this value to differ from `date_created`. */ messageDate: Date; /** - * The text of the notification + * The text of the notification. */ messageText: string; /** - * A URL for more information about the error code + * The URL for more information about the error condition. This value is a page in our [Error Dictionary](https://www.twilio.com/docs/api/errors). */ moreInfo: string; /** - * HTTP method used with the request url + * The HTTP method used to generate the notification. If the notification was generated during a phone call, this is the HTTP Method used to request the resource on your server. If the notification was generated by your use of our REST API, this is the HTTP method used to call the resource on our servers. */ requestMethod: NotificationRequestMethod; /** - * URL of the resource that generated the notification + * The URL of the resource that generated the notification. If the notification was generated during a phone call, this is the URL of the resource on your server that caused the notification. If the notification was generated by your use of our REST API, this is the URL of the resource you called. */ requestUrl: string; /** - * Twilio-generated HTTP variables sent to the server + * The HTTP GET or POST variables we sent to your server. However, if the notification was generated by our REST API, this contains the HTTP POST or PUT variables you sent to our API. */ requestVariables: string; /** - * The HTTP body returned by your server + * The HTTP body returned by your server. */ responseBody: string; /** - * The HTTP headers returned by your server + * The HTTP headers returned by your server. */ responseHeaders: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Call Notification resource. */ sid: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/call/payment.ts b/lib/rest/api/v2010/account/call/payment.ts index 70c8275b96..56659e73d3 100644 --- a/lib/rest/api/v2010/account/call/payment.ts +++ b/lib/rest/api/v2010/account/call/payment.ts @@ -253,11 +253,11 @@ export class PaymentInstance { } /** - * The SID of the Account that created the Payments resource. + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Payments resource. */ accountSid: string; /** - * The SID of the Call the resource is associated with. + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Payments resource is associated with. This will refer to the call sid that is producing the payment card (credit/ACH) information thru DTMF. */ callSid: string; /** @@ -265,15 +265,15 @@ export class PaymentInstance { */ sid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/call/recording.ts b/lib/rest/api/v2010/account/call/recording.ts index edc2692dee..b67ac43531 100644 --- a/lib/rest/api/v2010/account/call/recording.ts +++ b/lib/rest/api/v2010/account/call/recording.ts @@ -359,65 +359,65 @@ export class RecordingInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Recording resource. */ accountSid: string; /** - * The API version used to make the recording + * The API version used to make the recording. */ apiVersion: string; /** - * The SID of the Call the resource is associated with + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Recording resource is associated with. */ callSid: string; /** - * The Conference SID that identifies the conference associated with the recording + * The Conference SID that identifies the conference associated with the recording, if a conference recording. */ conferenceSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The start time of the recording, given in RFC 2822 format + * The start time of the recording in GMT and in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ startTime: Date; /** - * The length of the recording in seconds + * The length of the recording in seconds. */ duration: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Recording resource. */ sid: string; /** - * The one-time cost of creating the recording. + * The one-time cost of creating the recording in the `price_unit` currency. */ price: number; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * How to decrypt the recording. + * How to decrypt the recording if it was encrypted using [Call Recording Encryption](https://www.twilio.com/docs/voice/tutorials/voice-recording-encryption) feature. */ encryptionDetails: any; /** - * The currency used in the price property. + * The currency used in the `price` property. Example: `USD`. */ priceUnit: string; status: CallRecordingStatus; /** - * The number of channels in the final recording file + * The number of channels in the final recording file. Can be: `1`, or `2`. Separating a two leg call into two separate channels of the recording file is supported in [Dial](https://www.twilio.com/docs/voice/twiml/dial#attributes-record) and [Outbound Rest API](https://www.twilio.com/docs/voice/make-calls) record options. */ channels: number; source: CallRecordingSource; /** - * More information about why the recording is missing, if status is `absent`. + * The error code that describes why the recording is `absent`. The error code is described in our [Error Dictionary](https://www.twilio.com/docs/api/errors). This value is null if the recording `status` is not `absent`. */ errorCode: number; /** diff --git a/lib/rest/api/v2010/account/call/siprec.ts b/lib/rest/api/v2010/account/call/siprec.ts index a28946c883..584474cc68 100644 --- a/lib/rest/api/v2010/account/call/siprec.ts +++ b/lib/rest/api/v2010/account/call/siprec.ts @@ -596,24 +596,24 @@ export class SiprecInstance { */ sid: string; /** - * The SID of the Account that created this resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Siprec resource. */ accountSid: string; /** - * The SID of the Call the resource is associated with + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Siprec resource is associated with. */ callSid: string; /** - * The name of this resource + * The user-specified name of this Siprec, if one was given when the Siprec was created. This may be used to stop the Siprec. */ name: string; status: SiprecStatus; /** - * The RFC 2822 date and time in GMT that this resource was last updated + * The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/call/stream.ts b/lib/rest/api/v2010/account/call/stream.ts index 8c8b4a1141..490e2a48e7 100644 --- a/lib/rest/api/v2010/account/call/stream.ts +++ b/lib/rest/api/v2010/account/call/stream.ts @@ -596,24 +596,24 @@ export class StreamInstance { */ sid: string; /** - * The SID of the Account that created this resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Stream resource. */ accountSid: string; /** - * The SID of the Call the resource is associated with + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Stream resource is associated with. */ callSid: string; /** - * The name of this resource + * The user-specified name of this Stream, if one was given when the Stream was created. This may be used to stop the Stream. */ name: string; status: StreamStatus; /** - * The RFC 2822 date and time in GMT that this resource was last updated + * The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/call/userDefinedMessage.ts b/lib/rest/api/v2010/account/call/userDefinedMessage.ts index cb1de5f712..1a6a714d11 100644 --- a/lib/rest/api/v2010/account/call/userDefinedMessage.ts +++ b/lib/rest/api/v2010/account/call/userDefinedMessage.ts @@ -160,19 +160,19 @@ export class UserDefinedMessageInstance { } /** - * Account SID. + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created User Defined Message. */ accountSid: string; /** - * Call SID. + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the User Defined Message is associated with. */ callSid: string; /** - * User Defined Message SID. + * The SID that uniquely identifies this User Defined Message. */ sid: string; /** - * The date this User Defined Message was created. + * The date that this User Defined Message was created, given in RFC 2822 format. */ dateCreated: Date; diff --git a/lib/rest/api/v2010/account/call/userDefinedMessageSubscription.ts b/lib/rest/api/v2010/account/call/userDefinedMessageSubscription.ts index ae2b05162d..9b49d6daa2 100644 --- a/lib/rest/api/v2010/account/call/userDefinedMessageSubscription.ts +++ b/lib/rest/api/v2010/account/call/userDefinedMessageSubscription.ts @@ -146,19 +146,19 @@ export class UserDefinedMessageSubscriptionInstance { } /** - * Account SID. + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that subscribed to the User Defined Messages. */ accountSid: string; /** - * Call SID. + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the User Defined Message Subscription is associated with. This refers to the Call SID that is producing the User Defined Messages. */ callSid: string; /** - * User Defined Message Subscription SID. + * The SID that uniquely identifies this User Defined Message Subscription. */ sid: string; /** - * The date this User Defined Message Subscription was created. + * The date that this User Defined Message Subscription was created, given in RFC 2822 format. */ dateCreated: Date; /** diff --git a/lib/rest/api/v2010/account/conference.ts b/lib/rest/api/v2010/account/conference.ts index 75833b539a..49d660af32 100644 --- a/lib/rest/api/v2010/account/conference.ts +++ b/lib/rest/api/v2010/account/conference.ts @@ -357,45 +357,45 @@ export class ConferenceInstance { } /** - * The SID of the Account that created this resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Conference resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT that this resource was created + * The date and time in GMT that this resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that this resource was last updated + * The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The API version used to create this conference + * The API version used to create this conference. */ apiVersion: string; /** - * A string that you assigned to describe this conference room + * A string that you assigned to describe this conference room. */ friendlyName: string; /** - * A string that represents the Twilio Region where the conference was mixed + * A string that represents the Twilio Region where the conference audio was mixed. May be `us1`, `ie1`, `de1`, `sg1`, `br1`, `au1`, and `jp1`. Basic conference audio will always be mixed in `us1`. Global Conference audio will be mixed nearest to the majority of participants. */ region: string; /** - * The unique string that identifies this resource + * The unique string that that we created to identify this Conference resource. */ sid: string; status: ConferenceStatus; /** - * The URI of this resource, relative to `https://api.twilio.com` + * The URI of this resource, relative to `https://api.twilio.com`. */ uri: string; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their URIs relative to `https://api.twilio.com`. */ subresourceUris: Record; reasonConferenceEnded: ConferenceReasonConferenceEnded; /** - * The call SID that caused the conference to end + * The call SID that caused the conference to end. */ callSidEndingConference: string; diff --git a/lib/rest/api/v2010/account/conference/participant.ts b/lib/rest/api/v2010/account/conference/participant.ts index 37fcee1003..bce4027505 100644 --- a/lib/rest/api/v2010/account/conference/participant.ts +++ b/lib/rest/api/v2010/account/conference/participant.ts @@ -478,56 +478,56 @@ export class ParticipantInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Participant resource. */ accountSid: string; /** - * The SID of the Call the resource is associated with + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Participant resource is associated with. */ callSid: string; /** - * The label of this participant + * The user-specified label of this participant, if one was given when the participant was created. This may be used to fetch, update or delete the participant. */ label: string; /** - * The SID of the participant who is being `coached` + * The SID of the participant who is being `coached`. The participant being coached is the only participant who can hear the participant who is `coaching`. */ callSidToCoach: string; /** - * Indicates if the participant changed to coach + * Whether the participant is coaching another call. Can be: `true` or `false`. If not present, defaults to `false` unless `call_sid_to_coach` is defined. If `true`, `call_sid_to_coach` must be defined. */ coaching: boolean; /** - * The SID of the conference the participant is in + * The SID of the conference the participant is in. */ conferenceSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * Whether the conference ends when the participant leaves + * Whether the conference ends when the participant leaves. Can be: `true` or `false` and the default is `false`. If `true`, the conference ends and all other participants drop out when the participant leaves. */ endConferenceOnExit: boolean; /** - * Whether the participant is muted + * Whether the participant is muted. Can be `true` or `false`. */ muted: boolean; /** - * Whether the participant is on hold + * Whether the participant is on hold. Can be `true` or `false`. */ hold: boolean; /** - * Whether the conference starts when the participant joins the conference + * Whether the conference starts when the participant joins the conference, if it has not already started. Can be: `true` or `false` and the default is `true`. If `false` and the conference has not started, the participant is muted and hears background music until another participant starts the conference. */ startConferenceOnEnter: boolean; status: ParticipantStatus; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/conference/recording.ts b/lib/rest/api/v2010/account/conference/recording.ts index 28ae204063..3abbba97ad 100644 --- a/lib/rest/api/v2010/account/conference/recording.ts +++ b/lib/rest/api/v2010/account/conference/recording.ts @@ -339,65 +339,65 @@ export class RecordingInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Conference Recording resource. */ accountSid: string; /** - * The API version used to create the recording + * The API version used to create the recording. */ apiVersion: string; /** - * The SID of the Call the resource is associated with + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Conference Recording resource is associated with. */ callSid: string; /** - * The Conference SID that identifies the conference associated with the recording + * The Conference SID that identifies the conference associated with the recording. */ conferenceSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The start time of the recording, given in RFC 2822 format + * The start time of the recording in GMT and in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ startTime: Date; /** - * The length of the recording in seconds + * The length of the recording in seconds. */ duration: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Conference Recording resource. */ sid: string; /** - * The one-time cost of creating the recording. + * The one-time cost of creating the recording in the `price_unit` currency. */ price: string; /** - * The currency used in the price property. + * The currency used in the `price` property. Example: `USD`. */ priceUnit: string; status: ConferenceRecordingStatus; /** - * The number of channels in the final recording file as an integer + * The number of channels in the final recording file. Can be: `1`, or `2`. Separating a two leg call into two separate channels of the recording file is supported in [Dial](https://www.twilio.com/docs/voice/twiml/dial#attributes-record) and [Outbound Rest API](https://www.twilio.com/docs/voice/make-calls) record options. */ channels: number; source: ConferenceRecordingSource; /** - * More information about why the recording is missing, if status is `absent`. + * The error code that describes why the recording is `absent`. The error code is described in our [Error Dictionary](https://www.twilio.com/docs/api/errors). This value is null if the recording `status` is not `absent`. */ errorCode: number; /** - * How to decrypt the recording. + * How to decrypt the recording if it was encrypted using [Call Recording Encryption](https://www.twilio.com/docs/voice/tutorials/voice-recording-encryption) feature. */ encryptionDetails: any; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/connectApp.ts b/lib/rest/api/v2010/account/connectApp.ts index 3b49925702..63ef1978b1 100644 --- a/lib/rest/api/v2010/account/connectApp.ts +++ b/lib/rest/api/v2010/account/connectApp.ts @@ -328,47 +328,47 @@ export class ConnectAppInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the ConnectApp resource. */ accountSid: string; /** - * The URL to redirect the user to after authorization + * The URL we redirect the user to after we authenticate the user and obtain authorization to access the Connect App. */ authorizeRedirectUrl: string; /** - * The company name set for the Connect App + * The company name set for the Connect App. */ companyName: string; /** - * The HTTP method we use to call deauthorize_callback_url + * The HTTP method we use to call `deauthorize_callback_url`. */ deauthorizeCallbackMethod: ConnectAppDeauthorizeCallbackMethod; /** - * The URL we call to de-authorize the Connect App + * The URL we call using the `deauthorize_callback_method` to de-authorize the Connect App. */ deauthorizeCallbackUrl: string; /** - * The description of the Connect App + * The description of the Connect App. */ description: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The URL users can obtain more information + * The public URL where users can obtain more information about this Connect App. */ homepageUrl: string; /** - * The set of permissions that your ConnectApp requests + * The set of permissions that your ConnectApp requests. */ permissions: Array; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the ConnectApp resource. */ sid: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/incomingPhoneNumber.ts b/lib/rest/api/v2010/account/incomingPhoneNumber.ts index 6d803ca101..e6359c1551 100644 --- a/lib/rest/api/v2010/account/incomingPhoneNumber.ts +++ b/lib/rest/api/v2010/account/incomingPhoneNumber.ts @@ -577,120 +577,120 @@ export class IncomingPhoneNumberInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this IncomingPhoneNumber resource. */ accountSid: string; /** - * The SID of the Address resource associated with the phone number + * The SID of the Address resource associated with the phone number. */ addressSid: string; addressRequirements: IncomingPhoneNumberAddressRequirement; /** - * The API version used to start a new TwiML session + * The API version used to start a new TwiML session. */ apiVersion: string; /** - * Whether the phone number is new to the Twilio platform + * Whether the phone number is new to the Twilio platform. Can be: `true` or `false`. */ beta: boolean; capabilities: PhoneNumberCapabilities; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The SID of the Identity resource associated with number + * The SID of the Identity resource that we associate with the phone number. Some regions require an Identity to meet local regulations. */ identitySid: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The phone number\'s origin. Can be twilio or hosted. + * The phone number\'s origin. `twilio` identifies Twilio-owned phone numbers and `hosted` identifies hosted phone numbers. */ origin: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify this IncomingPhoneNumber resource. */ sid: string; /** - * The SID of the application that handles SMS messages sent to the phone number + * The SID of the application that handles SMS messages sent to the phone number. If an `sms_application_sid` is present, we ignore all `sms_*_url` values and use those of the application. */ smsApplicationSid: string; /** - * The HTTP method used with sms_fallback_url + * The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`. */ smsFallbackMethod: IncomingPhoneNumberSmsFallbackMethod; /** - * The URL that we call when an error occurs while retrieving or executing the TwiML + * The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`. */ smsFallbackUrl: string; /** - * The HTTP method to use with sms_url + * The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`. */ smsMethod: IncomingPhoneNumberSmsMethod; /** - * The URL we call when the phone number receives an incoming SMS message + * The URL we call when the phone number receives an incoming SMS message. */ smsUrl: string; /** - * The URL to send status information to your application + * The URL we call using the `status_callback_method` to send status information to your application. */ statusCallback: string; /** - * The HTTP method we use to call status_callback + * The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`. */ statusCallbackMethod: IncomingPhoneNumberStatusCallbackMethod; /** - * The SID of the Trunk that handles calls to the phone number + * The SID of the Trunk that handles calls to the phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa. */ trunkSid: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; voiceReceiveMode: IncomingPhoneNumberVoiceReceiveMode; /** - * The SID of the application that handles calls to the phone number + * The SID of the application that handles calls to the phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa. */ voiceApplicationSid: string; /** - * Whether to lookup the caller\'s name + * Whether we look up the caller\'s caller-ID name from the CNAM database ($0.01 per look up). Can be: `true` or `false`. */ voiceCallerIdLookup: boolean; /** - * The HTTP method used with voice_fallback_url + * The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`. */ voiceFallbackMethod: IncomingPhoneNumberVoiceFallbackMethod; /** - * The URL we call when an error occurs in TwiML + * The URL that we call when an error occurs retrieving or executing the TwiML requested by `url`. */ voiceFallbackUrl: string; /** - * The HTTP method used with the voice_url + * The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`. */ voiceMethod: IncomingPhoneNumberVoiceMethod; /** - * The URL we call when the phone number receives a call + * The URL we call when the phone number receives a call. The `voice_url` will not be used if a `voice_application_sid` or a `trunk_sid` is set. */ voiceUrl: string; emergencyStatus: IncomingPhoneNumberEmergencyStatus; /** - * The emergency address configuration to use for emergency calling + * The SID of the emergency address configuration that we use for emergency calling from this phone number. */ emergencyAddressSid: string; emergencyAddressStatus: IncomingPhoneNumberEmergencyAddressStatus; /** - * The SID of the Bundle resource associated with number + * The SID of the Bundle resource that you associate with the phone number. Some regions require a Bundle to meet local Regulations. */ bundleSid: string; status: string; diff --git a/lib/rest/api/v2010/account/incomingPhoneNumber/assignedAddOn.ts b/lib/rest/api/v2010/account/incomingPhoneNumber/assignedAddOn.ts index 97b94548ca..9a2642000c 100644 --- a/lib/rest/api/v2010/account/incomingPhoneNumber/assignedAddOn.ts +++ b/lib/rest/api/v2010/account/incomingPhoneNumber/assignedAddOn.ts @@ -246,47 +246,47 @@ export class AssignedAddOnInstance { } /** - * The unique string that identifies the resource + * The unique string that that we created to identify the resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the resource. */ accountSid: string; /** - * The SID of the Phone Number that installed this Add-on + * The SID of the Phone Number to which the Add-on is assigned. */ resourceSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * A short description of the Add-on functionality + * A short description of the functionality that the Add-on provides. */ description: string; /** - * A JSON string that represents the current configuration + * A JSON string that represents the current configuration of this Add-on installation. */ configuration: any; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their relative URIs. */ subresourceUris: Record; diff --git a/lib/rest/api/v2010/account/incomingPhoneNumber/assignedAddOn/assignedAddOnExtension.ts b/lib/rest/api/v2010/account/incomingPhoneNumber/assignedAddOn/assignedAddOnExtension.ts index f526182874..5927a2fdf9 100644 --- a/lib/rest/api/v2010/account/incomingPhoneNumber/assignedAddOn/assignedAddOnExtension.ts +++ b/lib/rest/api/v2010/account/incomingPhoneNumber/assignedAddOn/assignedAddOnExtension.ts @@ -214,39 +214,39 @@ export class AssignedAddOnExtensionInstance { } /** - * The unique string that identifies the resource + * The unique string that that we created to identify the resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the resource. */ accountSid: string; /** - * The SID of the Phone Number to which the Add-on is assigned + * The SID of the Phone Number to which the Add-on is assigned. */ resourceSid: string; /** - * The SID that uniquely identifies the assigned Add-on installation + * The SID that uniquely identifies the assigned Add-on installation. */ assignedAddOnSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * A string that you assigned to describe the Product this Extension is used within + * A string that you assigned to describe the Product this Extension is used within. */ productName: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * Whether the Extension will be invoked + * Whether the Extension will be invoked. */ enabled: boolean; diff --git a/lib/rest/api/v2010/account/incomingPhoneNumber/local.ts b/lib/rest/api/v2010/account/incomingPhoneNumber/local.ts index 7a6a0ba34d..fd9ec2c46f 100644 --- a/lib/rest/api/v2010/account/incomingPhoneNumber/local.ts +++ b/lib/rest/api/v2010/account/incomingPhoneNumber/local.ts @@ -547,120 +547,120 @@ export class LocalInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the resource. */ accountSid: string; /** - * The SID of the Address resource associated with the phone number + * The SID of the Address resource associated with the phone number. */ addressSid: string; addressRequirements: IncomingPhoneNumberLocalAddressRequirement; /** - * The API version used to start a new TwiML session + * The API version used to start a new TwiML session. */ apiVersion: string; /** - * Whether the phone number is new to the Twilio platform + * Whether the phone number is new to the Twilio platform. Can be: `true` or `false`. */ beta: boolean; capabilities: PhoneNumberCapabilities; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The SID of the Identity resource associated with number + * The SID of the Identity resource that we associate with the phone number. Some regions require an Identity to meet local regulations. */ identitySid: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The phone number\'s origin. Can be twilio or hosted. + * The phone number\'s origin. `twilio` identifies Twilio-owned phone numbers and `hosted` identifies hosted phone numbers. */ origin: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the resource. */ sid: string; /** - * The SID of the Application resource to handle SMS messages + * The SID of the application that handles SMS messages sent to the phone number. If an `sms_application_sid` is present, we ignore all `sms_*_url` values and use those of the application. */ smsApplicationSid: string; /** - * The HTTP method used with sms_fallback_url + * The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`. */ smsFallbackMethod: LocalSmsFallbackMethod; /** - * The URL that we call when an error occurs while retrieving or executing the TwiML + * The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`. */ smsFallbackUrl: string; /** - * The HTTP method to use with sms_url + * The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`. */ smsMethod: LocalSmsMethod; /** - * The URL we call when the phone number receives an incoming SMS message + * The URL we call when the phone number receives an incoming SMS message. */ smsUrl: string; /** - * The URL to send status information to your application + * The URL we call using the `status_callback_method` to send status information to your application. */ statusCallback: string; /** - * The HTTP method we use to call status_callback + * The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`. */ statusCallbackMethod: LocalStatusCallbackMethod; /** - * The SID of the Trunk that handles calls to the phone number + * The SID of the Trunk that handles calls to the phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa. */ trunkSid: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; voiceReceiveMode: IncomingPhoneNumberLocalVoiceReceiveMode; /** - * The SID of the application that handles calls to the phone number + * The SID of the application that handles calls to the phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa. */ voiceApplicationSid: string; /** - * Whether to lookup the caller\'s name + * Whether we look up the caller\'s caller-ID name from the CNAM database ($0.01 per look up). Can be: `true` or `false`. */ voiceCallerIdLookup: boolean; /** - * The HTTP method used with voice_fallback_url + * The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`. */ voiceFallbackMethod: LocalVoiceFallbackMethod; /** - * The URL we call when an error occurs in TwiML + * The URL that we call when an error occurs retrieving or executing the TwiML requested by `url`. */ voiceFallbackUrl: string; /** - * The HTTP method used with the voice_url + * The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`. */ voiceMethod: LocalVoiceMethod; /** - * The URL we call when this phone number receives a call + * The URL we call when this phone number receives a call. The `voice_url` will not be used if a `voice_application_sid` or a `trunk_sid` is set. */ voiceUrl: string; emergencyStatus: IncomingPhoneNumberLocalEmergencyStatus; /** - * The emergency address configuration to use for emergency calling + * The SID of the emergency address configuration that we use for emergency calling from this phone number. */ emergencyAddressSid: string; emergencyAddressStatus: IncomingPhoneNumberLocalEmergencyAddressStatus; /** - * The SID of the Bundle resource associated with number + * The SID of the Bundle resource that you associate with the phone number. Some regions require a Bundle to meet local Regulations. */ bundleSid: string; status: string; diff --git a/lib/rest/api/v2010/account/incomingPhoneNumber/mobile.ts b/lib/rest/api/v2010/account/incomingPhoneNumber/mobile.ts index 27d08a6539..44c8f1bfed 100644 --- a/lib/rest/api/v2010/account/incomingPhoneNumber/mobile.ts +++ b/lib/rest/api/v2010/account/incomingPhoneNumber/mobile.ts @@ -548,120 +548,120 @@ export class MobileInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the resource. */ accountSid: string; /** - * The SID of the Address resource associated with the phone number + * The SID of the Address resource associated with the phone number. */ addressSid: string; addressRequirements: IncomingPhoneNumberMobileAddressRequirement; /** - * The API version used to start a new TwiML session + * The API version used to start a new TwiML session. */ apiVersion: string; /** - * Whether the phone number is new to the Twilio platform + * Whether the phone number is new to the Twilio platform. Can be: `true` or `false`. */ beta: boolean; capabilities: PhoneNumberCapabilities; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The SID of the Identity resource associated with number + * The SID of the Identity resource that we associate with the phone number. Some regions require an Identity to meet local regulations. */ identitySid: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The phone number\'s origin. Can be twilio or hosted. + * The phone number\'s origin. `twilio` identifies Twilio-owned phone numbers and `hosted` identifies hosted phone numbers. */ origin: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the resource. */ sid: string; /** - * The SID of the application that handles SMS messages sent to the phone number + * The SID of the application that handles SMS messages sent to the phone number. If an `sms_application_sid` is present, we ignore all `sms_*_url` values and use those of the application. */ smsApplicationSid: string; /** - * The HTTP method used with sms_fallback_url + * The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`. */ smsFallbackMethod: MobileSmsFallbackMethod; /** - * The URL that we call when an error occurs while retrieving or executing the TwiML + * The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`. */ smsFallbackUrl: string; /** - * The HTTP method to use with sms_url + * The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`. */ smsMethod: MobileSmsMethod; /** - * The URL we call when the phone number receives an incoming SMS message + * The URL we call when the phone number receives an incoming SMS message. */ smsUrl: string; /** - * The URL to send status information to your application + * The URL we call using the `status_callback_method` to send status information to your application. */ statusCallback: string; /** - * The HTTP method we use to call status_callback + * The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`. */ statusCallbackMethod: MobileStatusCallbackMethod; /** - * The SID of the Trunk that handles calls to the phone number + * The SID of the Trunk that handles calls to the phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa. */ trunkSid: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; voiceReceiveMode: IncomingPhoneNumberMobileVoiceReceiveMode; /** - * The SID of the application that handles calls to the phone number + * The SID of the application that handles calls to the phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa. */ voiceApplicationSid: string; /** - * Whether to lookup the caller\'s name + * Whether we look up the caller\'s caller-ID name from the CNAM database ($0.01 per look up). Can be: `true` or `false`. */ voiceCallerIdLookup: boolean; /** - * The HTTP method used with voice_fallback_url + * The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`. */ voiceFallbackMethod: MobileVoiceFallbackMethod; /** - * The URL we call when an error occurs in TwiML + * The URL that we call when an error occurs retrieving or executing the TwiML requested by `url`. */ voiceFallbackUrl: string; /** - * The HTTP method used with the voice_url + * The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`. */ voiceMethod: MobileVoiceMethod; /** - * The URL we call when the phone number receives a call + * The URL we call when the phone number receives a call. The `voice_url` will not be used if a `voice_application_sid` or a `trunk_sid` is set. */ voiceUrl: string; emergencyStatus: IncomingPhoneNumberMobileEmergencyStatus; /** - * The emergency address configuration to use for emergency calling + * The SID of the emergency address configuration that we use for emergency calling from this phone number. */ emergencyAddressSid: string; emergencyAddressStatus: IncomingPhoneNumberMobileEmergencyAddressStatus; /** - * The SID of the Bundle resource associated with number + * The SID of the Bundle resource that you associate with the phone number. Some regions require a Bundle to meet local Regulations. */ bundleSid: string; status: string; diff --git a/lib/rest/api/v2010/account/incomingPhoneNumber/tollFree.ts b/lib/rest/api/v2010/account/incomingPhoneNumber/tollFree.ts index 9225d1130b..4a492705dd 100644 --- a/lib/rest/api/v2010/account/incomingPhoneNumber/tollFree.ts +++ b/lib/rest/api/v2010/account/incomingPhoneNumber/tollFree.ts @@ -549,120 +549,120 @@ export class TollFreeInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the resource. */ accountSid: string; /** - * The SID of the Address resource associated with the phone number + * The SID of the Address resource associated with the phone number. */ addressSid: string; addressRequirements: IncomingPhoneNumberTollFreeAddressRequirement; /** - * The API version used to start a new TwiML session + * The API version used to start a new TwiML session. */ apiVersion: string; /** - * Whether the phone number is new to the Twilio platform + * Whether the phone number is new to the Twilio platform. Can be: `true` or `false`. */ beta: boolean; capabilities: PhoneNumberCapabilities; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The SID of the Identity resource associated with number + * The SID of the Identity resource that we associate with the phone number. Some regions require an Identity to meet local regulations. */ identitySid: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The phone number\'s origin. Can be twilio or hosted. + * The phone number\'s origin. `twilio` identifies Twilio-owned phone numbers and `hosted` identifies hosted phone numbers. */ origin: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the resource. */ sid: string; /** - * The SID of the application that handles SMS messages sent to the phone number + * The SID of the application that handles SMS messages sent to the phone number. If an `sms_application_sid` is present, we ignore all `sms_*_url` values and use those of the application. */ smsApplicationSid: string; /** - * The HTTP method used with sms_fallback_url + * The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`. */ smsFallbackMethod: TollFreeSmsFallbackMethod; /** - * The URL that we call when an error occurs while retrieving or executing the TwiML + * The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`. */ smsFallbackUrl: string; /** - * The HTTP method to use with sms_url + * The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`. */ smsMethod: TollFreeSmsMethod; /** - * The URL we call when the phone number receives an incoming SMS message + * The URL we call when the phone number receives an incoming SMS message. */ smsUrl: string; /** - * The URL to send status information to your application + * The URL we call using the `status_callback_method` to send status information to your application. */ statusCallback: string; /** - * The HTTP method we use to call status_callback + * The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`. */ statusCallbackMethod: TollFreeStatusCallbackMethod; /** - * The SID of the Trunk that handles calls to the phone number + * The SID of the Trunk that handles calls to the phone number. If a `trunk_sid` is present, we ignore all of the voice urls and voice applications and use those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa. */ trunkSid: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; voiceReceiveMode: IncomingPhoneNumberTollFreeVoiceReceiveMode; /** - * The SID of the application that handles calls to the phone number + * The SID of the application that handles calls to the phone number. If a `voice_application_sid` is present, we ignore all of the voice urls and use those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa. */ voiceApplicationSid: string; /** - * Whether to lookup the caller\'s name + * Whether we look up the caller\'s caller-ID name from the CNAM database ($0.01 per look up). Can be: `true` or `false`. */ voiceCallerIdLookup: boolean; /** - * The HTTP method used with voice_fallback_url + * The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`. */ voiceFallbackMethod: TollFreeVoiceFallbackMethod; /** - * The URL we call when an error occurs in TwiML + * The URL that we call when an error occurs retrieving or executing the TwiML requested by `url`. */ voiceFallbackUrl: string; /** - * The HTTP method used with the voice_url + * The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`. */ voiceMethod: TollFreeVoiceMethod; /** - * The URL we call when the phone number receives a call + * The URL we call when the phone number receives a call. The `voice_url` will not be used if a `voice_application_sid` or a `trunk_sid` is set. */ voiceUrl: string; emergencyStatus: IncomingPhoneNumberTollFreeEmergencyStatus; /** - * The emergency address configuration to use for emergency calling + * The SID of the emergency address configuration that we use for emergency calling from this phone number. */ emergencyAddressSid: string; emergencyAddressStatus: IncomingPhoneNumberTollFreeEmergencyAddressStatus; /** - * The SID of the Bundle resource associated with number + * The SID of the Bundle resource that you associate with the phone number. Some regions require a Bundle to meet local Regulations. */ bundleSid: string; status: string; diff --git a/lib/rest/api/v2010/account/key.ts b/lib/rest/api/v2010/account/key.ts index 12760f379b..adc249db4d 100644 --- a/lib/rest/api/v2010/account/key.ts +++ b/lib/rest/api/v2010/account/key.ts @@ -273,19 +273,19 @@ export class KeyInstance { } /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Key resource. */ sid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; diff --git a/lib/rest/api/v2010/account/message.ts b/lib/rest/api/v2010/account/message.ts index 338e79a0b2..9f0266c200 100644 --- a/lib/rest/api/v2010/account/message.ts +++ b/lib/rest/api/v2010/account/message.ts @@ -446,77 +446,77 @@ export class MessageInstance { } /** - * The message text + * The message text. Can be up to 1,600 characters long. */ body: string; /** - * The number of messages used to deliver the message body + * The number of segments that make up the complete message. A message body that is too large to be sent in a single SMS message is segmented and charged as multiple messages. Inbound messages over 160 characters are reassembled when the message is received. Note: When using a Messaging Service to send messages, `num_segments` will always be 0 in Twilio\'s response to your API request. */ numSegments: string; direction: MessageDirection; /** - * The phone number that initiated the message + * The phone number (in [E.164](https://en.wikipedia.org/wiki/E.164) format), [alphanumeric sender ID](https://www.twilio.com/docs/sms/send-messages#use-an-alphanumeric-sender-id), or [Wireless SIM](https://www.twilio.com/docs/wireless/tutorials/communications-guides/how-to-send-and-receive-text-messages) that initiated the message. For incoming messages, this will be the number of the sending phone. For outgoing messages, this value will be one of your Twilio phone numbers or the alphanumeric sender ID used. */ from: string; /** - * The phone number that received the message + * The phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format that received the message. For incoming messages, this will be one of your Twilio phone numbers. For outgoing messages, this will be the sending phone. */ to: string; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The amount billed for the message + * The amount billed for the message, in the currency specified by `price_unit`. Note that your account is charged for each segment we send to the handset. Populated after the message has been sent. May not be immediately available. */ price: string; /** - * The description of the error_code + * The description of the `error_code` if your message `status` is `failed` or `undelivered`. If the message was successful, this value is null. */ errorMessage: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that sent the message that created the resource. */ accountSid: string; /** - * The number of media files associated with the message + * The number of media files associated with the message. A message can send up to 10 media files. */ numMedia: string; status: MessageStatus; /** - * The SID of the Messaging Service used with the message. + * The SID of the [Messaging Service](https://www.twilio.com/docs/sms/services/api) used with the message. The value is null if a Messaging Service was not used. */ messagingServiceSid: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Message resource. */ sid: string; /** - * The RFC 2822 date and time in GMT when the message was sent + * The date and time in GMT that the resource was sent specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. For outgoing messages, this is when we sent the message. For incoming messages, this is when we made the HTTP request to your application. */ dateSent: Date; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The error code associated with the message + * The error code returned if your message `status` is `failed` or `undelivered`. The error_code provides more information about the failure. If the message was successful, this value is null. */ errorCode: number; /** - * The currency in which price is measured + * The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). */ priceUnit: string; /** - * The API version used to process the message + * The API version used to process the message. */ apiVersion: string; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their URIs relative to `https://api.twilio.com` */ subresourceUris: Record; diff --git a/lib/rest/api/v2010/account/message/feedback.ts b/lib/rest/api/v2010/account/message/feedback.ts index 9a234356a1..b77cc3a051 100644 --- a/lib/rest/api/v2010/account/message/feedback.ts +++ b/lib/rest/api/v2010/account/message/feedback.ts @@ -173,24 +173,24 @@ export class FeedbackInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the MessageFeedback resource. */ accountSid: string; /** - * The SID of the Message resource for which the feedback was provided + * The SID of the Message resource for which the feedback was provided. */ messageSid: string; outcome: MessageFeedbackOutcome; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/message/media.ts b/lib/rest/api/v2010/account/message/media.ts index 778d670461..ee12ccccde 100644 --- a/lib/rest/api/v2010/account/message/media.ts +++ b/lib/rest/api/v2010/account/message/media.ts @@ -232,31 +232,31 @@ export class MediaInstance { } /** - * The SID of the Account that created this resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Media resource. */ accountSid: string; /** - * The default mime-type of the media + * The default [mime-type](https://en.wikipedia.org/wiki/Internet_media_type) of the media, for example `image/jpeg`, `image/png`, or `image/gif` */ contentType: string; /** - * The RFC 2822 date and time in GMT that this resource was created + * The date and time in GMT that this resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that this resource was last updated + * The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The SID of the resource that created the media + * The SID of the resource that created the media. */ parentSid: string; /** - * The unique string that identifies this resource + * The unique string that that we created to identify this Media resource. */ sid: string; /** - * The URI of this resource, relative to `https://api.twilio.com` + * The URI of this resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/newKey.ts b/lib/rest/api/v2010/account/newKey.ts index 5de811e2c5..b70e48d447 100644 --- a/lib/rest/api/v2010/account/newKey.ts +++ b/lib/rest/api/v2010/account/newKey.ts @@ -162,23 +162,23 @@ export class NewKeyInstance { } /** - * The unique string that identifies the resource + * The unique string that that we created to identify the NewKey resource. You will use this as the basic-auth `user` when authenticating to the API. */ sid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the API Key was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the new API Key was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The secret your application uses to sign Access Tokens and to authenticate to the REST API. + * The secret your application uses to sign Access Tokens and to authenticate to the REST API (you will use this as the basic-auth `password`). **Note that for security reasons, this field is ONLY returned when the API Key is first created.** */ secret: string; diff --git a/lib/rest/api/v2010/account/newSigningKey.ts b/lib/rest/api/v2010/account/newSigningKey.ts index 52625c1f66..f5fbdf0fda 100644 --- a/lib/rest/api/v2010/account/newSigningKey.ts +++ b/lib/rest/api/v2010/account/newSigningKey.ts @@ -162,23 +162,23 @@ export class NewSigningKeyInstance { } /** - * The unique string that identifies the resource + * The unique string that that we created to identify the NewSigningKey resource. */ sid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The secret your application uses to sign Access Tokens and to authenticate to the REST API. + * The secret your application uses to sign Access Tokens and to authenticate to the REST API (you will use this as the basic-auth `password`). **Note that for security reasons, this field is ONLY returned when the API Key is first created.** */ secret: string; diff --git a/lib/rest/api/v2010/account/notification.ts b/lib/rest/api/v2010/account/notification.ts index 69ac46ced6..acad29811f 100644 --- a/lib/rest/api/v2010/account/notification.ts +++ b/lib/rest/api/v2010/account/notification.ts @@ -226,71 +226,71 @@ export class NotificationInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Notification resource. */ accountSid: string; /** - * The API version used to generate the notification + * The API version used to generate the notification. Can be empty for events that don\'t have a specific API version, such as incoming phone calls. */ apiVersion: string; /** - * The SID of the Call the resource is associated with + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Notification resource is associated with. */ callSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * A unique error code corresponding to the notification + * A unique error code for the error condition that is described in our [Error Dictionary](https://www.twilio.com/docs/api/errors). */ errorCode: string; /** - * An integer log level + * An integer log level that corresponds to the type of notification: `0` is ERROR, `1` is WARNING. */ log: string; /** - * The date the notification was generated + * The date the notification was actually generated in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. Message buffering can cause this value to differ from `date_created`. */ messageDate: Date; /** - * The text of the notification + * The text of the notification. */ messageText: string; /** - * A URL for more information about the error code + * The URL for more information about the error condition. This value is a page in our [Error Dictionary](https://www.twilio.com/docs/api/errors). */ moreInfo: string; /** - * HTTP method used with the request url + * The HTTP method used to generate the notification. If the notification was generated during a phone call, this is the HTTP Method used to request the resource on your server. If the notification was generated by your use of our REST API, this is the HTTP method used to call the resource on our servers. */ requestMethod: NotificationRequestMethod; /** - * URL of the resource that generated the notification + * The URL of the resource that generated the notification. If the notification was generated during a phone call, this is the URL of the resource on your server that caused the notification. If the notification was generated by your use of our REST API, this is the URL of the resource you called. */ requestUrl: string; /** - * Twilio-generated HTTP variables sent to the server + * The HTTP GET or POST variables we sent to your server. However, if the notification was generated by our REST API, this contains the HTTP POST or PUT variables you sent to our API. */ requestVariables: string; /** - * The HTTP body returned by your server + * The HTTP body returned by your server. */ responseBody: string; /** - * The HTTP headers returned by your server + * The HTTP headers returned by your server. */ responseHeaders: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Notification resource. */ sid: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/outgoingCallerId.ts b/lib/rest/api/v2010/account/outgoingCallerId.ts index d04dc538ad..3994401ed6 100644 --- a/lib/rest/api/v2010/account/outgoingCallerId.ts +++ b/lib/rest/api/v2010/account/outgoingCallerId.ts @@ -294,31 +294,31 @@ export class OutgoingCallerIdInstance { } /** - * The unique string that identifies the resource + * The unique string that that we created to identify the OutgoingCallerId resource. */ sid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the OutgoingCallerId resource. */ accountSid: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/queue.ts b/lib/rest/api/v2010/account/queue.ts index 76f7a568d4..9b51b72ed1 100644 --- a/lib/rest/api/v2010/account/queue.ts +++ b/lib/rest/api/v2010/account/queue.ts @@ -312,7 +312,7 @@ export class QueueInstance { } /** - * The RFC 2822 date and time in GMT that this resource was last updated + * The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** @@ -320,31 +320,31 @@ export class QueueInstance { */ currentSize: number; /** - * A string that you assigned to describe this resource + * A string that you assigned to describe this resource. */ friendlyName: string; /** - * The URI of this resource, relative to `https://api.twilio.com` + * The URI of this resource, relative to `https://api.twilio.com`. */ uri: string; /** - * The SID of the Account that created this resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Queue resource. */ accountSid: string; /** - * Average wait time of members in the queue + * The average wait time in seconds of the members in this queue. This is calculated at the time of the request. */ averageWaitTime: number; /** - * The unique string that identifies this resource + * The unique string that that we created to identify this Queue resource. */ sid: string; /** - * The RFC 2822 date and time in GMT that this resource was created + * The date and time in GMT that this resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The max number of calls allowed in the queue + * The maximum number of calls that can be in the queue. The default is 100 and the maximum is 5000. */ maxSize: number; diff --git a/lib/rest/api/v2010/account/queue/member.ts b/lib/rest/api/v2010/account/queue/member.ts index e947a1b2c5..5ed369ca9e 100644 --- a/lib/rest/api/v2010/account/queue/member.ts +++ b/lib/rest/api/v2010/account/queue/member.ts @@ -253,11 +253,11 @@ export class MemberInstance { } /** - * The SID of the Call the resource is associated with + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Member resource is associated with. */ callSid: string; /** - * The date the member was enqueued + * The date that the member was enqueued, given in RFC 2822 format. */ dateEnqueued: Date; /** @@ -265,7 +265,7 @@ export class MemberInstance { */ position: number; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** @@ -273,7 +273,7 @@ export class MemberInstance { */ waitTime: number; /** - * The SID of the Queue the member is in + * The SID of the Queue the member is in. */ queueSid: string; diff --git a/lib/rest/api/v2010/account/recording.ts b/lib/rest/api/v2010/account/recording.ts index f3346389ff..c25ea82fd0 100644 --- a/lib/rest/api/v2010/account/recording.ts +++ b/lib/rest/api/v2010/account/recording.ts @@ -348,7 +348,7 @@ export class RecordingInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Recording resource. */ accountSid: string; /** @@ -356,23 +356,23 @@ export class RecordingInstance { */ apiVersion: string; /** - * The SID of the Call the resource is associated with + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Recording resource is associated with. This will always refer to the parent leg of a two-leg call. */ callSid: string; /** - * The unique ID for the conference associated with the recording. + * The Conference SID that identifies the conference associated with the recording, if a conference recording. */ conferenceSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The start time of the recording, given in RFC 2822 format + * The start time of the recording in GMT and in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ startTime: Date; /** @@ -380,41 +380,41 @@ export class RecordingInstance { */ duration: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Recording resource. */ sid: string; /** - * The one-time cost of creating the recording. + * The one-time cost of creating the recording in the `price_unit` currency. */ price: string; /** - * The currency used in the price property. + * The currency used in the `price` property. Example: `USD`. */ priceUnit: string; status: RecordingStatus; /** - * The number of channels in the final recording file as an integer. + * The number of channels in the final recording file. Can be: `1` or `2`. You can split a call with two legs into two separate recording channels if you record using [TwiML Dial](https://www.twilio.com/docs/voice/twiml/dial#record) or the [Outbound Rest API](https://www.twilio.com/docs/voice/make-calls#manage-your-outbound-call). */ channels: number; source: RecordingSource; /** - * More information about why the recording is missing, if status is `absent`. + * The error code that describes why the recording is `absent`. The error code is described in our [Error Dictionary](https://www.twilio.com/docs/api/errors). This value is null if the recording `status` is not `absent`. */ errorCode: number; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * How to decrypt the recording. + * How to decrypt the recording if it was encrypted using [Call Recording Encryption](https://www.twilio.com/docs/voice/tutorials/voice-recording-encryption) feature. */ encryptionDetails: any; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their relative URIs. */ subresourceUris: Record; /** - * The URL of the media file. + * The URL of the media file associated with this recording resource. When stored externally, this is the full URL location of the media file. */ mediaUrl: string; diff --git a/lib/rest/api/v2010/account/recording/addOnResult.ts b/lib/rest/api/v2010/account/recording/addOnResult.ts index 5a0cf05917..a74c921b4a 100644 --- a/lib/rest/api/v2010/account/recording/addOnResult.ts +++ b/lib/rest/api/v2010/account/recording/addOnResult.ts @@ -247,40 +247,40 @@ export class AddOnResultInstance { } /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Recording AddOnResult resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Recording AddOnResult resource. */ accountSid: string; status: RecordingAddOnResultStatus; /** - * The SID of the Add-on to which the result belongs + * The SID of the Add-on to which the result belongs. */ addOnSid: string; /** - * The SID of the Add-on configuration + * The SID of the Add-on configuration. */ addOnConfigurationSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The date and time in GMT that the result was completed + * The date and time in GMT that the result was completed specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCompleted: Date; /** - * The SID of the recording to which the AddOnResult resource belongs + * The SID of the recording to which the AddOnResult resource belongs. */ referenceSid: string; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their relative URIs. */ subresourceUris: Record; diff --git a/lib/rest/api/v2010/account/recording/addOnResult/payload.ts b/lib/rest/api/v2010/account/recording/addOnResult/payload.ts index 07a95ec81c..4358f34625 100644 --- a/lib/rest/api/v2010/account/recording/addOnResult/payload.ts +++ b/lib/rest/api/v2010/account/recording/addOnResult/payload.ts @@ -235,47 +235,47 @@ export class PayloadInstance { } /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Recording AddOnResult Payload resource. */ sid: string; /** - * The SID of the AddOnResult to which the payload belongs + * The SID of the AddOnResult to which the payload belongs. */ addOnResultSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Recording AddOnResult Payload resource. */ accountSid: string; /** - * The string that describes the payload + * The string provided by the vendor that describes the payload. */ label: string; /** - * The SID of the Add-on to which the result belongs + * The SID of the Add-on to which the result belongs. */ addOnSid: string; /** - * The SID of the Add-on configuration + * The SID of the Add-on configuration. */ addOnConfigurationSid: string; /** - * The MIME type of the payload + * The MIME type of the payload. */ contentType: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The SID of the recording to which the AddOnResult resource that contains the payload belongs + * The SID of the recording to which the AddOnResult resource that contains the payload belongs. */ referenceSid: string; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their relative URIs. */ subresourceUris: Record; diff --git a/lib/rest/api/v2010/account/recording/transcription.ts b/lib/rest/api/v2010/account/recording/transcription.ts index 381e28f9fd..6dcf0a255e 100644 --- a/lib/rest/api/v2010/account/recording/transcription.ts +++ b/lib/rest/api/v2010/account/recording/transcription.ts @@ -228,19 +228,19 @@ export class TranscriptionInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Transcription resource. */ accountSid: string; /** - * The API version used to create the transcription + * The API version used to create the transcription. */ apiVersion: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** @@ -248,19 +248,19 @@ export class TranscriptionInstance { */ duration: string; /** - * The charge for the transcription + * The charge for the transcript in the currency associated with the account. This value is populated after the transcript is complete so it may not be available immediately. */ price: number; /** - * The currency in which price is measured + * The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). */ priceUnit: string; /** - * The SID that identifies the transcription\'s recording + * The SID of the [Recording](https://www.twilio.com/docs/voice/api/recording) from which the transcription was created. */ recordingSid: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Transcription resource. */ sid: string; status: RecordingTranscriptionStatus; @@ -269,11 +269,11 @@ export class TranscriptionInstance { */ transcriptionText: string; /** - * The transcription type + * The transcription type. */ type: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/shortCode.ts b/lib/rest/api/v2010/account/shortCode.ts index 12f649473f..46cad874fb 100644 --- a/lib/rest/api/v2010/account/shortCode.ts +++ b/lib/rest/api/v2010/account/shortCode.ts @@ -307,23 +307,23 @@ export class ShortCodeInstance { } /** - * The SID of the Account that created this resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this ShortCode resource. */ accountSid: string; /** - * The API version used to start a new TwiML session + * The API version used to start a new TwiML session when an SMS message is sent to this short code. */ apiVersion: string; /** - * The RFC 2822 date and time in GMT that this resource was created + * The date and time in GMT that this resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that this resource was last updated + * The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * A string that you assigned to describe this resource + * A string that you assigned to describe this resource. By default, the `FriendlyName` is the short code. */ friendlyName: string; /** @@ -331,27 +331,27 @@ export class ShortCodeInstance { */ shortCode: string; /** - * The unique string that identifies this resource + * The unique string that that we created to identify this ShortCode resource. */ sid: string; /** - * HTTP method we use to call the sms_fallback_url + * The HTTP method we use to call the `sms_fallback_url`. Can be: `GET` or `POST`. */ smsFallbackMethod: ShortCodeSmsFallbackMethod; /** - * URL Twilio will request if an error occurs in executing TwiML + * The URL that we call if an error occurs while retrieving or executing the TwiML from `sms_url`. */ smsFallbackUrl: string; /** - * HTTP method to use when requesting the sms url + * The HTTP method we use to call the `sms_url`. Can be: `GET` or `POST`. */ smsMethod: ShortCodeSmsMethod; /** - * URL we call when receiving an incoming SMS message to this short code + * The URL we call when receiving an incoming SMS message to this short code. */ smsUrl: string; /** - * The URI of this resource, relative to `https://api.twilio.com` + * The URI of this resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/sip/credentialList.ts b/lib/rest/api/v2010/account/sip/credentialList.ts index d8bbc8d2a1..7010cd853a 100644 --- a/lib/rest/api/v2010/account/sip/credentialList.ts +++ b/lib/rest/api/v2010/account/sip/credentialList.ts @@ -297,31 +297,31 @@ export class CredentialListInstance { } /** - * The unique sid that identifies this account + * The unique id of the [Account](https://www.twilio.com/docs/iam/api/account) that owns this resource. */ accountSid: string; /** - * The date this resource was created + * The date that this resource was created, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateCreated: Date; /** - * The date this resource was last updated + * The date that this resource was last updated, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateUpdated: Date; /** - * Human readable descriptive text + * A human readable descriptive text that describes the CredentialList, up to 64 characters long. */ friendlyName: string; /** - * A string that uniquely identifies this credential + * A 34 character string that uniquely identifies this resource. */ sid: string; /** - * The list of credentials associated with this credential list. + * A list of credentials associated with this credential list. */ subresourceUris: Record; /** - * The URI for this resource + * The URI for this resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/sip/credentialList/credential.ts b/lib/rest/api/v2010/account/sip/credentialList/credential.ts index 0001c7f8ff..adf8ffda07 100644 --- a/lib/rest/api/v2010/account/sip/credentialList/credential.ts +++ b/lib/rest/api/v2010/account/sip/credentialList/credential.ts @@ -309,7 +309,7 @@ export class CredentialInstance { */ accountSid: string; /** - * The unique id that identifies the credential list that includes this credential + * The unique id that identifies the credential list that includes this credential. */ credentialListSid: string; /** @@ -317,15 +317,15 @@ export class CredentialInstance { */ username: string; /** - * The date that this resource was created, given as GMT in RFC 2822 format. + * The date that this resource was created, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateCreated: Date; /** - * The date that this resource was last updated, given as GMT in RFC 2822 format. + * The date that this resource was last updated, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateUpdated: Date; /** - * The URI for this resource, relative to https://api.twilio.com + * The URI for this resource, relative to `https://api.twilio.com` */ uri: string; diff --git a/lib/rest/api/v2010/account/sip/domain.ts b/lib/rest/api/v2010/account/sip/domain.ts index c4527ba91b..57bd39a7fe 100644 --- a/lib/rest/api/v2010/account/sip/domain.ts +++ b/lib/rest/api/v2010/account/sip/domain.ts @@ -454,87 +454,87 @@ export class DomainInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the SipDomain resource. */ accountSid: string; /** - * The API version used to process the call + * The API version used to process the call. */ apiVersion: string; /** - * The types of authentication mapped to the domain + * The types of authentication you have mapped to your domain. Can be: `IP_ACL` and `CREDENTIAL_LIST`. If you have both defined for your domain, both will be returned in a comma delimited string. If `auth_type` is not defined, the domain will not be able to receive any traffic. */ authType: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The unique address on Twilio to route SIP traffic + * The unique address you reserve on Twilio to which you route your SIP traffic. Domain names can contain letters, digits, and \"-\" and must end with `sip.twilio.com`. */ domainName: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the SipDomain resource. */ sid: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * The HTTP method used with voice_fallback_url + * The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`. */ voiceFallbackMethod: DomainVoiceFallbackMethod; /** - * The URL we call when an error occurs while executing TwiML + * The URL that we call when an error occurs while retrieving or executing the TwiML requested from `voice_url`. */ voiceFallbackUrl: string; /** - * The HTTP method to use with voice_url + * The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`. */ voiceMethod: DomainVoiceMethod; /** - * The HTTP method we use to call voice_status_callback_url + * The HTTP method we use to call `voice_status_callback_url`. Either `GET` or `POST`. */ voiceStatusCallbackMethod: DomainVoiceStatusCallbackMethod; /** - * The URL that we call with status updates + * The URL that we call to pass status parameters (such as call ended) to your application. */ voiceStatusCallbackUrl: string; /** - * The URL we call when receiving a call + * The URL we call using the `voice_method` when the domain receives a call. */ voiceUrl: string; /** - * A list mapping resources associated with the SIP Domain resource + * A list of mapping resources associated with the SIP Domain resource identified by their relative URIs. */ subresourceUris: Record; /** - * Whether SIP registration is allowed + * Whether to allow SIP Endpoints to register with the domain to receive calls. */ sipRegistration: boolean; /** - * Whether emergency calling is enabled for the domain. + * Whether emergency calling is enabled for the domain. If enabled, allows emergency calls on the domain from phone numbers with validated addresses. */ emergencyCallingEnabled: boolean; /** - * Whether secure SIP is enabled for the domain + * Whether secure SIP is enabled for the domain. If enabled, TLS will be enforced and SRTP will be negotiated on all incoming calls to this sip domain. */ secure: boolean; /** - * The SID of the BYOC Trunk resource. + * The SID of the BYOC Trunk(Bring Your Own Carrier) resource that the Sip Domain will be associated with. */ byocTrunkSid: string; /** - * Whether an emergency caller sid is configured for the domain. + * Whether an emergency caller sid is configured for the domain. If present, this phone number will be used as the callback for the emergency call. */ emergencyCallerSid: string; diff --git a/lib/rest/api/v2010/account/sip/domain/authTypes/authTypeCalls/authCallsCredentialListMapping.ts b/lib/rest/api/v2010/account/sip/domain/authTypes/authTypeCalls/authCallsCredentialListMapping.ts index 56e86340db..c3c96c235e 100644 --- a/lib/rest/api/v2010/account/sip/domain/authTypes/authTypeCalls/authCallsCredentialListMapping.ts +++ b/lib/rest/api/v2010/account/sip/domain/authTypes/authTypeCalls/authCallsCredentialListMapping.ts @@ -228,23 +228,23 @@ export class AuthCallsCredentialListMappingInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the CredentialListMapping resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the CredentialListMapping resource. */ sid: string; diff --git a/lib/rest/api/v2010/account/sip/domain/authTypes/authTypeCalls/authCallsIpAccessControlListMapping.ts b/lib/rest/api/v2010/account/sip/domain/authTypes/authTypeCalls/authCallsIpAccessControlListMapping.ts index 67364cffa5..15ec17b28a 100644 --- a/lib/rest/api/v2010/account/sip/domain/authTypes/authTypeCalls/authCallsIpAccessControlListMapping.ts +++ b/lib/rest/api/v2010/account/sip/domain/authTypes/authTypeCalls/authCallsIpAccessControlListMapping.ts @@ -229,23 +229,23 @@ export class AuthCallsIpAccessControlListMappingInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the IpAccessControlListMapping resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the IpAccessControlListMapping resource. */ sid: string; diff --git a/lib/rest/api/v2010/account/sip/domain/authTypes/authTypeRegistrations/authRegistrationsCredentialListMapping.ts b/lib/rest/api/v2010/account/sip/domain/authTypes/authTypeRegistrations/authRegistrationsCredentialListMapping.ts index 585c3519b7..7d87ca974c 100644 --- a/lib/rest/api/v2010/account/sip/domain/authTypes/authTypeRegistrations/authRegistrationsCredentialListMapping.ts +++ b/lib/rest/api/v2010/account/sip/domain/authTypes/authTypeRegistrations/authRegistrationsCredentialListMapping.ts @@ -229,23 +229,23 @@ export class AuthRegistrationsCredentialListMappingInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the CredentialListMapping resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the CredentialListMapping resource. */ sid: string; diff --git a/lib/rest/api/v2010/account/sip/domain/credentialListMapping.ts b/lib/rest/api/v2010/account/sip/domain/credentialListMapping.ts index a0234ffa5b..134d9ef335 100644 --- a/lib/rest/api/v2010/account/sip/domain/credentialListMapping.ts +++ b/lib/rest/api/v2010/account/sip/domain/credentialListMapping.ts @@ -236,15 +236,15 @@ export class CredentialListMappingInstance { */ accountSid: string; /** - * The date that this resource was created, given as GMT in RFC 2822 format. + * The date that this resource was created, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateCreated: Date; /** - * The date that this resource was last updated, given as GMT in RFC 2822 format. + * The date that this resource was last updated, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateUpdated: Date; /** - * The unique string that identifies the SipDomain resource. + * The unique string that is created to identify the SipDomain resource. */ domainSid: string; /** @@ -256,7 +256,7 @@ export class CredentialListMappingInstance { */ sid: string; /** - * The URI for this resource, relative to https://api.twilio.com + * The URI for this resource, relative to `https://api.twilio.com` */ uri: string; diff --git a/lib/rest/api/v2010/account/sip/domain/ipAccessControlListMapping.ts b/lib/rest/api/v2010/account/sip/domain/ipAccessControlListMapping.ts index a951b5da4f..15f0e3281e 100644 --- a/lib/rest/api/v2010/account/sip/domain/ipAccessControlListMapping.ts +++ b/lib/rest/api/v2010/account/sip/domain/ipAccessControlListMapping.ts @@ -236,15 +236,15 @@ export class IpAccessControlListMappingInstance { */ accountSid: string; /** - * The date that this resource was created, given as GMT in RFC 2822 format. + * The date that this resource was created, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateCreated: Date; /** - * The date that this resource was last updated, given as GMT in RFC 2822 format. + * The date that this resource was last updated, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateUpdated: Date; /** - * The unique string that identifies the SipDomain resource. + * The unique string that is created to identify the SipDomain resource. */ domainSid: string; /** @@ -256,7 +256,7 @@ export class IpAccessControlListMappingInstance { */ sid: string; /** - * The URI for this resource, relative to https://api.twilio.com + * The URI for this resource, relative to `https://api.twilio.com` */ uri: string; diff --git a/lib/rest/api/v2010/account/sip/ipAccessControlList.ts b/lib/rest/api/v2010/account/sip/ipAccessControlList.ts index 1005c969e1..86dcbad7f6 100644 --- a/lib/rest/api/v2010/account/sip/ipAccessControlList.ts +++ b/lib/rest/api/v2010/account/sip/ipAccessControlList.ts @@ -299,31 +299,31 @@ export class IpAccessControlListInstance { } /** - * A string that uniquely identifies this resource + * A 34 character string that uniquely identifies this resource. */ sid: string; /** - * The unique sid that identifies this account + * The unique id of the [Account](https://www.twilio.com/docs/iam/api/account) that owns this resource. */ accountSid: string; /** - * A human readable description of this resource + * A human readable descriptive text, up to 255 characters long. */ friendlyName: string; /** - * The date this resource was created + * The date that this resource was created, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateCreated: Date; /** - * The date this resource was last updated + * The date that this resource was last updated, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateUpdated: Date; /** - * The IP addresses associated with this resource. + * A list of the IpAddress resources associated with this IP access control list resource. */ subresourceUris: Record; /** - * The URI for this resource + * The URI for this resource, relative to `https://api.twilio.com` */ uri: string; diff --git a/lib/rest/api/v2010/account/sip/ipAccessControlList/ipAddress.ts b/lib/rest/api/v2010/account/sip/ipAccessControlList/ipAddress.ts index a4eeb15864..f1bc272cfc 100644 --- a/lib/rest/api/v2010/account/sip/ipAccessControlList/ipAddress.ts +++ b/lib/rest/api/v2010/account/sip/ipAccessControlList/ipAddress.ts @@ -344,15 +344,15 @@ export class IpAddressInstance { */ ipAccessControlListSid: string; /** - * The date that this resource was created, given as GMT in RFC 2822 format. + * The date that this resource was created, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateCreated: Date; /** - * The date that this resource was last updated, given as GMT in RFC 2822 format. + * The date that this resource was last updated, given as GMT in [RFC 2822](https://www.php.net/manual/en/class.datetime.php#datetime.constants.rfc2822) format. */ dateUpdated: Date; /** - * The URI for this resource, relative to https://api.twilio.com + * The URI for this resource, relative to `https://api.twilio.com` */ uri: string; diff --git a/lib/rest/api/v2010/account/token.ts b/lib/rest/api/v2010/account/token.ts index 299011b648..70f0c9fd35 100644 --- a/lib/rest/api/v2010/account/token.ts +++ b/lib/rest/api/v2010/account/token.ts @@ -172,31 +172,31 @@ export class TokenInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Token resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * An array representing the ephemeral credentials + * An array representing the ephemeral credentials and the STUN and TURN server URIs. */ iceServers: Array; /** - * The temporary password used for authenticating + * The temporary password that the username will use when authenticating with Twilio. */ password: string; /** - * The duration in seconds the credentials are valid + * The duration in seconds for which the username and password are valid. */ ttl: string; /** - * The temporary username that uniquely identifies a Token + * The temporary username that uniquely identifies a Token. */ username: string; diff --git a/lib/rest/api/v2010/account/transcription.ts b/lib/rest/api/v2010/account/transcription.ts index 6d0c380dde..e0b1f27fa4 100644 --- a/lib/rest/api/v2010/account/transcription.ts +++ b/lib/rest/api/v2010/account/transcription.ts @@ -216,19 +216,19 @@ export class TranscriptionInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Transcription resource. */ accountSid: string; /** - * The API version used to create the transcription + * The API version used to create the transcription. */ apiVersion: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** @@ -236,19 +236,19 @@ export class TranscriptionInstance { */ duration: string; /** - * The charge for the transcription + * The charge for the transcript in the currency associated with the account. This value is populated after the transcript is complete so it may not be available immediately. */ price: number; /** - * The currency in which price is measured + * The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). */ priceUnit: string; /** - * The SID that identifies the transcription\'s recording + * The SID of the [Recording](https://www.twilio.com/docs/voice/api/recording) from which the transcription was created. */ recordingSid: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Transcription resource. */ sid: string; status: TranscriptionStatus; @@ -257,11 +257,11 @@ export class TranscriptionInstance { */ transcriptionText: string; /** - * The transcription type + * The transcription type. Can only be: `fast`. */ type: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; diff --git a/lib/rest/api/v2010/account/usage/record.ts b/lib/rest/api/v2010/account/usage/record.ts index 9fe8e2c901..35f4a6b1bf 100644 --- a/lib/rest/api/v2010/account/usage/record.ts +++ b/lib/rest/api/v2010/account/usage/record.ts @@ -674,60 +674,60 @@ export class RecordInstance { } /** - * The SID of the Account accrued the usage + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that accrued the usage. */ accountSid: string; /** - * The API version used to create the resource + * The API version used to create the resource. */ apiVersion: string; /** - * Usage records up to date as of this timestamp + * Usage records up to date as of this timestamp, formatted as YYYY-MM-DDTHH:MM:SS+00:00. All timestamps are in GMT */ asOf: string; category: UsageRecordCategory; /** - * The number of usage events + * The number of usage events, such as the number of calls. */ count: string; /** - * The units in which count is measured + * The units in which `count` is measured, such as `calls` for calls or `messages` for SMS. */ countUnit: string; /** - * A plain-language description of the usage category + * A plain-language description of the usage category. */ description: string; /** - * The last date for which usage is included in the UsageRecord + * The last date for which usage is included in the UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ endDate: Date; /** - * The total price of the usage + * The total price of the usage in the currency specified in `price_unit` and associated with the account. */ price: number; /** - * The currency in which `price` is measured + * The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format, such as `usd`, `eur`, and `jpy`. */ priceUnit: string; /** - * The first date for which usage is included in this UsageRecord + * The first date for which usage is included in this UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ startDate: Date; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their URIs. For more information, see [List Subresources](https://www.twilio.com/docs/usage/api/usage-record#list-subresources). */ subresourceUris: Record; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * The amount of usage + * The amount used to bill usage and measured in units described in `usage_unit`. */ usage: string; /** - * The units in which usage is measured + * The units in which `usage` is measured, such as `minutes` for calls or `messages` for SMS. */ usageUnit: string; diff --git a/lib/rest/api/v2010/account/usage/record/allTime.ts b/lib/rest/api/v2010/account/usage/record/allTime.ts index 7418018b7b..0d1a96320a 100644 --- a/lib/rest/api/v2010/account/usage/record/allTime.ts +++ b/lib/rest/api/v2010/account/usage/record/allTime.ts @@ -554,60 +554,60 @@ export class AllTimeInstance { } /** - * The SID of the Account accrued the usage + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that accrued the usage. */ accountSid: string; /** - * The API version used to create the resource + * The API version used to create the resource. */ apiVersion: string; /** - * Usage records up to date as of this timestamp + * Usage records up to date as of this timestamp, formatted as YYYY-MM-DDTHH:MM:SS+00:00. All timestamps are in GMT */ asOf: string; category: UsageRecordAllTimeCategory; /** - * The number of usage events + * The number of usage events, such as the number of calls. */ count: string; /** - * The units in which count is measured + * The units in which `count` is measured, such as `calls` for calls or `messages` for SMS. */ countUnit: string; /** - * A plain-language description of the usage category + * A plain-language description of the usage category. */ description: string; /** - * The last date for which usage is included in the UsageRecord + * The last date for which usage is included in the UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ endDate: Date; /** - * The total price of the usage + * The total price of the usage in the currency specified in `price_unit` and associated with the account. */ price: number; /** - * The currency in which `price` is measured + * The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format, such as `usd`, `eur`, and `jpy`. */ priceUnit: string; /** - * The first date for which usage is included in this UsageRecord + * The first date for which usage is included in this UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ startDate: Date; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their URIs. For more information, see [List Subresources](https://www.twilio.com/docs/usage/api/usage-record#list-subresources). */ subresourceUris: Record; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * The amount of usage + * The amount used to bill usage and measured in units described in `usage_unit`. */ usage: string; /** - * The units in which usage is measured + * The units in which `usage` is measured, such as `minutes` for calls or `messages` for SMS. */ usageUnit: string; diff --git a/lib/rest/api/v2010/account/usage/record/daily.ts b/lib/rest/api/v2010/account/usage/record/daily.ts index cff9bb0541..02b6abd0d6 100644 --- a/lib/rest/api/v2010/account/usage/record/daily.ts +++ b/lib/rest/api/v2010/account/usage/record/daily.ts @@ -552,60 +552,60 @@ export class DailyInstance { } /** - * The SID of the Account accrued the usage + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that accrued the usage. */ accountSid: string; /** - * The API version used to create the resource + * The API version used to create the resource. */ apiVersion: string; /** - * Usage records up to date as of this timestamp + * Usage records up to date as of this timestamp, formatted as YYYY-MM-DDTHH:MM:SS+00:00. All timestamps are in GMT */ asOf: string; category: UsageRecordDailyCategory; /** - * The number of usage events + * The number of usage events, such as the number of calls. */ count: string; /** - * The units in which count is measured + * The units in which `count` is measured, such as `calls` for calls or `messages` for SMS. */ countUnit: string; /** - * A plain-language description of the usage category + * A plain-language description of the usage category. */ description: string; /** - * The last date for which usage is included in the UsageRecord + * The last date for which usage is included in the UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ endDate: Date; /** - * The total price of the usage + * The total price of the usage in the currency specified in `price_unit` and associated with the account. */ price: number; /** - * The currency in which `price` is measured + * The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format, such as `usd`, `eur`, and `jpy`. */ priceUnit: string; /** - * The first date for which usage is included in this UsageRecord + * The first date for which usage is included in this UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ startDate: Date; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their URIs. For more information, see [List Subresources](https://www.twilio.com/docs/usage/api/usage-record#list-subresources). */ subresourceUris: Record; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * The amount of usage + * The amount used to bill usage and measured in units described in `usage_unit`. */ usage: string; /** - * The units in which usage is measured + * The units in which `usage` is measured, such as `minutes` for calls or `messages` for SMS. */ usageUnit: string; diff --git a/lib/rest/api/v2010/account/usage/record/lastMonth.ts b/lib/rest/api/v2010/account/usage/record/lastMonth.ts index 99def1ae25..f0b44b6336 100644 --- a/lib/rest/api/v2010/account/usage/record/lastMonth.ts +++ b/lib/rest/api/v2010/account/usage/record/lastMonth.ts @@ -554,60 +554,60 @@ export class LastMonthInstance { } /** - * The SID of the Account accrued the usage + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that accrued the usage. */ accountSid: string; /** - * The API version used to create the resource + * The API version used to create the resource. */ apiVersion: string; /** - * Usage records up to date as of this timestamp + * Usage records up to date as of this timestamp, formatted as YYYY-MM-DDTHH:MM:SS+00:00. All timestamps are in GMT */ asOf: string; category: UsageRecordLastMonthCategory; /** - * The number of usage events + * The number of usage events, such as the number of calls. */ count: string; /** - * The units in which count is measured + * The units in which `count` is measured, such as `calls` for calls or `messages` for SMS. */ countUnit: string; /** - * A plain-language description of the usage category + * A plain-language description of the usage category. */ description: string; /** - * The last date for which usage is included in the UsageRecord + * The last date for which usage is included in the UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ endDate: Date; /** - * The total price of the usage + * The total price of the usage in the currency specified in `price_unit` and associated with the account. */ price: number; /** - * The currency in which `price` is measured + * The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format, such as `usd`, `eur`, and `jpy`. */ priceUnit: string; /** - * The first date for which usage is included in this UsageRecord + * The first date for which usage is included in this UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ startDate: Date; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their URIs. For more information, see [List Subresources](https://www.twilio.com/docs/usage/api/usage-record#list-subresources). */ subresourceUris: Record; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * The amount of usage + * The amount used to bill usage and measured in units described in `usage_unit`. */ usage: string; /** - * The units in which usage is measured + * The units in which `usage` is measured, such as `minutes` for calls or `messages` for SMS. */ usageUnit: string; diff --git a/lib/rest/api/v2010/account/usage/record/monthly.ts b/lib/rest/api/v2010/account/usage/record/monthly.ts index b7a6a99455..3c4727639c 100644 --- a/lib/rest/api/v2010/account/usage/record/monthly.ts +++ b/lib/rest/api/v2010/account/usage/record/monthly.ts @@ -554,60 +554,60 @@ export class MonthlyInstance { } /** - * The SID of the Account accrued the usage + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that accrued the usage. */ accountSid: string; /** - * The API version used to create the resource + * The API version used to create the resource. */ apiVersion: string; /** - * Usage records up to date as of this timestamp + * Usage records up to date as of this timestamp, formatted as YYYY-MM-DDTHH:MM:SS+00:00. All timestamps are in GMT */ asOf: string; category: UsageRecordMonthlyCategory; /** - * The number of usage events + * The number of usage events, such as the number of calls. */ count: string; /** - * The units in which count is measured + * The units in which `count` is measured, such as `calls` for calls or `messages` for SMS. */ countUnit: string; /** - * A plain-language description of the usage category + * A plain-language description of the usage category. */ description: string; /** - * The last date for which usage is included in the UsageRecord + * The last date for which usage is included in the UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ endDate: Date; /** - * The total price of the usage + * The total price of the usage in the currency specified in `price_unit` and associated with the account. */ price: number; /** - * The currency in which `price` is measured + * The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format, such as `usd`, `eur`, and `jpy`. */ priceUnit: string; /** - * The first date for which usage is included in this UsageRecord + * The first date for which usage is included in this UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ startDate: Date; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their URIs. For more information, see [List Subresources](https://www.twilio.com/docs/usage/api/usage-record#list-subresources). */ subresourceUris: Record; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * The amount of usage + * The amount used to bill usage and measured in units described in `usage_unit`. */ usage: string; /** - * The units in which usage is measured + * The units in which `usage` is measured, such as `minutes` for calls or `messages` for SMS. */ usageUnit: string; diff --git a/lib/rest/api/v2010/account/usage/record/thisMonth.ts b/lib/rest/api/v2010/account/usage/record/thisMonth.ts index 7dc36022c6..e3b09675ff 100644 --- a/lib/rest/api/v2010/account/usage/record/thisMonth.ts +++ b/lib/rest/api/v2010/account/usage/record/thisMonth.ts @@ -554,60 +554,60 @@ export class ThisMonthInstance { } /** - * The SID of the Account accrued the usage + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that accrued the usage. */ accountSid: string; /** - * The API version used to create the resource + * The API version used to create the resource. */ apiVersion: string; /** - * Usage records up to date as of this timestamp + * Usage records up to date as of this timestamp, formatted as YYYY-MM-DDTHH:MM:SS+00:00. All timestamps are in GMT */ asOf: string; category: UsageRecordThisMonthCategory; /** - * The number of usage events + * The number of usage events, such as the number of calls. */ count: string; /** - * The units in which count is measured + * The units in which `count` is measured, such as `calls` for calls or `messages` for SMS. */ countUnit: string; /** - * A plain-language description of the usage category + * A plain-language description of the usage category. */ description: string; /** - * The last date for which usage is included in the UsageRecord + * The last date for which usage is included in the UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ endDate: Date; /** - * The total price of the usage + * The total price of the usage in the currency specified in `price_unit` and associated with the account. */ price: number; /** - * The currency in which `price` is measured + * The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format, such as `usd`, `eur`, and `jpy`. */ priceUnit: string; /** - * The first date for which usage is included in this UsageRecord + * The first date for which usage is included in this UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ startDate: Date; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their URIs. For more information, see [List Subresources](https://www.twilio.com/docs/usage/api/usage-record#list-subresources). */ subresourceUris: Record; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * The amount of usage + * The amount used to bill usage and measured in units described in `usage_unit`. */ usage: string; /** - * The units in which usage is measured + * The units in which `usage` is measured, such as `minutes` for calls or `messages` for SMS. */ usageUnit: string; diff --git a/lib/rest/api/v2010/account/usage/record/today.ts b/lib/rest/api/v2010/account/usage/record/today.ts index 93e43aea6f..2b5d7e80fa 100644 --- a/lib/rest/api/v2010/account/usage/record/today.ts +++ b/lib/rest/api/v2010/account/usage/record/today.ts @@ -552,60 +552,60 @@ export class TodayInstance { } /** - * The SID of the Account accrued the usage + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that accrued the usage. */ accountSid: string; /** - * The API version used to create the resource + * The API version used to create the resource. */ apiVersion: string; /** - * Usage records up to date as of this timestamp + * Usage records up to date as of this timestamp, formatted as YYYY-MM-DDTHH:MM:SS+00:00. All timestamps are in GMT */ asOf: string; category: UsageRecordTodayCategory; /** - * The number of usage events + * The number of usage events, such as the number of calls. */ count: string; /** - * The units in which count is measured + * The units in which `count` is measured, such as `calls` for calls or `messages` for SMS. */ countUnit: string; /** - * A plain-language description of the usage category + * A plain-language description of the usage category. */ description: string; /** - * The last date for which usage is included in the UsageRecord + * The last date for which usage is included in the UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ endDate: Date; /** - * The total price of the usage + * The total price of the usage in the currency specified in `price_unit` and associated with the account. */ price: number; /** - * The currency in which `price` is measured + * The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format, such as `usd`, `eur`, and `jpy`. */ priceUnit: string; /** - * The first date for which usage is included in this UsageRecord + * The first date for which usage is included in this UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ startDate: Date; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their URIs. For more information, see [List Subresources](https://www.twilio.com/docs/usage/api/usage-record#list-subresources). */ subresourceUris: Record; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * The amount of usage + * The amount used to bill usage and measured in units described in `usage_unit`. */ usage: string; /** - * The units in which usage is measured + * The units in which `usage` is measured, such as `minutes` for calls or `messages` for SMS. */ usageUnit: string; diff --git a/lib/rest/api/v2010/account/usage/record/yearly.ts b/lib/rest/api/v2010/account/usage/record/yearly.ts index ffb478e055..5c0c788b62 100644 --- a/lib/rest/api/v2010/account/usage/record/yearly.ts +++ b/lib/rest/api/v2010/account/usage/record/yearly.ts @@ -553,60 +553,60 @@ export class YearlyInstance { } /** - * The SID of the Account accrued the usage + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that accrued the usage. */ accountSid: string; /** - * The API version used to create the resource + * The API version used to create the resource. */ apiVersion: string; /** - * Usage records up to date as of this timestamp + * Usage records up to date as of this timestamp, formatted as YYYY-MM-DDTHH:MM:SS+00:00. All timestamps are in GMT */ asOf: string; category: UsageRecordYearlyCategory; /** - * The number of usage events + * The number of usage events, such as the number of calls. */ count: string; /** - * The units in which count is measured + * The units in which `count` is measured, such as `calls` for calls or `messages` for SMS. */ countUnit: string; /** - * A plain-language description of the usage category + * A plain-language description of the usage category. */ description: string; /** - * The last date for which usage is included in the UsageRecord + * The last date for which usage is included in the UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ endDate: Date; /** - * The total price of the usage + * The total price of the usage in the currency specified in `price_unit` and associated with the account. */ price: number; /** - * The currency in which `price` is measured + * The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format, such as `usd`, `eur`, and `jpy`. */ priceUnit: string; /** - * The first date for which usage is included in this UsageRecord + * The first date for which usage is included in this UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ startDate: Date; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their URIs. For more information, see [List Subresources](https://www.twilio.com/docs/usage/api/usage-record#list-subresources). */ subresourceUris: Record; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * The amount of usage + * The amount used to bill usage and measured in units described in `usage_unit`. */ usage: string; /** - * The units in which usage is measured + * The units in which `usage` is measured, such as `minutes` for calls or `messages` for SMS. */ usageUnit: string; diff --git a/lib/rest/api/v2010/account/usage/record/yesterday.ts b/lib/rest/api/v2010/account/usage/record/yesterday.ts index 70a530b09d..b455fdfee8 100644 --- a/lib/rest/api/v2010/account/usage/record/yesterday.ts +++ b/lib/rest/api/v2010/account/usage/record/yesterday.ts @@ -554,60 +554,60 @@ export class YesterdayInstance { } /** - * The SID of the Account accrued the usage + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that accrued the usage. */ accountSid: string; /** - * The API version used to create the resource + * The API version used to create the resource. */ apiVersion: string; /** - * Usage records up to date as of this timestamp + * Usage records up to date as of this timestamp, formatted as YYYY-MM-DDTHH:MM:SS+00:00. All timestamps are in GMT */ asOf: string; category: UsageRecordYesterdayCategory; /** - * The number of usage events + * The number of usage events, such as the number of calls. */ count: string; /** - * The units in which count is measured + * The units in which `count` is measured, such as `calls` for calls or `messages` for SMS. */ countUnit: string; /** - * A plain-language description of the usage category + * A plain-language description of the usage category. */ description: string; /** - * The last date for which usage is included in the UsageRecord + * The last date for which usage is included in the UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ endDate: Date; /** - * The total price of the usage + * The total price of the usage in the currency specified in `price_unit` and associated with the account. */ price: number; /** - * The currency in which `price` is measured + * The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format, such as `usd`, `eur`, and `jpy`. */ priceUnit: string; /** - * The first date for which usage is included in this UsageRecord + * The first date for which usage is included in this UsageRecord. The date is specified in GMT and formatted as `YYYY-MM-DD`. */ startDate: Date; /** - * A list of related resources identified by their relative URIs + * A list of related resources identified by their URIs. For more information, see [List Subresources](https://www.twilio.com/docs/usage/api/usage-record#list-subresources). */ subresourceUris: Record; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; /** - * The amount of usage + * The amount used to bill usage and measured in units described in `usage_unit`. */ usage: string; /** - * The units in which usage is measured + * The units in which `usage` is measured, such as `minutes` for calls or `messages` for SMS. */ usageUnit: string; diff --git a/lib/rest/api/v2010/account/usage/trigger.ts b/lib/rest/api/v2010/account/usage/trigger.ts index 91125e67c9..cfd9a18555 100644 --- a/lib/rest/api/v2010/account/usage/trigger.ts +++ b/lib/rest/api/v2010/account/usage/trigger.ts @@ -602,58 +602,58 @@ export class TriggerInstance { } /** - * The SID of the Account that this trigger monitors + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that the trigger monitors. */ accountSid: string; /** - * The API version used to create the resource + * The API version used to create the resource. */ apiVersion: string; /** - * The HTTP method we use to call callback_url + * The HTTP method we use to call `callback_url`. Can be: `GET` or `POST`. */ callbackMethod: TriggerCallbackMethod; /** - * he URL we call when the trigger fires + * The URL we call using the `callback_method` when the trigger fires. */ callbackUrl: string; /** - * The current value of the field the trigger is watching + * The current value of the field the trigger is watching. */ currentValue: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the trigger was last fired + * The date and time in GMT that the trigger was last fired specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateFired: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the trigger + * The string that you assigned to describe the trigger. */ friendlyName: string; recurring: UsageTriggerRecurring; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the UsageTrigger resource. */ sid: string; triggerBy: UsageTriggerTriggerField; /** - * The value at which the trigger will fire + * The value at which the trigger will fire. Must be a positive, numeric value. */ triggerValue: string; /** - * The URI of the resource, relative to `https://api.twilio.com` + * The URI of the resource, relative to `https://api.twilio.com`. */ uri: string; usageCategory: UsageTriggerUsageCategory; /** - * The URI of the UsageRecord resource this trigger watches + * The URI of the [UsageRecord](https://www.twilio.com/docs/usage/api/usage-record) resource this trigger watches, relative to `https://api.twilio.com`. */ usageRecordUri: string; diff --git a/lib/rest/api/v2010/account/validationRequest.ts b/lib/rest/api/v2010/account/validationRequest.ts index 2e1efa4165..ee20c48db3 100644 --- a/lib/rest/api/v2010/account/validationRequest.ts +++ b/lib/rest/api/v2010/account/validationRequest.ts @@ -170,23 +170,23 @@ export class ValidationRequestInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for the Caller ID. */ accountSid: string; /** - * The SID of the Call the resource is associated with + * The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Caller ID is associated with. */ callSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The phone number to verify in E.164 format + * The phone number to verify in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The 6 digit validation code that someone must enter to validate the Caller ID when `phone_number` is called + * The 6 digit validation code that someone must enter to validate the Caller ID when `phone_number` is called. */ validationCode: string; diff --git a/lib/rest/autopilot/v1/assistant.ts b/lib/rest/autopilot/v1/assistant.ts index 2c690fa138..516ea6472f 100644 --- a/lib/rest/autopilot/v1/assistant.ts +++ b/lib/rest/autopilot/v1/assistant.ts @@ -403,31 +403,31 @@ export class AssistantInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Assistant resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. It is not unique and can be up to 255 characters long. */ friendlyName: string; /** - * Reserved + * Reserved. */ latestModelBuildSid: string; /** - * A list of the URLs of the Assistant\'s related resources + * A list of the URLs of the Assistant\'s related resources. */ links: Record; /** - * Whether queries should be logged and kept after training + * Whether queries should be logged and kept after training. Can be: `true` or `false` and defaults to `true`. If `true`, queries are stored for 30 days, and then deleted. If `false`, no queries are stored. */ logQueries: boolean; /** @@ -435,27 +435,27 @@ export class AssistantInstance { */ developmentStage: string; /** - * Whether model needs to be rebuilt + * Whether model needs to be rebuilt. */ needsModelBuild: boolean; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Assistant resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. It can be up to 64 characters long. */ uniqueName: string; /** - * The absolute URL of the Assistant resource + * The absolute URL of the Assistant resource. */ url: string; /** - * Reserved + * Reserved. */ callbackUrl: string; /** - * Reserved + * Reserved. */ callbackEvents: string; diff --git a/lib/rest/autopilot/v1/assistant/defaults.ts b/lib/rest/autopilot/v1/assistant/defaults.ts index b660eb6cce..b234dcaeba 100644 --- a/lib/rest/autopilot/v1/assistant/defaults.ts +++ b/lib/rest/autopilot/v1/assistant/defaults.ts @@ -198,19 +198,19 @@ export class DefaultsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Defaults resource. */ accountSid: string; /** - * The SID of the Assistant that is the parent of the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the resource. */ assistantSid: string; /** - * The absolute URL of the Defaults resource + * The absolute URL of the Defaults resource. */ url: string; /** - * The JSON string that describes the default task links + * The JSON string that describes the default task links for the `assistant_initiation`, `collect`, and `fallback` situations. */ data: any; diff --git a/lib/rest/autopilot/v1/assistant/dialogue.ts b/lib/rest/autopilot/v1/assistant/dialogue.ts index 9b4578e82b..484d5c592a 100644 --- a/lib/rest/autopilot/v1/assistant/dialogue.ts +++ b/lib/rest/autopilot/v1/assistant/dialogue.ts @@ -130,23 +130,23 @@ export class DialogueInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Dialogue resource. */ accountSid: string; /** - * The SID of the Assistant that is the parent of the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the resource. */ assistantSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Dialogue resource. */ sid: string; /** - * The JSON string that describes the dialogue session object + * The JSON string that describes the dialogue session object. */ data: any; /** - * The absolute URL of the Dialogue resource + * The absolute URL of the Dialogue resource. */ url: string; diff --git a/lib/rest/autopilot/v1/assistant/fieldType.ts b/lib/rest/autopilot/v1/assistant/fieldType.ts index e46f3fe472..567db552e3 100644 --- a/lib/rest/autopilot/v1/assistant/fieldType.ts +++ b/lib/rest/autopilot/v1/assistant/fieldType.ts @@ -313,39 +313,39 @@ export class FieldTypeInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the FieldType resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. It is not unique and can be up to 255 characters long. */ friendlyName: string; /** - * A list of the URLs of related resources + * A list of the URLs of related resources. */ links: Record; /** - * The SID of the Assistant that is the parent of the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the resource. */ assistantSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the FieldType resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The absolute URL of the FieldType resource + * The absolute URL of the FieldType resource. */ url: string; diff --git a/lib/rest/autopilot/v1/assistant/fieldType/fieldValue.ts b/lib/rest/autopilot/v1/assistant/fieldType/fieldValue.ts index 4396660e41..00c0aec730 100644 --- a/lib/rest/autopilot/v1/assistant/fieldType/fieldValue.ts +++ b/lib/rest/autopilot/v1/assistant/fieldType/fieldValue.ts @@ -237,43 +237,43 @@ export class FieldValueInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the FieldValue resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The SID of the Field Type associated with the Field Value + * The SID of the Field Type associated with the Field Value. */ fieldTypeSid: string; /** - * The ISO language-country tag that identifies the language of the value + * The [ISO language-country](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) tag that specifies the language of the value. Currently supported tags: `en-US` */ language: string; /** - * The SID of the Assistant that is the parent of the FieldType associated with the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the FieldType associated with the resource. */ assistantSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the FieldValue resource. */ sid: string; /** - * The Field Value data + * The Field Value data. */ value: string; /** - * The absolute URL of the FieldValue resource + * The absolute URL of the FieldValue resource. */ url: string; /** - * The word for which the field value is a synonym of + * The word for which the field value is a synonym of. */ synonymOf: string; diff --git a/lib/rest/autopilot/v1/assistant/modelBuild.ts b/lib/rest/autopilot/v1/assistant/modelBuild.ts index e8680c1e9e..fcda1fe349 100644 --- a/lib/rest/autopilot/v1/assistant/modelBuild.ts +++ b/lib/rest/autopilot/v1/assistant/modelBuild.ts @@ -302,40 +302,40 @@ export class ModelBuildInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the ModelBuild resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The SID of the Assistant that is the parent of the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the resource. */ assistantSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the ModelBuild resource. */ sid: string; status: ModelBuildStatus; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used as an alternative to the `sid` in the URL path to address the resource. */ uniqueName: string; /** - * The absolute URL of the ModelBuild resource + * The absolute URL of the ModelBuild resource. */ url: string; /** - * The time in seconds it took to build the model + * The time in seconds it took to build the model. */ buildDuration: number; /** - * More information about why the model build failed, if `status` is `failed` + * If the `status` for the model build is `failed`, this value is a code to more information about the failure. This value will be null for all other statuses. See [error code dictionary](https://www.twilio.com/docs/api/errors) for a description of the error. */ errorCode: number; diff --git a/lib/rest/autopilot/v1/assistant/query.ts b/lib/rest/autopilot/v1/assistant/query.ts index 0bb8d58c8c..b124853f6a 100644 --- a/lib/rest/autopilot/v1/assistant/query.ts +++ b/lib/rest/autopilot/v1/assistant/query.ts @@ -334,55 +334,55 @@ export class QueryInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Query resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The natural language analysis results that include the Task recognized and a list of identified Fields + * The natural language analysis results that include the [Task](https://www.twilio.com/docs/autopilot/api/task) recognized and a list of identified [Fields](https://www.twilio.com/docs/autopilot/api/task-field). */ results: any; /** - * The ISO language-country string that specifies the language used by the Query + * The [ISO language-country](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) string that specifies the language used by the Query. For example: `en-US`. */ language: string; /** - * The SID of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) queried + * The SID of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) queried. */ modelBuildSid: string; /** - * The end-user\'s natural language input + * The end-user\'s natural language input. */ query: string; /** - * The SID of an optional reference to the Sample created from the query + * The SID of an optional reference to the [Sample](https://www.twilio.com/docs/autopilot/api/task-sample) created from the query. */ sampleSid: string; /** - * The SID of the Assistant that is the parent of the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the resource. */ assistantSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Query resource. */ sid: string; /** - * The status of the Query + * The status of the Query. Can be: `pending-review`, `reviewed`, or `discarded` */ status: string; /** - * The absolute URL of the Query resource + * The absolute URL of the Query resource. */ url: string; /** - * The communication channel from where the end-user input came + * The communication channel from where the end-user input came. */ sourceChannel: string; /** diff --git a/lib/rest/autopilot/v1/assistant/styleSheet.ts b/lib/rest/autopilot/v1/assistant/styleSheet.ts index 8f11b69989..b6da0cbed7 100644 --- a/lib/rest/autopilot/v1/assistant/styleSheet.ts +++ b/lib/rest/autopilot/v1/assistant/styleSheet.ts @@ -198,19 +198,19 @@ export class StyleSheetInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the StyleSheet resource. */ accountSid: string; /** - * The SID of the Assistant that is the parent of the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the resource. */ assistantSid: string; /** - * The absolute URL of the StyleSheet resource + * The absolute URL of the StyleSheet resource. */ url: string; /** - * The JSON string that describes the style sheet object + * The JSON string that describes the style sheet object. */ data: any; diff --git a/lib/rest/autopilot/v1/assistant/task.ts b/lib/rest/autopilot/v1/assistant/task.ts index e5f0f99fc0..48858c661d 100644 --- a/lib/rest/autopilot/v1/assistant/task.ts +++ b/lib/rest/autopilot/v1/assistant/task.ts @@ -369,43 +369,43 @@ export class TaskInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Task resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. It is not unique and can be up to 255 characters long. */ friendlyName: string; /** - * A list of the URLs of related resources + * A list of the URLs of related resources. */ links: Record; /** - * The SID of the Assistant that is the parent of the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the resource. */ assistantSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Task resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The URL from which the Assistant can fetch actions + * The URL from which the Assistant can fetch actions. */ actionsUrl: string; /** - * The absolute URL of the Task resource + * The absolute URL of the Task resource. */ url: string; diff --git a/lib/rest/autopilot/v1/assistant/task/field.ts b/lib/rest/autopilot/v1/assistant/task/field.ts index 5b7ce0133a..c46a280a40 100644 --- a/lib/rest/autopilot/v1/assistant/task/field.ts +++ b/lib/rest/autopilot/v1/assistant/task/field.ts @@ -227,39 +227,39 @@ export class FieldInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Field resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The Field Type of the field + * The Field Type of the field. Can be: a [Built-in Field Type](https://www.twilio.com/docs/autopilot/built-in-field-types), the unique_name, or the SID of a custom Field Type. */ fieldType: string; /** - * The SID of the [Task](https://www.twilio.com/docs/autopilot/api/task) resource associated with this Field + * The SID of the [Task](https://www.twilio.com/docs/autopilot/api/task) resource associated with this Field. */ taskSid: string; /** - * The SID of the Assistant that is the parent of the Task associated with the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the Task associated with the resource. */ assistantSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Field resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The absolute URL of the Field resource + * The absolute URL of the Field resource. */ url: string; diff --git a/lib/rest/autopilot/v1/assistant/task/sample.ts b/lib/rest/autopilot/v1/assistant/task/sample.ts index 23494a6c3c..7770b05881 100644 --- a/lib/rest/autopilot/v1/assistant/task/sample.ts +++ b/lib/rest/autopilot/v1/assistant/task/sample.ts @@ -323,43 +323,43 @@ export class SampleInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Sample resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The SID of the Task associated with the resource + * The SID of the [Task](https://www.twilio.com/docs/autopilot/api/task) associated with the resource. */ taskSid: string; /** - * An ISO language-country string that specifies the language used for the sample + * The [ISO language-country](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) string that specifies the language used for the sample. For example: `en-US`. */ language: string; /** - * The SID of the Assistant that is the parent of the Task associated with the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the Task associated with the resource. */ assistantSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Sample resource. */ sid: string; /** - * The text example of how end users might express the task + * The text example of how end users might express the task. The sample can contain [Field tag blocks](https://www.twilio.com/docs/autopilot/api/task-sample#field-tagging). */ taggedText: string; /** - * The absolute URL of the Sample resource + * The absolute URL of the Sample resource. */ url: string; /** - * The communication channel from which the sample was captured + * The communication channel from which the sample was captured. Can be: `voice`, `sms`, `chat`, `alexa`, `google-assistant`, `slack`, or null if not included. */ sourceChannel: string; diff --git a/lib/rest/autopilot/v1/assistant/task/taskActions.ts b/lib/rest/autopilot/v1/assistant/task/taskActions.ts index 47b3549f35..ace8cb3aeb 100644 --- a/lib/rest/autopilot/v1/assistant/task/taskActions.ts +++ b/lib/rest/autopilot/v1/assistant/task/taskActions.ts @@ -208,23 +208,23 @@ export class TaskActionsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the TaskActions resource. */ accountSid: string; /** - * The SID of the Assistant that is the parent of the Task associated with the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the Task associated with the resource. */ assistantSid: string; /** - * The SID of the Task associated with the resource + * The SID of the [Task](https://www.twilio.com/docs/autopilot/api/task) associated with the resource. */ taskSid: string; /** - * The absolute URL of the TaskActions resource + * The absolute URL of the TaskActions resource. */ url: string; /** - * The JSON string that specifies the actions that instruct the Assistant on how to perform the task + * The JSON string that specifies the [actions](https://www.twilio.com/docs/autopilot/actions) that instruct the Assistant on how to perform the task. */ data: any; diff --git a/lib/rest/autopilot/v1/assistant/task/taskStatistics.ts b/lib/rest/autopilot/v1/assistant/task/taskStatistics.ts index 15650d360b..7916aad6e2 100644 --- a/lib/rest/autopilot/v1/assistant/task/taskStatistics.ts +++ b/lib/rest/autopilot/v1/assistant/task/taskStatistics.ts @@ -132,27 +132,27 @@ export class TaskStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the TaskStatistics resource. */ accountSid: string; /** - * The SID of the Assistant that is the parent of the Task associated with the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the Task associated with the resource. */ assistantSid: string; /** - * The SID of the Task for which the statistics were collected + * The SID of the [Task](https://www.twilio.com/docs/autopilot/api/task) for which the statistics were collected. */ taskSid: string; /** - * The total number of Samples associated with the Task + * The total number of [Samples](https://www.twilio.com/docs/autopilot/api/task-sample) associated with the Task. */ samplesCount: number; /** - * The total number of Fields associated with the Task + * The total number of [Fields](https://www.twilio.com/docs/autopilot/api/task-field) associated with the Task. */ fieldsCount: number; /** - * The absolute URL of the TaskStatistics resource + * The absolute URL of the TaskStatistics resource. */ url: string; diff --git a/lib/rest/autopilot/v1/assistant/webhook.ts b/lib/rest/autopilot/v1/assistant/webhook.ts index b44ee5d6e1..5666c2df29 100644 --- a/lib/rest/autopilot/v1/assistant/webhook.ts +++ b/lib/rest/autopilot/v1/assistant/webhook.ts @@ -310,31 +310,31 @@ export class WebhookInstance { } /** - * The absolute URL of the Webhook resource + * The absolute URL of the Webhook resource. */ url: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Webhook resource. */ accountSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The SID of the Assistant that is the parent of the resource + * The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the resource. */ assistantSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Webhook resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** diff --git a/lib/rest/autopilot/v1/restoreAssistant.ts b/lib/rest/autopilot/v1/restoreAssistant.ts index 45a8ee8ec6..ddd75b6802 100644 --- a/lib/rest/autopilot/v1/restoreAssistant.ts +++ b/lib/rest/autopilot/v1/restoreAssistant.ts @@ -148,39 +148,39 @@ export class RestoreAssistantInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Assistant resource. */ accountSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Assistant resource. */ sid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. It is not unique and can be up to 255 characters long. */ friendlyName: string; /** - * Whether model needs to be rebuilt + * Whether model needs to be rebuilt. */ needsModelBuild: boolean; /** - * Reserved + * Reserved. */ latestModelBuildSid: string; /** - * Whether queries should be logged and kept after training + * Whether queries should be logged and kept after training. Can be: `true` or `false` and defaults to `true`. If `true`, queries are stored for 30 days, and then deleted. If `false`, no queries are stored. */ logQueries: boolean; /** @@ -188,11 +188,11 @@ export class RestoreAssistantInstance { */ developmentStage: string; /** - * Reserved + * Reserved. */ callbackUrl: string; /** - * Reserved + * Reserved. */ callbackEvents: string; diff --git a/lib/rest/bulkexports/v1/export.ts b/lib/rest/bulkexports/v1/export.ts index 90bac47d5d..a34eaaaa50 100644 --- a/lib/rest/bulkexports/v1/export.ts +++ b/lib/rest/bulkexports/v1/export.ts @@ -149,7 +149,7 @@ export class ExportInstance { */ url: string; /** - * Nested resource URLs. + * Contains a dictionary of URL links to nested resources of this Export. */ links: Record; diff --git a/lib/rest/bulkexports/v1/export/day.ts b/lib/rest/bulkexports/v1/export/day.ts index 6bc0e38c2f..e7850cea66 100644 --- a/lib/rest/bulkexports/v1/export/day.ts +++ b/lib/rest/bulkexports/v1/export/day.ts @@ -173,15 +173,15 @@ export class DayInstance { redirectTo: string; /** - * The date of the data in the file + * The ISO 8601 format date of the resources in the file, for a UTC day */ day: string; /** - * Size of the file in bytes + * The size of the day\'s data file in bytes */ size: number; /** - * The date when resource is created + * The ISO 8601 format date when resources is created */ createDate: string; /** diff --git a/lib/rest/bulkexports/v1/export/exportCustomJob.ts b/lib/rest/bulkexports/v1/export/exportCustomJob.ts index a586bdc3a5..a5eff26fff 100644 --- a/lib/rest/bulkexports/v1/export/exportCustomJob.ts +++ b/lib/rest/bulkexports/v1/export/exportCustomJob.ts @@ -378,19 +378,19 @@ export class ExportCustomJobInstance { */ resourceType: string; /** - * The start day for the custom export specified as a string in the format of yyyy-MM-dd + * The start day for the custom export specified when creating the job */ startDay: string; /** - * The end day for the custom export specified as a string in the format of yyyy-MM-dd. This will be the last day exported. For instance, to export a single day, choose the same day for start and end day. To export the first 4 days of July, you would set the start date to 2020-07-01 and the end date to 2020-07-04. The end date must be the UTC day before yesterday. + * The end day for the export specified when creating the job */ endDay: string; /** - * The optional webhook url called on completion + * The optional webhook url called on completion of the job. If this is supplied, `WebhookMethod` must also be supplied. */ webhookUrl: string; /** - * This is the method used to call the webhook + * This is the method used to call the webhook on completion of the job. If this is supplied, `WebhookUrl` must also be supplied. */ webhookMethod: string; /** @@ -398,11 +398,11 @@ export class ExportCustomJobInstance { */ email: string; /** - * The unique job_sid returned when the custom export was created. This can be used to look up the status of the job. + * The unique job_sid returned when the custom export was created */ jobSid: string; /** - * The details of a job state which is an object that contains a `status` string, a day count integer, and list of days in the job + * The details of a job which is an object that contains an array of status grouped by `status` state. Each `status` object has a `status` string, a count which is the number of days in that `status`, and list of days in that `status`. The day strings are in the format yyyy-MM-dd. As an example, a currently running job may have a status object for COMPLETED and a `status` object for SUBMITTED each with its own count and list of days. */ details: any; /** diff --git a/lib/rest/bulkexports/v1/export/job.ts b/lib/rest/bulkexports/v1/export/job.ts index 1d5e1a0076..247b41d2c7 100644 --- a/lib/rest/bulkexports/v1/export/job.ts +++ b/lib/rest/bulkexports/v1/export/job.ts @@ -165,7 +165,7 @@ export class JobInstance { */ friendlyName: string; /** - * The details of a job state which is an object that contains a `status` string, a day count integer, and list of days in the job + * The details of a job which is an object that contains an array of status grouped by `status` state. Each `status` object has a `status` string, a count which is the number of days in that `status`, and list of days in that `status`. The day strings are in the format yyyy-MM-dd. As an example, a currently running job may have a status object for COMPLETED and a `status` object for SUBMITTED each with its own count and list of days. */ details: any; /** diff --git a/lib/rest/bulkexports/v1/exportConfiguration.ts b/lib/rest/bulkexports/v1/exportConfiguration.ts index 4716bd81f0..d4c3c8622d 100644 --- a/lib/rest/bulkexports/v1/exportConfiguration.ts +++ b/lib/rest/bulkexports/v1/exportConfiguration.ts @@ -210,15 +210,15 @@ export class ExportConfigurationInstance { } /** - * Whether files are automatically generated + * If true, Twilio will automatically generate every day\'s file when the day is over. */ enabled: boolean; /** - * URL targeted at export + * Stores the URL destination for the method specified in webhook_method. */ webhookUrl: string; /** - * Whether to GET or POST to the webhook url + * Sets whether Twilio should call a webhook URL when the automatic generation is complete, using GET or POST. The actual destination is set in the webhook_url */ webhookMethod: string; /** diff --git a/lib/rest/chat/v1/credential.ts b/lib/rest/chat/v1/credential.ts index 997770e090..9db1d64294 100644 --- a/lib/rest/chat/v1/credential.ts +++ b/lib/rest/chat/v1/credential.ts @@ -313,32 +313,32 @@ export class CredentialInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Credential resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/api/rest/account) that created the Credential resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; type: CredentialPushService; /** - * [APN only] Whether to send the credential to sandbox APNs + * [APN only] Whether to send the credential to sandbox APNs. Can be `true` to send to sandbox APNs or `false` to send to production. */ sandbox: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The absolute URL of the Credential resource + * The absolute URL of the Credential resource. */ url: string; diff --git a/lib/rest/chat/v1/service.ts b/lib/rest/chat/v1/service.ts index 1dcb3d023f..a71155973c 100644 --- a/lib/rest/chat/v1/service.ts +++ b/lib/rest/chat/v1/service.ts @@ -586,87 +586,87 @@ export class ServiceInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Service resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/api/rest/account) that created the Service resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The service role assigned to users when they are added to the service + * The service role assigned to users when they are added to the service. See the [Roles endpoint](https://www.twilio.com/docs/chat/api/roles) for more details. */ defaultServiceRoleSid: string; /** - * The channel role assigned to users when they are added to a channel + * The channel role assigned to users when they are added to a channel. See the [Roles endpoint](https://www.twilio.com/docs/chat/api/roles) for more details. */ defaultChannelRoleSid: string; /** - * The channel role assigned to a channel creator when they join a new channel + * The channel role assigned to a channel creator when they join a new channel. See the [Roles endpoint](https://www.twilio.com/docs/chat/api/roles) for more details. */ defaultChannelCreatorRoleSid: string; /** - * Whether the Message Consumption Horizon feature is enabled + * Whether the [Message Consumption Horizon](https://www.twilio.com/docs/chat/consumption-horizon) feature is enabled. The default is `true`. */ readStatusEnabled: boolean; /** - * Whether the Reachability Indicator feature is enabled for this Service instance + * Whether the [Reachability Indicator](https://www.twilio.com/docs/chat/reachability-indicator) is enabled for this Service instance. The default is `false`. */ reachabilityEnabled: boolean; /** - * How long in seconds to wait before assuming the user is no longer typing + * How long in seconds after a `started typing` event until clients should assume that user is no longer typing, even if no `ended typing` message was received. The default is 5 seconds. */ typingIndicatorTimeout: number; /** - * DEPRECATED + * DEPRECATED. The interval in seconds between consumption reports submission batches from client endpoints. */ consumptionReportInterval: number; /** - * An object that describes the limits of the service instance + * An object that describes the limits of the service instance. The `limits` object contains `channel_members` to describe the members/channel limit and `user_channels` to describe the channels/user limit. `channel_members` can be 1,000 or less, with a default of 250. `user_channels` can be 1,000 or less, with a default value of 100. */ limits: any; /** - * An object that contains information about the webhooks configured for this service + * An object that contains information about the webhooks configured for this service. */ webhooks: any; /** - * The webhook URL for pre-event webhooks + * The URL for pre-event webhooks, which are called by using the `webhook_method`. See [Webhook Events](https://www.twilio.com/docs/api/chat/webhooks) for more details. */ preWebhookUrl: string; /** - * The URL for post-event webhooks + * The URL for post-event webhooks, which are called by using the `webhook_method`. See [Webhook Events](https://www.twilio.com/docs/api/chat/webhooks) for more details. */ postWebhookUrl: string; /** - * The HTTP method to use for both PRE and POST webhooks + * The HTTP method to use for calls to the `pre_webhook_url` and `post_webhook_url` webhooks. Can be: `POST` or `GET` and the default is `POST`. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details. */ webhookMethod: string; /** - * The list of WebHook events that are enabled for this Service instance + * The list of WebHook events that are enabled for this Service instance. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details. */ webhookFilters: Array; /** - * The notification configuration for the Service instance + * The notification configuration for the Service instance. See [Push Notification Configuration](https://www.twilio.com/docs/chat/push-notification-configuration) for more information. */ notifications: any; /** - * The absolute URL of the Service resource + * The absolute URL of the Service resource. */ url: string; /** - * The absolute URLs of the Service\'s Channels, Roles, and Users + * The absolute URLs of the Service\'s [Channels](https://www.twilio.com/docs/chat/api/channels), [Roles](https://www.twilio.com/docs/chat/api/roles), and [Users](https://www.twilio.com/docs/chat/api/users). */ links: Record; diff --git a/lib/rest/chat/v1/service/channel.ts b/lib/rest/chat/v1/service/channel.ts index e6065a4300..eaf7808e81 100644 --- a/lib/rest/chat/v1/service/channel.ts +++ b/lib/rest/chat/v1/service/channel.ts @@ -367,56 +367,56 @@ export class ChannelInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Channel resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/api/rest/account) that created the Channel resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/api/chat/rest/services) the resource is associated with. */ serviceSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource\'s `sid` in the URL. */ uniqueName: string; /** - * The JSON string that stores application-specific data + * The JSON string that stores application-specific data. **Note** If this property has been assigned a value, it\'s only displayed in a FETCH action that returns a single resource; otherwise, it\'s null. If the attributes have not been set, `{}` is returned. */ attributes: string; type: ChannelChannelType; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The identity of the User that created the channel + * The `identity` of the User that created the channel. If the Channel was created by using the API, the value is `system`. */ createdBy: string; /** - * The number of Members in the Channel + * The number of Members in the Channel. */ membersCount: number; /** - * The number of Messages in the Channel + * The number of Messages in the Channel. */ messagesCount: number; /** - * The absolute URL of the Channel resource + * The absolute URL of the Channel resource. */ url: string; /** - * Absolute URLs to access the Members, Messages , Invites and, if it exists, the last Message for the Channel + * The absolute URLs of the [Members](https://www.twilio.com/docs/chat/api/members), [Messages](https://www.twilio.com/docs/chat/api/messages) , [Invites](https://www.twilio.com/docs/chat/api/invites) and, if it exists, the last [Message](https://www.twilio.com/docs/chat/api/messages) for the Channel. */ links: Record; diff --git a/lib/rest/chat/v1/service/channel/invite.ts b/lib/rest/chat/v1/service/channel/invite.ts index c74f86c2d8..d8f2fd5225 100644 --- a/lib/rest/chat/v1/service/channel/invite.ts +++ b/lib/rest/chat/v1/service/channel/invite.ts @@ -235,43 +235,43 @@ export class InviteInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Invite resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/api/rest/account) that created the Invite resource. */ accountSid: string; /** - * The SID of the Channel the new resource belongs to + * The SID of the [Channel](https://www.twilio.com/docs/api/chat/rest/channels) the resource belongs to. */ channelSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/api/chat/rest/services) the resource is associated with. */ serviceSid: string; /** - * The string that identifies the resource\'s User + * The application-defined string that uniquely identifies the resource\'s [User](https://www.twilio.com/docs/api/chat/rest/users) within the [Service](https://www.twilio.com/docs/api/chat/rest/services). See [access tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens) for more info. */ identity: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The SID of the Role assigned to the member + * The SID of the [Role](https://www.twilio.com/docs/api/chat/rest/roles) assigned to the resource. */ roleSid: string; /** - * The identity of the User that created the invite + * The `identity` of the User that created the invite. */ createdBy: string; /** - * The absolute URL of the Invite resource + * The absolute URL of the Invite resource. */ url: string; diff --git a/lib/rest/chat/v1/service/channel/member.ts b/lib/rest/chat/v1/service/channel/member.ts index b255a79ebc..c2b5084066 100644 --- a/lib/rest/chat/v1/service/channel/member.ts +++ b/lib/rest/chat/v1/service/channel/member.ts @@ -323,47 +323,47 @@ export class MemberInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Member resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/api/rest/account) that created the Member resource. */ accountSid: string; /** - * The unique ID of the Channel for the member + * The unique ID of the [Channel](https://www.twilio.com/docs/api/chat/rest/channels) for the member. */ channelSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/api/chat/rest/services) the resource is associated with. */ serviceSid: string; /** - * The string that identifies the resource\'s User + * The application-defined string that uniquely identifies the resource\'s [User](https://www.twilio.com/docs/api/chat/rest/users) within the [Service](https://www.twilio.com/docs/api/chat/rest/services). See [access tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens) for more info. */ identity: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The SID of the Role assigned to the member + * The SID of the [Role](https://www.twilio.com/docs/api/chat/rest/roles) assigned to the member. */ roleSid: string; /** - * The index of the last Message that the Member has read within the Channel + * The index of the last [Message](https://www.twilio.com/docs/api/chat/rest/messages) in the [Channel](https://www.twilio.com/docs/api/chat/rest/channels) that the Member has read. */ lastConsumedMessageIndex: number; /** - * The ISO 8601 based timestamp string that represents the date-time of the last Message read event for the Member within the Channel + * The ISO 8601 timestamp string that represents the date-time of the last [Message](https://www.twilio.com/docs/api/chat/rest/messages) read event for the Member within the [Channel](https://www.twilio.com/docs/api/chat/rest/channels). */ lastConsumptionTimestamp: Date; /** - * The absolute URL of the Member resource + * The absolute URL of the Member resource. */ url: string; diff --git a/lib/rest/chat/v1/service/channel/message.ts b/lib/rest/chat/v1/service/channel/message.ts index 890b47aa39..76d16797c5 100644 --- a/lib/rest/chat/v1/service/channel/message.ts +++ b/lib/rest/chat/v1/service/channel/message.ts @@ -327,55 +327,55 @@ export class MessageInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Message resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/api/rest/account) that created the Message resource. */ accountSid: string; /** - * The JSON string that stores application-specific data + * The JSON string that stores application-specific data. **Note** If this property has been assigned a value, it\'s only displayed in a FETCH action that returns a single resource; otherwise, it\'s null. If the attributes have not been set, `{}` is returned. */ attributes: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/api/chat/rest/services) the resource is associated with. */ serviceSid: string; /** - * The SID of the Channel that the message was sent to + * The SID of the [Channel](https://www.twilio.com/docs/chat/api/channels) that the message was sent to. */ to: string; /** - * The unique ID of the Channel the Message resource belongs to + * The unique ID of the [Channel](https://www.twilio.com/docs/api/chat/rest/channels) the Message resource belongs to. */ channelSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * Whether the message has been edited since it was created + * Whether the message has been edited since it was created. */ wasEdited: boolean; /** - * The identity of the message\'s author + * The [identity](https://www.twilio.com/docs/api/chat/guides/identity) of the message\'s author. The default value is `system`. */ from: string; /** - * The content of the message + * The content of the message. */ body: string; /** - * The index of the message within the Channel + * The index of the message within the [Channel](https://www.twilio.com/docs/chat/api/channels). */ index: number; /** - * The absolute URL of the Message resource + * The absolute URL of the Message resource. */ url: string; diff --git a/lib/rest/chat/v1/service/role.ts b/lib/rest/chat/v1/service/role.ts index 4db89fb726..0a3933f4ba 100644 --- a/lib/rest/chat/v1/service/role.ts +++ b/lib/rest/chat/v1/service/role.ts @@ -285,36 +285,36 @@ export class RoleInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Role resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/api/rest/account) that created the Role resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/api/chat/rest/services) the resource is associated with. */ serviceSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; type: RoleRoleType; /** - * An array of the permissions the role has been granted + * An array of the permissions the role has been granted, formatted as a JSON string. */ permissions: Array; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The absolute URL of the Role resource + * The absolute URL of the Role resource. */ url: string; diff --git a/lib/rest/chat/v1/service/user.ts b/lib/rest/chat/v1/service/user.ts index c830eedae8..71927be25a 100644 --- a/lib/rest/chat/v1/service/user.ts +++ b/lib/rest/chat/v1/service/user.ts @@ -332,59 +332,59 @@ export class UserInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the User resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/api/rest/account) that created the User resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/api/chat/rest/services) the resource is associated with. */ serviceSid: string; /** - * The JSON string that stores application-specific data + * The JSON string that stores application-specific data. **Note** If this property has been assigned a value, it\'s only displayed in a FETCH action that returns a single resource; otherwise, it\'s null. If the attributes have not been set, `{}` is returned. */ attributes: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The SID of the assigned to the user + * The SID of the [Role](https://www.twilio.com/docs/api/chat/rest/roles) assigned to the user. */ roleSid: string; /** - * The string that identifies the resource\'s User + * The application-defined string that uniquely identifies the resource\'s User within the [Service](https://www.twilio.com/docs/api/chat/rest/services). This value is often a username or an email address. See [access tokens](https://www.twilio.com/docs/api/chat/guides/create-tokens) for more info. */ identity: string; /** - * Whether the User is actively connected to the Service instance and online + * Whether the User is actively connected to the Service instance and online. This value is only returned by Fetch actions that return a single resource and `null` is always returned by a Read action. This value is `null` if the Service\'s `reachability_enabled` is `false`, if the User has never been online for the Service instance, even if the Service\'s `reachability_enabled` is `true`. */ isOnline: boolean; /** - * Whether the User has a potentially valid Push Notification registration for the Service instance + * Whether the User has a potentially valid Push Notification registration (APN or GCM) for the Service instance. If at least one registration exists, `true`; otherwise `false`. This value is only returned by Fetch actions that return a single resource and `null` is always returned by a Read action. This value is `null` if the Service\'s `reachability_enabled` is `false`, and if the User has never had a notification registration, even if the Service\'s `reachability_enabled` is `true`. */ isNotifiable: boolean; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The number of Channels this User is a Member of + * The number of Channels this User is a Member of. */ joinedChannelsCount: number; /** - * The absolute URLs of the Channel and Binding resources related to the user + * The absolute URLs of the [Channel](https://www.twilio.com/docs/chat/api/channels) and [Binding](https://www.twilio.com/docs/chat/rest/bindings-resource) resources related to the user. */ links: Record; /** - * The absolute URL of the User resource + * The absolute URL of the User resource. */ url: string; diff --git a/lib/rest/chat/v1/service/user/userChannel.ts b/lib/rest/chat/v1/service/user/userChannel.ts index b6a6f67231..1889295bda 100644 --- a/lib/rest/chat/v1/service/user/userChannel.ts +++ b/lib/rest/chat/v1/service/user/userChannel.ts @@ -275,32 +275,32 @@ export class UserChannelInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/api/rest/account) that created the User Channel resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/api/chat/rest/services) the resource is associated with. */ serviceSid: string; /** - * The SID of the Channel the resource belongs to + * The SID of the [Channel](https://www.twilio.com/docs/api/chat/rest/channels) the resource belongs to. */ channelSid: string; /** - * The SID of the User as a Member in the Channel + * The SID of a [Member](https://www.twilio.com/docs/api/chat/rest/members) that represents the User on the Channel. */ memberSid: string; status: UserChannelChannelStatus; /** - * The index of the last Message in the Channel the Member has read + * The index of the last [Message](https://www.twilio.com/docs/api/chat/rest/messages) in the [Channel](https://www.twilio.com/docs/api/chat/rest/channels) that the Member has read. */ lastConsumedMessageIndex: number; /** - * The number of unread Messages in the Channel for the User + * The number of unread Messages in the Channel for the User. Note that retrieving messages on a client endpoint does not mean that messages are consumed or read. See [Consumption Horizon feature](/docs/api/chat/guides/consumption-horizon) to learn how to mark messages as consumed. */ unreadMessagesCount: number; /** - * Absolute URLs to access the Members, Messages , Invites and, if it exists, the last Message for the Channel + * The absolute URLs of the [Members](https://www.twilio.com/docs/chat/api/members), [Messages](https://www.twilio.com/docs/chat/api/messages) , [Invites](https://www.twilio.com/docs/chat/api/invites) and, if it exists, the last [Message](https://www.twilio.com/docs/chat/api/messages) for the Channel. */ links: Record; diff --git a/lib/rest/chat/v2/credential.ts b/lib/rest/chat/v2/credential.ts index b16b84b0d2..92c2913d81 100644 --- a/lib/rest/chat/v2/credential.ts +++ b/lib/rest/chat/v2/credential.ts @@ -313,32 +313,32 @@ export class CredentialInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Credential resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Credential resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; type: CredentialPushService; /** - * [APN only] Whether to send the credential to sandbox APNs + * [APN only] Whether to send the credential to sandbox APNs. Can be `true` to send to sandbox APNs or `false` to send to production. */ sandbox: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Credential resource + * The absolute URL of the Credential resource. */ url: string; diff --git a/lib/rest/chat/v2/service.ts b/lib/rest/chat/v2/service.ts index c10be04a89..9f06bac58d 100644 --- a/lib/rest/chat/v2/service.ts +++ b/lib/rest/chat/v2/service.ts @@ -492,95 +492,95 @@ export class ServiceInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Service resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The service role assigned to users when they are added to the service + * The service role assigned to users when they are added to the service. See the [Role resource](https://www.twilio.com/docs/chat/rest/role-resource) for more info about roles. */ defaultServiceRoleSid: string; /** - * The channel role assigned to users when they are added to a channel + * The channel role assigned to users when they are added to a channel. See the [Role resource](https://www.twilio.com/docs/chat/rest/role-resource) for more info about roles. */ defaultChannelRoleSid: string; /** - * The channel role assigned to a channel creator when they join a new channel + * The channel role assigned to a channel creator when they join a new channel. See the [Role resource](https://www.twilio.com/docs/chat/rest/role-resource) for more info about roles. */ defaultChannelCreatorRoleSid: string; /** - * Whether the Message Consumption Horizon feature is enabled + * Whether the [Message Consumption Horizon](https://www.twilio.com/docs/chat/consumption-horizon) feature is enabled. The default is `true`. */ readStatusEnabled: boolean; /** - * Whether the Reachability Indicator feature is enabled for this Service instance + * Whether the [Reachability Indicator](https://www.twilio.com/docs/chat/reachability-indicator) is enabled for this Service instance. The default is `false`. */ reachabilityEnabled: boolean; /** - * How long in seconds to wait before assuming the user is no longer typing + * How long in seconds after a `started typing` event until clients should assume that user is no longer typing, even if no `ended typing` message was received. The default is 5 seconds. */ typingIndicatorTimeout: number; /** - * DEPRECATED + * DEPRECATED. The interval in seconds between consumption reports submission batches from client endpoints. */ consumptionReportInterval: number; /** - * An object that describes the limits of the service instance + * An object that describes the limits of the service instance. The `limits` object contains `channel_members` to describe the members/channel limit and `user_channels` to describe the channels/user limit. `channel_members` can be 1,000 or less, with a default of 250. `user_channels` can be 1,000 or less, with a default value of 100. */ limits: any; /** - * The webhook URL for pre-event webhooks + * The URL for pre-event webhooks, which are called by using the `webhook_method`. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details. */ preWebhookUrl: string; /** - * The URL for post-event webhooks + * The URL for post-event webhooks, which are called by using the `webhook_method`. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details. */ postWebhookUrl: string; /** - * The HTTP method to use for both PRE and POST webhooks + * The HTTP method to use for calls to the `pre_webhook_url` and `post_webhook_url` webhooks. Can be: `POST` or `GET` and the default is `POST`. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details. */ webhookMethod: string; /** - * The list of webhook events that are enabled for this Service instance + * The list of webhook events that are enabled for this Service instance. See [Webhook Events](https://www.twilio.com/docs/chat/webhook-events) for more details. */ webhookFilters: Array; /** - * Count of times webhook will be retried in case of timeout or 429/503/504 HTTP responses + * The number of times to retry a call to the `pre_webhook_url` if the request times out (after 5 seconds) or it receives a 429, 503, or 504 HTTP response. Default retry count is 0 times, which means the call won\'t be retried. */ preWebhookRetryCount: number; /** - * The number of times calls to the `post_webhook_url` will be retried + * The number of times to retry a call to the `post_webhook_url` if the request times out (after 5 seconds) or it receives a 429, 503, or 504 HTTP response. The default is 0, which means the call won\'t be retried. */ postWebhookRetryCount: number; /** - * The notification configuration for the Service instance + * The notification configuration for the Service instance. See [Push Notification Configuration](https://www.twilio.com/docs/chat/push-notification-configuration) for more info. */ notifications: any; /** - * The properties of the media that the service supports + * An object that describes the properties of media that the service supports. The object contains the `size_limit_mb` property, which describes the size of the largest media file in MB; and the `compatibility_message` property, which contains the message text to send when a media message does not have any text. */ media: any; /** - * The absolute URL of the Service resource + * The absolute URL of the Service resource. */ url: string; /** - * The absolute URLs of the Service\'s Channels, Roles, and Users + * The absolute URLs of the Service\'s [Channels](https://www.twilio.com/docs/chat/channels), [Roles](https://www.twilio.com/docs/chat/rest/role-resource), [Bindings](https://www.twilio.com/docs/chat/rest/binding-resource), and [Users](https://www.twilio.com/docs/chat/rest/user-resource). */ links: Record; diff --git a/lib/rest/chat/v2/service/binding.ts b/lib/rest/chat/v2/service/binding.ts index 3dbf630561..0fb33f2886 100644 --- a/lib/rest/chat/v2/service/binding.ts +++ b/lib/rest/chat/v2/service/binding.ts @@ -226,48 +226,48 @@ export class BindingInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Binding resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Binding resource. */ accountSid: string; /** - * The SID of the Service that the Binding resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the Binding resource is associated with. */ serviceSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The unique endpoint identifier for the Binding + * The unique endpoint identifier for the Binding. The format of this value depends on the `binding_type`. */ endpoint: string; /** - * The string that identifies the resource\'s User + * The application-defined string that uniquely identifies the resource\'s [User](https://www.twilio.com/docs/chat/rest/user-resource) within the [Service](https://www.twilio.com/docs/chat/rest/service-resource). See [access tokens](https://www.twilio.com/docs/chat/create-tokens) for more info. */ identity: string; /** - * The SID of the Credential for the binding + * The SID of the [Credential](https://www.twilio.com/docs/chat/rest/credential-resource) for the binding. See [push notification configuration](https://www.twilio.com/docs/chat/push-notification-configuration) for more info. */ credentialSid: string; bindingType: BindingBindingType; /** - * The Programmable Chat message types the binding is subscribed to + * The [Programmable Chat message types](https://www.twilio.com/docs/chat/push-notification-configuration#push-types) the binding is subscribed to. */ messageTypes: Array; /** - * The absolute URL of the Binding resource + * The absolute URL of the Binding resource. */ url: string; /** - * The absolute URLs of the Binding\'s User + * The absolute URLs of the Binding\'s [User](https://www.twilio.com/docs/chat/rest/user-resource). */ links: Record; diff --git a/lib/rest/chat/v2/service/channel.ts b/lib/rest/chat/v2/service/channel.ts index faff3f389f..4ec46db2a3 100644 --- a/lib/rest/chat/v2/service/channel.ts +++ b/lib/rest/chat/v2/service/channel.ts @@ -445,56 +445,56 @@ export class ChannelInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Channel resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Channel resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the Channel resource is associated with. */ serviceSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource\'s `sid` in the URL. */ uniqueName: string; /** - * The JSON string that stores application-specific data + * The JSON string that stores application-specific data. If attributes have not been set, `{}` is returned. */ attributes: string; type: ChannelChannelType; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The identity of the User that created the channel + * The `identity` of the User that created the channel. If the Channel was created by using the API, the value is `system`. */ createdBy: string; /** - * The number of Members in the Channel + * The number of Members in the Channel. */ membersCount: number; /** - * The number of Messages that have been passed in the Channel + * The number of Messages that have been passed in the Channel. */ messagesCount: number; /** - * The absolute URL of the Channel resource + * The absolute URL of the Channel resource. */ url: string; /** - * Absolute URLs to access the Members, Messages , Invites and, if it exists, the last Message for the Channel + * The absolute URLs of the [Members](https://www.twilio.com/docs/chat/rest/member-resource), [Messages](https://www.twilio.com/docs/chat/rest/message-resource), [Invites](https://www.twilio.com/docs/chat/rest/invite-resource), Webhooks and, if it exists, the last [Message](https://www.twilio.com/docs/chat/rest/message-resource) for the Channel. */ links: Record; diff --git a/lib/rest/chat/v2/service/channel/invite.ts b/lib/rest/chat/v2/service/channel/invite.ts index 716106afeb..b37ca549b3 100644 --- a/lib/rest/chat/v2/service/channel/invite.ts +++ b/lib/rest/chat/v2/service/channel/invite.ts @@ -235,43 +235,43 @@ export class InviteInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Invite resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Invite resource. */ accountSid: string; /** - * The SID of the Channel the new resource belongs to + * The SID of the [Channel](https://www.twilio.com/docs/chat/channels) the Invite resource belongs to. */ channelSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the Invite resource is associated with. */ serviceSid: string; /** - * The string that identifies the resource\'s User + * The application-defined string that uniquely identifies the resource\'s [User](https://www.twilio.com/docs/chat/rest/user-resource) within the [Service](https://www.twilio.com/docs/chat/rest/service-resource). See [access tokens](https://www.twilio.com/docs/chat/create-tokens) for more info. */ identity: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The SID of the Role assigned to the member + * The SID of the [Role](https://www.twilio.com/docs/chat/rest/role-resource) assigned to the resource. */ roleSid: string; /** - * The identity of the User that created the invite + * The `identity` of the User that created the invite. */ createdBy: string; /** - * The absolute URL of the Invite resource + * The absolute URL of the Invite resource. */ url: string; diff --git a/lib/rest/chat/v2/service/channel/member.ts b/lib/rest/chat/v2/service/channel/member.ts index 5ccc2bcfaa..8d92c822ef 100644 --- a/lib/rest/chat/v2/service/channel/member.ts +++ b/lib/rest/chat/v2/service/channel/member.ts @@ -399,51 +399,51 @@ export class MemberInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Member resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Member resource. */ accountSid: string; /** - * The SID of the Channel for the member + * The SID of the [Channel](https://www.twilio.com/docs/chat/channels) the Member resource belongs to. */ channelSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the Member resource is associated with. */ serviceSid: string; /** - * The string that identifies the resource\'s User + * The application-defined string that uniquely identifies the resource\'s [User](https://www.twilio.com/docs/chat/rest/user-resource) within the [Service](https://www.twilio.com/docs/chat/rest/service-resource). See [access tokens](https://www.twilio.com/docs/chat/create-tokens) for more info. */ identity: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The SID of the Role assigned to the member + * The SID of the [Role](https://www.twilio.com/docs/chat/rest/role-resource) assigned to the member. */ roleSid: string; /** - * The index of the last Message that the Member has read within the Channel + * The index of the last [Message](https://www.twilio.com/docs/chat/rest/message-resource) in the [Channel](https://www.twilio.com/docs/chat/channels) that the Member has read. */ lastConsumedMessageIndex: number; /** - * The ISO 8601 based timestamp string that represents the datetime of the last Message read event for the Member within the Channel + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp of the last [Message](https://www.twilio.com/docs/chat/rest/message-resource) read event for the Member within the [Channel](https://www.twilio.com/docs/chat/channels). */ lastConsumptionTimestamp: Date; /** - * The absolute URL of the Member resource + * The absolute URL of the Member resource. */ url: string; /** - * The JSON string that stores application-specific data + * The JSON string that stores application-specific data. If attributes have not been set, `{}` is returned. */ attributes: string; diff --git a/lib/rest/chat/v2/service/channel/message.ts b/lib/rest/chat/v2/service/channel/message.ts index 914098e573..c079dba6d0 100644 --- a/lib/rest/chat/v2/service/channel/message.ts +++ b/lib/rest/chat/v2/service/channel/message.ts @@ -402,67 +402,67 @@ export class MessageInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Message resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Message resource. */ accountSid: string; /** - * The JSON string that stores application-specific data + * The JSON string that stores application-specific data. If attributes have not been set, `{}` is returned. */ attributes: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the Message resource is associated with. */ serviceSid: string; /** - * The SID of the Channel that the message was sent to + * The SID of the [Channel](https://www.twilio.com/docs/chat/channels) that the message was sent to. */ to: string; /** - * The SID of the Channel the Message resource belongs to + * The SID of the [Channel](https://www.twilio.com/docs/chat/channels) the Message resource belongs to. */ channelSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The Identity of the User who last updated the Message + * The [Identity](https://www.twilio.com/docs/chat/identity) of the User who last updated the Message, if applicable. */ lastUpdatedBy: string; /** - * Whether the message has been edited since it was created + * Whether the message has been edited since it was created. */ wasEdited: boolean; /** - * The Identity of the message\'s author + * The [Identity](https://www.twilio.com/docs/chat/identity) of the message\'s author. The default value is `system`. */ from: string; /** - * The content of the message + * The content of the message. */ body: string; /** - * The index of the message within the Channel + * The index of the message within the [Channel](https://www.twilio.com/docs/chat/channels). Indices may skip numbers, but will always be in order of when the message was received. */ index: number; /** - * The Message type + * The Message type. Can be: `text` or `media`. */ type: string; /** - * A Media object that describes the Message\'s media if attached; otherwise, null + * An object that describes the Message\'s media, if the message contains media. The object contains these fields: `content_type` with the MIME type of the media, `filename` with the name of the media, `sid` with the SID of the Media resource, and `size` with the media object\'s file size in bytes. If the Message has no media, this value is `null`. */ media: any; /** - * The absolute URL of the Message resource + * The absolute URL of the Message resource. */ url: string; diff --git a/lib/rest/chat/v2/service/channel/webhook.ts b/lib/rest/chat/v2/service/channel/webhook.ts index ed68820193..04ad992b97 100644 --- a/lib/rest/chat/v2/service/channel/webhook.ts +++ b/lib/rest/chat/v2/service/channel/webhook.ts @@ -346,39 +346,39 @@ export class WebhookInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Channel Webhook resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Channel Webhook resource. */ accountSid: string; /** - * The SID of the Service that the Channel Webhook resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the Channel Webhook resource is associated with. */ serviceSid: string; /** - * The SID of the Channel the Channel Webhook resource belongs to + * The SID of the [Channel](https://www.twilio.com/docs/chat/channels) the Channel Webhook resource belongs to. */ channelSid: string; /** - * The type of webhook + * The type of webhook. Can be: `webhook`, `studio`, or `trigger`. */ type: string; /** - * The absolute URL of the Channel Webhook resource + * The absolute URL of the Channel Webhook resource. */ url: string; /** - * The JSON string that describes the configuration object for the channel webhook + * The JSON string that describes how the channel webhook is configured. The configuration object contains the `url`, `method`, `filters`, and `retry_count` values that are configured by the create and update actions. */ configuration: any; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; diff --git a/lib/rest/chat/v2/service/role.ts b/lib/rest/chat/v2/service/role.ts index c425947d2f..095e90eb62 100644 --- a/lib/rest/chat/v2/service/role.ts +++ b/lib/rest/chat/v2/service/role.ts @@ -285,36 +285,36 @@ export class RoleInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Role resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Role resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the Role resource is associated with. */ serviceSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; type: RoleRoleType; /** - * An array of the permissions the role has been granted + * An array of the permissions the role has been granted. */ permissions: Array; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Role resource + * The absolute URL of the Role resource. */ url: string; diff --git a/lib/rest/chat/v2/service/user.ts b/lib/rest/chat/v2/service/user.ts index 96bbcbcd88..d423b7a698 100644 --- a/lib/rest/chat/v2/service/user.ts +++ b/lib/rest/chat/v2/service/user.ts @@ -354,59 +354,59 @@ export class UserInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the User resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the User resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the User resource is associated with. */ serviceSid: string; /** - * The JSON string that stores application-specific data + * The JSON string that stores application-specific data. If attributes have not been set, `{}` is returned. */ attributes: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The SID of the Role assigned to the user + * The SID of the [Role](https://www.twilio.com/docs/chat/rest/role-resource) assigned to the user. */ roleSid: string; /** - * The string that identifies the resource\'s User + * The application-defined string that uniquely identifies the resource\'s User within the [Service](https://www.twilio.com/docs/chat/rest/service-resource). This value is often a username or an email address, and is case-sensitive. See [access tokens](https://www.twilio.com/docs/chat/create-tokens) for more info. */ identity: string; /** - * Whether the User is actively connected to the Service instance and online + * Whether the User is actively connected to the Service instance and online. This value is only returned by Fetch actions that return a single resource and `null` is always returned by a Read action. This value is `null` if the Service\'s `reachability_enabled` is `false`, if the User has never been online for the Service instance, even if the Service\'s `reachability_enabled` is `true`. */ isOnline: boolean; /** - * Whether the User has a potentially valid Push Notification registration for the Service instance + * Whether the User has a potentially valid Push Notification registration (APN or GCM) for the Service instance. If at least one registration exists, `true`; otherwise `false`. This value is only returned by Fetch actions that return a single resource and `null` is always returned by a Read action. This value is `null` if the Service\'s `reachability_enabled` is `false`, and if the User has never had a notification registration, even if the Service\'s `reachability_enabled` is `true`. */ isNotifiable: boolean; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The number of Channels the User is a Member of + * The number of Channels the User is a Member of. */ joinedChannelsCount: number; /** - * The absolute URLs of the Channel and Binding resources related to the user + * The absolute URLs of the [Channel](https://www.twilio.com/docs/chat/channels) and [Binding](https://www.twilio.com/docs/chat/rest/binding-resource) resources related to the user. */ links: Record; /** - * The absolute URL of the User resource + * The absolute URL of the User resource. */ url: string; diff --git a/lib/rest/chat/v2/service/user/userBinding.ts b/lib/rest/chat/v2/service/user/userBinding.ts index 3759374528..6957f1eb28 100644 --- a/lib/rest/chat/v2/service/user/userBinding.ts +++ b/lib/rest/chat/v2/service/user/userBinding.ts @@ -232,48 +232,48 @@ export class UserBindingInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the User Binding resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the User Binding resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the User Binding resource is associated with. */ serviceSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The unique endpoint identifier for the User Binding + * The unique endpoint identifier for the User Binding. The format of the value depends on the `binding_type`. */ endpoint: string; /** - * The string that identifies the resource\'s User + * The application-defined string that uniquely identifies the resource\'s [User](https://www.twilio.com/docs/chat/rest/user-resource) within the [Service](https://www.twilio.com/docs/chat/rest/service-resource). See [access tokens](https://www.twilio.com/docs/chat/create-tokens) for more info. */ identity: string; /** - * The SID of the User with the binding + * The SID of the [User](https://www.twilio.com/docs/chat/rest/user-resource) with the User Binding resource. See [push notification configuration](https://www.twilio.com/docs/chat/push-notification-configuration) for more info. */ userSid: string; /** - * The SID of the Credential for the binding + * The SID of the [Credential](https://www.twilio.com/docs/chat/rest/credential-resource) for the binding. See [push notification configuration](https://www.twilio.com/docs/chat/push-notification-configuration) for more info. */ credentialSid: string; bindingType: UserBindingBindingType; /** - * The Programmable Chat message types the binding is subscribed to + * The [Programmable Chat message types](https://www.twilio.com/docs/chat/push-notification-configuration#push-types) the binding is subscribed to. */ messageTypes: Array; /** - * The absolute URL of the User Binding resource + * The absolute URL of the User Binding resource. */ url: string; diff --git a/lib/rest/chat/v2/service/user/userChannel.ts b/lib/rest/chat/v2/service/user/userChannel.ts index b57bc41dbe..e0fbe9a96e 100644 --- a/lib/rest/chat/v2/service/user/userChannel.ts +++ b/lib/rest/chat/v2/service/user/userChannel.ts @@ -362,40 +362,40 @@ export class UserChannelInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the User Channel resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the User Channel resource is associated with. */ serviceSid: string; /** - * The SID of the Channel the resource belongs to + * The SID of the [Channel](https://www.twilio.com/docs/chat/channels) the User Channel resource belongs to. */ channelSid: string; /** - * The SID of the User the User Channel belongs to + * The SID of the [User](https://www.twilio.com/docs/chat/rest/user-resource) the User Channel belongs to. */ userSid: string; /** - * The SID of the User as a Member in the Channel + * The SID of a [Member](https://www.twilio.com/docs/chat/rest/member-resource) that represents the User on the Channel. */ memberSid: string; status: UserChannelChannelStatus; /** - * The index of the last Message in the Channel the Member has read + * The index of the last [Message](https://www.twilio.com/docs/chat/rest/message-resource) in the [Channel](https://www.twilio.com/docs/chat/channels) that the Member has read. */ lastConsumedMessageIndex: number; /** - * The number of unread Messages in the Channel for the User + * The number of unread Messages in the Channel for the User. Note that retrieving messages on a client endpoint does not mean that messages are consumed or read. See [Consumption Horizon feature](https://www.twilio.com/docs/chat/consumption-horizon) to learn how to mark messages as consumed. */ unreadMessagesCount: number; /** - * Absolute URLs to access the Members, Messages , Invites and, if it exists, the last Message for the Channel + * The absolute URLs of the [Members](https://www.twilio.com/docs/chat/rest/member-resource), [Messages](https://www.twilio.com/docs/chat/rest/message-resource) , [Invites](https://www.twilio.com/docs/chat/rest/invite-resource) and, if it exists, the last [Message](https://www.twilio.com/docs/chat/rest/message-resource) for the Channel. */ links: Record; /** - * The absolute URL of the resource + * The absolute URL of the User Channel resource. */ url: string; notificationLevel: UserChannelNotificationLevel; diff --git a/lib/rest/chat/v3/channel.ts b/lib/rest/chat/v3/channel.ts index 3c419f8d82..2b0f6966ca 100644 --- a/lib/rest/chat/v3/channel.ts +++ b/lib/rest/chat/v3/channel.ts @@ -202,56 +202,56 @@ export class ChannelInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Channel resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Channel resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the Channel resource is associated with. */ serviceSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource\'s `sid` in the URL. */ uniqueName: string; /** - * The JSON string that stores application-specific data + * The JSON string that stores application-specific data. If attributes have not been set, `{}` is returned. */ attributes: string; type: ChannelChannelType; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The identity of the User that created the channel + * The `identity` of the User that created the channel. If the Channel was created by using the API, the value is `system`. */ createdBy: string; /** - * The number of Members in the Channel + * The number of Members in the Channel. */ membersCount: number; /** - * The number of Messages that have been passed in the Channel + * The number of Messages that have been passed in the Channel. */ messagesCount: number; /** - * The unique ID of the Messaging Service this channel belongs to. + * The unique ID of the [Messaging Service](https://www.twilio.com/docs/sms/services/api) this channel belongs to. */ messagingServiceSid: string; /** - * The absolute URL of the Channel resource + * The absolute URL of the Channel resource. */ url: string; diff --git a/lib/rest/content/v1/content.ts b/lib/rest/content/v1/content.ts index 4db5bf24f2..c116969e22 100644 --- a/lib/rest/content/v1/content.ts +++ b/lib/rest/content/v1/content.ts @@ -205,43 +205,43 @@ export class ContentInstance { } /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the Content resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/usage/api/account) that created Content resource. */ accountSid: string; /** - * A string name used to describe the Content resource + * A string name used to describe the Content resource. Not visible to the end recipient. */ friendlyName: string; /** - * Two-letter language code identifying the language the Content resource is in. + * Two-letter (ISO 639-1) language code (e.g., en) identifying the language the Content resource is in. */ language: string; /** - * Defines the default placeholder values for variables included in the Content resource + * Defines the default placeholder values for variables included in the Content resource. e.g. {\"1\": \"Customer_Name\"}. */ variables: any; /** - * The Content types (e.g. twilio/text) for this Content resource + * The [Content types](https://www.twilio.com/docs/content-api/content-types-overview) (e.g. twilio/text) for this Content resource. */ types: any; /** - * The URL of the resource, relative to `https://content.twilio.com` + * The URL of the resource, relative to `https://content.twilio.com`. */ url: string; /** - * A list of links related to the Content resource + * A list of links related to the Content resource, such as approval_fetch and approval_create */ links: Record; diff --git a/lib/rest/content/v1/content/approvalFetch.ts b/lib/rest/content/v1/content/approvalFetch.ts index a5ab085de0..63f7161ea3 100644 --- a/lib/rest/content/v1/content/approvalFetch.ts +++ b/lib/rest/content/v1/content/approvalFetch.ts @@ -121,19 +121,19 @@ export class ApprovalFetchInstance { } /** - * The unique string that identifies the Content resource + * The unique string that that we created to identify the Content resource. */ sid: string; /** - * The SID of the Account that created the Content resource + * The SID of the [Account](https://www.twilio.com/docs/usage/api/account) that created Content resource. */ accountSid: string; /** - * Contains the whatsapp approval information for the Content resource + * Contains the whatsapp approval information for the Content resource, with fields such as approval status, rejection reason, and category, amongst others. */ whatsapp: any; /** - * The URL of the resource, relative to `https://content.twilio.com` + * The URL of the resource, relative to `https://content.twilio.com`. */ url: string; diff --git a/lib/rest/conversations/v1/addressConfiguration.ts b/lib/rest/conversations/v1/addressConfiguration.ts index 529410ef58..21a6fcf2bd 100644 --- a/lib/rest/conversations/v1/addressConfiguration.ts +++ b/lib/rest/conversations/v1/addressConfiguration.ts @@ -363,19 +363,19 @@ export class AddressConfigurationInstance { */ sid: string; /** - * The unique ID of the Account the address belongs to. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) the address belongs to */ accountSid: string; /** - * Type of Address. + * Type of Address, value can be `whatsapp` or `sms`. */ type: string; /** - * The unique address to be configured. + * The unique address to be configured. The address can be a whatsapp address or phone number */ address: string; /** - * The human-readable name of this configuration. + * The human-readable name of this configuration, limited to 256 characters. Optional. */ friendlyName: string; /** @@ -391,7 +391,7 @@ export class AddressConfigurationInstance { */ dateUpdated: Date; /** - * An absolute URL for this address configuration. + * An absolute API resource URL for this address configuration. */ url: string; diff --git a/lib/rest/conversations/v1/configuration.ts b/lib/rest/conversations/v1/configuration.ts index 08e9d230ab..488fcfebb2 100644 --- a/lib/rest/conversations/v1/configuration.ts +++ b/lib/rest/conversations/v1/configuration.ts @@ -197,31 +197,31 @@ export class ConfigurationInstance { } /** - * The SID of the Account responsible for this configuration. + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this configuration. */ accountSid: string; /** - * The SID of the default Conversation Service that every new conversation is associated with. + * The SID of the default [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) used when creating a conversation. */ defaultChatServiceSid: string; /** - * The SID of the default Messaging Service that every new conversation is associated with. + * The SID of the default [Messaging Service](https://www.twilio.com/docs/sms/services/api) used when creating a conversation. */ defaultMessagingServiceSid: string; /** - * Default ISO8601 duration when conversation will be switched to `inactive` state. + * Default ISO8601 duration when conversation will be switched to `inactive` state. Minimum value for this timer is 1 minute. */ defaultInactiveTimer: string; /** - * Default ISO8601 duration when conversation will be switched to `closed` state. + * Default ISO8601 duration when conversation will be switched to `closed` state. Minimum value for this timer is 10 minutes. */ defaultClosedTimer: string; /** - * An absolute URL for this global configuration. + * An absolute API resource URL for this global configuration. */ url: string; /** - * Absolute URLs to access the webhook and default service configurations. + * Contains absolute API resource URLs to access the webhook and default service configurations. */ links: Record; diff --git a/lib/rest/conversations/v1/configuration/webhook.ts b/lib/rest/conversations/v1/configuration/webhook.ts index ed5cd4960f..ccc3abeb9f 100644 --- a/lib/rest/conversations/v1/configuration/webhook.ts +++ b/lib/rest/conversations/v1/configuration/webhook.ts @@ -202,12 +202,12 @@ export class WebhookInstance { } /** - * The unique ID of the Account responsible for this conversation. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation. */ accountSid: string; method: ConfigurationWebhookMethod; /** - * The list of webhook event triggers that are enabled for this Service. + * The list of webhook event triggers that are enabled for this Service: `onMessageAdded`, `onMessageUpdated`, `onMessageRemoved`, `onConversationUpdated`, `onConversationRemoved`, `onParticipantAdded`, `onParticipantUpdated`, `onParticipantRemoved` */ filters: Array; /** @@ -220,7 +220,7 @@ export class WebhookInstance { postWebhookUrl: string; target: ConfigurationWebhookTarget; /** - * An absolute URL for this webhook. + * An absolute API resource API resource URL for this webhook. */ url: string; diff --git a/lib/rest/conversations/v1/conversation.ts b/lib/rest/conversations/v1/conversation.ts index 73bd4a382b..a39c718ac0 100644 --- a/lib/rest/conversations/v1/conversation.ts +++ b/lib/rest/conversations/v1/conversation.ts @@ -418,15 +418,15 @@ export class ConversationInstance { } /** - * The unique ID of the Account responsible for this conversation. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation. */ accountSid: string; /** - * The unique ID of the Conversation Service this conversation belongs to. + * The unique ID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) this conversation belongs to. */ chatServiceSid: string; /** - * The unique ID of the Messaging Service this conversation belongs to. + * The unique ID of the [Messaging Service](https://www.twilio.com/docs/sms/services/api) this conversation belongs to. */ messagingServiceSid: string; /** @@ -434,15 +434,15 @@ export class ConversationInstance { */ sid: string; /** - * The human-readable name of this conversation. + * The human-readable name of this conversation, limited to 256 characters. Optional. */ friendlyName: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource\'s `sid` in the URL. */ uniqueName: string; /** - * An optional string metadata field you can use to store any data you wish. + * An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set \"{}\" will be returned. */ attributes: string; state: ConversationState; @@ -455,15 +455,15 @@ export class ConversationInstance { */ dateUpdated: Date; /** - * Timer date values for this conversation. + * Timer date values representing state update for this conversation. */ timers: any; /** - * An absolute URL for this conversation. + * An absolute API resource URL for this conversation. */ url: string; /** - * Absolute URLs to access the participants, messages and webhooks of this conversation. + * Contains absolute URLs to access the [participants](https://www.twilio.com/docs/conversations/api/conversation-participant-resource), [messages](https://www.twilio.com/docs/conversations/api/conversation-message-resource) and [webhooks](https://www.twilio.com/docs/conversations/api/conversation-scoped-webhook-resource) of this conversation. */ links: Record; bindings: any; diff --git a/lib/rest/conversations/v1/conversation/message.ts b/lib/rest/conversations/v1/conversation/message.ts index 6b4574ef07..8b6c1171b2 100644 --- a/lib/rest/conversations/v1/conversation/message.ts +++ b/lib/rest/conversations/v1/conversation/message.ts @@ -401,11 +401,11 @@ export class MessageInstance { } /** - * The unique ID of the Account responsible for this message. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this message. */ accountSid: string; /** - * The unique ID of the Conversation for this message. + * The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this message. */ conversationSid: string; /** @@ -413,27 +413,27 @@ export class MessageInstance { */ sid: string; /** - * The index of the message within the Conversation. + * The index of the message within the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource). Indices may skip numbers, but will always be in order of when the message was received. */ index: number; /** - * The channel specific identifier of the message\'s author. + * The channel specific identifier of the message\'s author. Defaults to `system`. */ author: string; /** - * The content of the message. + * The content of the message, can be up to 1,600 characters long. */ body: string; /** - * An array of objects that describe the Message\'s media if attached, otherwise, null. + * An array of objects that describe the Message\'s media, if the message contains media. Each object contains these fields: `content_type` with the MIME type of the media, `filename` with the name of the media, `sid` with the SID of the Media resource, and `size` with the media object\'s file size in bytes. If the Message has no media, this value is `null`. */ media: Array; /** - * A string metadata field you can use to store any data you wish. + * A string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set \"{}\" will be returned. */ attributes: string; /** - * The unique ID of messages\'s author participant. + * The unique ID of messages\'s author participant. Null in case of `system` sent message. */ participantSid: string; /** @@ -441,11 +441,11 @@ export class MessageInstance { */ dateCreated: Date; /** - * The date that this resource was last updated. + * The date that this resource was last updated. `null` if the message has not been edited. */ dateUpdated: Date; /** - * An absolute API URL for this message. + * An absolute API resource API URL for this message. */ url: string; /** @@ -453,11 +453,11 @@ export class MessageInstance { */ delivery: any; /** - * Absolute URL to access the receipts of this message. + * Contains an absolute API resource URL to access the delivery & read receipts of this message. */ links: Record; /** - * The unique ID of the multi-channel Rich Content template. + * The unique ID of the multi-channel [Rich Content](https://www.twilio.com/docs/content-api) template. */ contentSid: string; diff --git a/lib/rest/conversations/v1/conversation/message/deliveryReceipt.ts b/lib/rest/conversations/v1/conversation/message/deliveryReceipt.ts index a750a65582..62efd93111 100644 --- a/lib/rest/conversations/v1/conversation/message/deliveryReceipt.ts +++ b/lib/rest/conversations/v1/conversation/message/deliveryReceipt.ts @@ -204,11 +204,11 @@ export class DeliveryReceiptInstance { } /** - * The unique ID of the Account responsible for this participant. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this participant. */ accountSid: string; /** - * The unique ID of the Conversation for this message. + * The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this message. */ conversationSid: string; /** @@ -216,11 +216,11 @@ export class DeliveryReceiptInstance { */ sid: string; /** - * The SID of the message the delivery receipt belongs to + * The SID of the message within a [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) the delivery receipt belongs to */ messageSid: string; /** - * A messaging channel-specific identifier for the message delivered to participant + * A messaging channel-specific identifier for the message delivered to participant e.g. `SMxx` for SMS, `WAxx` for Whatsapp etc. */ channelMessageSid: string; /** @@ -229,7 +229,7 @@ export class DeliveryReceiptInstance { participantSid: string; status: ConversationMessageReceiptDeliveryStatus; /** - * The message [delivery error code](https://www.twilio.com/docs/sms/api/message-resource#delivery-related-errors) for a `failed` status + * The message [delivery error code](https://www.twilio.com/docs/sms/api/message-resource#delivery-related-errors) for a `failed` status, */ errorCode: number; /** @@ -237,11 +237,11 @@ export class DeliveryReceiptInstance { */ dateCreated: Date; /** - * The date that this resource was last updated. + * The date that this resource was last updated. `null` if the delivery receipt has not been updated. */ dateUpdated: Date; /** - * An absolute URL for this delivery receipt. + * An absolute API resource URL for this delivery receipt. */ url: string; diff --git a/lib/rest/conversations/v1/conversation/participant.ts b/lib/rest/conversations/v1/conversation/participant.ts index 758087d54c..e825d7e23b 100644 --- a/lib/rest/conversations/v1/conversation/participant.ts +++ b/lib/rest/conversations/v1/conversation/participant.ts @@ -391,11 +391,11 @@ export class ParticipantInstance { } /** - * The unique ID of the Account responsible for this participant. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this participant. */ accountSid: string; /** - * The unique ID of the Conversation for this participant. + * The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this participant. */ conversationSid: string; /** @@ -403,19 +403,19 @@ export class ParticipantInstance { */ sid: string; /** - * A unique string identifier for the conversation participant as Conversation User. + * A unique string identifier for the conversation participant as [Conversation User](https://www.twilio.com/docs/conversations/api/user-resource). This parameter is non-null if (and only if) the participant is using the Conversations SDK to communicate. Limited to 256 characters. */ identity: string; /** - * An optional string metadata field you can use to store any data you wish. + * An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set \"{}\" will be returned. */ attributes: string; /** - * Information about how this participant exchanges messages with the conversation. + * Information about how this participant exchanges messages with the conversation. A JSON parameter consisting of type and address fields of the participant. */ messagingBinding: any; /** - * The SID of a conversation-level Role to assign to the participant + * The SID of a conversation-level [Role](https://www.twilio.com/docs/conversations/api/role-resource) to assign to the participant. */ roleSid: string; /** @@ -427,15 +427,15 @@ export class ParticipantInstance { */ dateUpdated: Date; /** - * An absolute URL for this participant. + * An absolute API resource URL for this participant. */ url: string; /** - * Index of last “read” message in the Conversation for the Participant. + * Index of last “read” message in the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for the Participant. */ lastReadMessageIndex: number; /** - * Timestamp of last “read” message in the Conversation for the Participant. + * Timestamp of last “read” message in the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for the Participant. */ lastReadTimestamp: string; diff --git a/lib/rest/conversations/v1/conversation/webhook.ts b/lib/rest/conversations/v1/conversation/webhook.ts index 227d817420..86c3b40e45 100644 --- a/lib/rest/conversations/v1/conversation/webhook.ts +++ b/lib/rest/conversations/v1/conversation/webhook.ts @@ -331,23 +331,23 @@ export class WebhookInstance { */ sid: string; /** - * The unique ID of the Account responsible for this conversation. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation. */ accountSid: string; /** - * The unique ID of the Conversation for this webhook. + * The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this webhook. */ conversationSid: string; /** - * The target of this webhook. + * The target of this webhook: `webhook`, `studio`, `trigger` */ target: string; /** - * An absolute URL for this webhook. + * An absolute API resource URL for this webhook. */ url: string; /** - * The configuration of this webhook. + * The configuration of this webhook. Is defined based on target. */ configuration: any; /** diff --git a/lib/rest/conversations/v1/credential.ts b/lib/rest/conversations/v1/credential.ts index ac40db7587..e8bf4c8d83 100644 --- a/lib/rest/conversations/v1/credential.ts +++ b/lib/rest/conversations/v1/credential.ts @@ -320,16 +320,16 @@ export class CredentialInstance { */ sid: string; /** - * The unique ID of the Account responsible for this credential. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this credential. */ accountSid: string; /** - * The human-readable name of this credential. + * The human-readable name of this credential, limited to 64 characters. Optional. */ friendlyName: string; type: CredentialPushType; /** - * [APN only] Whether to send the credential to sandbox APNs. + * [APN only] Whether to send the credential to sandbox APNs. Can be `true` to send to sandbox APNs or `false` to send to production. */ sandbox: string; /** @@ -341,7 +341,7 @@ export class CredentialInstance { */ dateUpdated: Date; /** - * An absolute URL for this credential. + * An absolute API resource URL for this credential. */ url: string; diff --git a/lib/rest/conversations/v1/participantConversation.ts b/lib/rest/conversations/v1/participantConversation.ts index 269ca7838d..a480e06daf 100644 --- a/lib/rest/conversations/v1/participantConversation.ts +++ b/lib/rest/conversations/v1/participantConversation.ts @@ -313,64 +313,64 @@ export class ParticipantConversationInstance { } /** - * The unique ID of the Account responsible for this conversation. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation. */ accountSid: string; /** - * The unique ID of the Conversation Service this conversation belongs to. + * The unique ID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) this conversation belongs to. */ chatServiceSid: string; /** - * The unique ID of the Participant. + * The unique ID of the [Participant](https://www.twilio.com/docs/conversations/api/conversation-participant-resource). */ participantSid: string; /** - * The unique ID for the conversation participant as Conversation User. + * The unique string that identifies the conversation participant as [Conversation User](https://www.twilio.com/docs/conversations/api/user-resource). */ participantUserSid: string; /** - * A unique string identifier for the conversation participant as Conversation User. + * A unique string identifier for the conversation participant as [Conversation User](https://www.twilio.com/docs/conversations/api/user-resource). This parameter is non-null if (and only if) the participant is using the Conversations SDK to communicate. Limited to 256 characters. */ participantIdentity: string; /** - * Information about how this participant exchanges messages with the conversation. + * Information about how this participant exchanges messages with the conversation. A JSON parameter consisting of type and address fields of the participant. */ participantMessagingBinding: any; /** - * The unique ID of the Conversation this Participant belongs to. + * The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) this Participant belongs to. */ conversationSid: string; /** - * An application-defined string that uniquely identifies the Conversation resource + * An application-defined string that uniquely identifies the Conversation resource. */ conversationUniqueName: string; /** - * The human-readable name of this conversation. + * The human-readable name of this conversation, limited to 256 characters. Optional. */ conversationFriendlyName: string; /** - * An optional string metadata field you can use to store any data you wish. + * An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set \"{}\" will be returned. */ conversationAttributes: string; /** - * The date that this conversation was created. + * The date that this conversation was created, given in ISO 8601 format. */ conversationDateCreated: Date; /** - * The date that this conversation was last updated. + * The date that this conversation was last updated, given in ISO 8601 format. */ conversationDateUpdated: Date; /** - * Creator of this conversation. + * Identity of the creator of this Conversation. */ conversationCreatedBy: string; conversationState: ParticipantConversationState; /** - * Timer date values for this conversation. + * Timer date values representing state update for this conversation. */ conversationTimers: any; /** - * Absolute URLs to access the participant and conversation of this Participant Conversation. + * Contains absolute URLs to access the [participant](https://www.twilio.com/docs/conversations/api/conversation-participant-resource) and [conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) of this conversation. */ links: Record; diff --git a/lib/rest/conversations/v1/role.ts b/lib/rest/conversations/v1/role.ts index 5369267a0c..dc964cd2f8 100644 --- a/lib/rest/conversations/v1/role.ts +++ b/lib/rest/conversations/v1/role.ts @@ -265,36 +265,36 @@ export class RoleInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Role resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Role resource. */ accountSid: string; /** - * The SID of the Conversation Service that the resource is associated with + * The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) the Role resource is associated with. */ chatServiceSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; type: RoleRoleType; /** - * An array of the permissions the role has been granted + * An array of the permissions the role has been granted. */ permissions: Array; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * An absolute URL for this user role. + * An absolute API resource URL for this user role. */ url: string; diff --git a/lib/rest/conversations/v1/service.ts b/lib/rest/conversations/v1/service.ts index bde99972a8..b857d33c0a 100644 --- a/lib/rest/conversations/v1/service.ts +++ b/lib/rest/conversations/v1/service.ts @@ -253,7 +253,7 @@ export class ServiceInstance { } /** - * The unique ID of the Account responsible for this service. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this service. */ accountSid: string; /** @@ -261,7 +261,7 @@ export class ServiceInstance { */ sid: string; /** - * The human-readable name of this service. + * The human-readable name of this service, limited to 256 characters. Optional. */ friendlyName: string; /** @@ -273,11 +273,11 @@ export class ServiceInstance { */ dateUpdated: Date; /** - * An absolute URL for this service. + * An absolute API resource URL for this service. */ url: string; /** - * Absolute URLs to access the conversations, users, roles, bindings and configuration of this service. + * Contains absolute API resource URLs to access conversations, users, roles, bindings and configuration of this service. */ links: Record; diff --git a/lib/rest/conversations/v1/service/binding.ts b/lib/rest/conversations/v1/service/binding.ts index 6245efc9b2..ed12973bf8 100644 --- a/lib/rest/conversations/v1/service/binding.ts +++ b/lib/rest/conversations/v1/service/binding.ts @@ -228,15 +228,15 @@ export class BindingInstance { */ sid: string; /** - * The unique ID of the Account responsible for this binding. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this binding. */ accountSid: string; /** - * The SID of the Conversation Service that the resource is associated with. + * The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) the Binding resource is associated with. */ chatServiceSid: string; /** - * The SID of the Credential for the binding. + * The SID of the [Credential](https://www.twilio.com/docs/conversations/api/credential-resource) for the binding. See [push notification configuration](https://www.twilio.com/docs/chat/push-notification-configuration) for more info. */ credentialSid: string; /** @@ -248,20 +248,20 @@ export class BindingInstance { */ dateUpdated: Date; /** - * The unique endpoint identifier for the Binding. + * The unique endpoint identifier for the Binding. The format of this value depends on the `binding_type`. */ endpoint: string; /** - * The identity of Conversation User associated with this binding. + * The application-defined string that uniquely identifies the [Conversation User](https://www.twilio.com/docs/conversations/api/user-resource) within the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource). See [access tokens](https://www.twilio.com/docs/conversations/create-tokens) for more info. */ identity: string; bindingType: ServiceBindingBindingType; /** - * The Conversation message types the binding is subscribed to. + * The [Conversation message types](https://www.twilio.com/docs/chat/push-notification-configuration#push-types) the binding is subscribed to. */ messageTypes: Array; /** - * An absolute URL for this binding. + * An absolute API resource URL for this binding. */ url: string; diff --git a/lib/rest/conversations/v1/service/configuration.ts b/lib/rest/conversations/v1/service/configuration.ts index d19edda749..d12792fc19 100644 --- a/lib/rest/conversations/v1/service/configuration.ts +++ b/lib/rest/conversations/v1/service/configuration.ts @@ -222,31 +222,31 @@ export class ConfigurationInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Service configuration resource. */ chatServiceSid: string; /** - * The role assigned to a conversation creator user when they join a new conversation + * The conversation-level role assigned to a conversation creator user when they join a new conversation. See the [Conversation Role](https://www.twilio.com/docs/conversations/api/role-resource) for more info about roles. */ defaultConversationCreatorRoleSid: string; /** - * The role assigned to users when they are added to a conversation + * The conversation-level role assigned to users when they are added to a conversation. See the [Conversation Role](https://www.twilio.com/docs/conversations/api/role-resource) for more info about roles. */ defaultConversationRoleSid: string; /** - * The service role assigned to users when they are added to the service + * The service-level role assigned to users when they are added to the service. See the [Conversation Role](https://www.twilio.com/docs/conversations/api/role-resource) for more info about roles. */ defaultChatServiceRoleSid: string; /** - * An absolute URL for this service configuration. + * An absolute API resource URL for this service configuration. */ url: string; /** - * Absolute URL to access the push notifications configuration of this service. + * Contains an absolute API resource URL to access the push notifications configuration of this service. */ links: Record; /** - * Whether the Reachability Indicator feature is enabled for this Conversations Service + * Whether the [Reachability Indicator](https://www.twilio.com/docs/chat/reachability-indicator) is enabled for this Conversations Service. The default is `false`. */ reachabilityEnabled: boolean; diff --git a/lib/rest/conversations/v1/service/configuration/notification.ts b/lib/rest/conversations/v1/service/configuration/notification.ts index 7579819a17..3880882555 100644 --- a/lib/rest/conversations/v1/service/configuration/notification.ts +++ b/lib/rest/conversations/v1/service/configuration/notification.ts @@ -264,11 +264,11 @@ export class NotificationInstance { } /** - * The unique ID of the Account responsible for this configuration. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this configuration. */ accountSid: string; /** - * The SID of the Conversation Service that the Configuration applies to. + * The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) the Configuration applies to. */ chatServiceSid: string; /** @@ -288,7 +288,7 @@ export class NotificationInstance { */ logEnabled: boolean; /** - * An absolute URL for this configuration. + * An absolute API resource URL for this configuration. */ url: string; diff --git a/lib/rest/conversations/v1/service/configuration/webhook.ts b/lib/rest/conversations/v1/service/configuration/webhook.ts index 3137841706..7a4c74f02f 100644 --- a/lib/rest/conversations/v1/service/configuration/webhook.ts +++ b/lib/rest/conversations/v1/service/configuration/webhook.ts @@ -217,7 +217,7 @@ export class WebhookInstance { } /** - * The unique ID of the Account responsible for this service. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this service. */ accountSid: string; /** @@ -233,12 +233,12 @@ export class WebhookInstance { */ postWebhookUrl: string; /** - * The list of events that your configured webhook targets will receive. Events not configured here will not fire. + * The list of events that your configured webhook targets will receive. Events not configured here will not fire. Possible values are `onParticipantAdd`, `onParticipantAdded`, `onDeliveryUpdated`, `onConversationUpdated`, `onConversationRemove`, `onParticipantRemove`, `onConversationUpdate`, `onMessageAdd`, `onMessageRemoved`, `onParticipantUpdated`, `onConversationAdded`, `onMessageAdded`, `onConversationAdd`, `onConversationRemoved`, `onParticipantUpdate`, `onMessageRemove`, `onMessageUpdated`, `onParticipantRemoved`, `onMessageUpdate` or `onConversationStateUpdated`. */ filters: Array; method: ServiceWebhookConfigurationMethod; /** - * An absolute URL for this webhook. + * An absolute API resource URL for this webhook. */ url: string; diff --git a/lib/rest/conversations/v1/service/conversation.ts b/lib/rest/conversations/v1/service/conversation.ts index ef12203e1d..8bbf0f1e23 100644 --- a/lib/rest/conversations/v1/service/conversation.ts +++ b/lib/rest/conversations/v1/service/conversation.ts @@ -440,15 +440,15 @@ export class ConversationInstance { } /** - * The unique ID of the Account responsible for this conversation. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation. */ accountSid: string; /** - * The unique ID of the Conversation Service this conversation belongs to. + * The unique ID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) this conversation belongs to. */ chatServiceSid: string; /** - * The unique ID of the Messaging Service this conversation belongs to. + * The unique ID of the [Messaging Service](https://www.twilio.com/docs/sms/services/api) this conversation belongs to. */ messagingServiceSid: string; /** @@ -456,15 +456,15 @@ export class ConversationInstance { */ sid: string; /** - * The human-readable name of this conversation. + * The human-readable name of this conversation, limited to 256 characters. Optional. */ friendlyName: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource\'s `sid` in the URL. */ uniqueName: string; /** - * An optional string metadata field you can use to store any data you wish. + * An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set \"{}\" will be returned. */ attributes: string; state: ServiceConversationState; @@ -477,15 +477,15 @@ export class ConversationInstance { */ dateUpdated: Date; /** - * Timer date values for this conversation. + * Timer date values representing state update for this conversation. */ timers: any; /** - * An absolute URL for this conversation. + * An absolute API resource URL for this conversation. */ url: string; /** - * Absolute URLs to access the participants, messages and webhooks of this conversation. + * Contains absolute URLs to access the [participants](https://www.twilio.com/docs/conversations/api/conversation-participant-resource), [messages](https://www.twilio.com/docs/conversations/api/conversation-message-resource) and [webhooks](https://www.twilio.com/docs/conversations/api/conversation-scoped-webhook-resource) of this conversation. */ links: Record; bindings: any; diff --git a/lib/rest/conversations/v1/service/conversation/message.ts b/lib/rest/conversations/v1/service/conversation/message.ts index 1ec2e31541..6bf14b1a00 100644 --- a/lib/rest/conversations/v1/service/conversation/message.ts +++ b/lib/rest/conversations/v1/service/conversation/message.ts @@ -417,15 +417,15 @@ export class MessageInstance { } /** - * The unique ID of the Account responsible for this message. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this message. */ accountSid: string; /** - * The SID of the Conversation Service that the resource is associated with. + * The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) the Participant resource is associated with. */ chatServiceSid: string; /** - * The unique ID of the Conversation for this message. + * The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this message. */ conversationSid: string; /** @@ -433,27 +433,27 @@ export class MessageInstance { */ sid: string; /** - * The index of the message within the Conversation. + * The index of the message within the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource). */ index: number; /** - * The channel specific identifier of the message\'s author. + * The channel specific identifier of the message\'s author. Defaults to `system`. */ author: string; /** - * The content of the message. + * The content of the message, can be up to 1,600 characters long. */ body: string; /** - * An array of objects that describe the Message\'s media if attached, otherwise, null. + * An array of objects that describe the Message\'s media, if the message contains media. Each object contains these fields: `content_type` with the MIME type of the media, `filename` with the name of the media, `sid` with the SID of the Media resource, and `size` with the media object\'s file size in bytes. If the Message has no media, this value is `null`. */ media: Array; /** - * A string metadata field you can use to store any data you wish. + * A string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set \"{}\" will be returned. */ attributes: string; /** - * The unique ID of messages\'s author participant. + * The unique ID of messages\'s author participant. Null in case of `system` sent message. */ participantSid: string; /** @@ -461,7 +461,7 @@ export class MessageInstance { */ dateCreated: Date; /** - * The date that this resource was last updated. + * The date that this resource was last updated. `null` if the message has not been edited. */ dateUpdated: Date; /** @@ -469,15 +469,15 @@ export class MessageInstance { */ delivery: any; /** - * An absolute URL for this message. + * An absolute API resource URL for this message. */ url: string; /** - * Absolute URL to access the receipts of this message. + * Contains an absolute API resource URL to access the delivery & read receipts of this message. */ links: Record; /** - * The unique ID of the multi-channel Rich Content template. + * The unique ID of the multi-channel [Rich Content](https://www.twilio.com/docs/content-api) template. */ contentSid: string; diff --git a/lib/rest/conversations/v1/service/conversation/message/deliveryReceipt.ts b/lib/rest/conversations/v1/service/conversation/message/deliveryReceipt.ts index bfe0584c4c..92dc65ba19 100644 --- a/lib/rest/conversations/v1/service/conversation/message/deliveryReceipt.ts +++ b/lib/rest/conversations/v1/service/conversation/message/deliveryReceipt.ts @@ -219,19 +219,19 @@ export class DeliveryReceiptInstance { } /** - * The unique ID of the Account responsible for this participant. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this participant. */ accountSid: string; /** - * The SID of the Conversation Service that the resource is associated with. + * The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) the Message resource is associated with. */ chatServiceSid: string; /** - * The unique ID of the Conversation for this message. + * The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this message. */ conversationSid: string; /** - * The SID of the message the delivery receipt belongs to + * The SID of the message within a [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) the delivery receipt belongs to */ messageSid: string; /** @@ -239,7 +239,7 @@ export class DeliveryReceiptInstance { */ sid: string; /** - * A messaging channel-specific identifier for the message delivered to participant + * A messaging channel-specific identifier for the message delivered to participant e.g. `SMxx` for SMS, `WAxx` for Whatsapp etc. */ channelMessageSid: string; /** @@ -248,7 +248,7 @@ export class DeliveryReceiptInstance { participantSid: string; status: ServiceConversationMessageReceiptDeliveryStatus; /** - * The message [delivery error code](https://www.twilio.com/docs/sms/api/message-resource#delivery-related-errors) for a `failed` status + * The message [delivery error code](https://www.twilio.com/docs/sms/api/message-resource#delivery-related-errors) for a `failed` status, */ errorCode: number; /** @@ -256,11 +256,11 @@ export class DeliveryReceiptInstance { */ dateCreated: Date; /** - * The date that this resource was last updated. + * The date that this resource was last updated. `null` if the delivery receipt has not been updated. */ dateUpdated: Date; /** - * An absolute URL for this delivery receipt. + * An absolute API resource URL for this delivery receipt. */ url: string; diff --git a/lib/rest/conversations/v1/service/conversation/participant.ts b/lib/rest/conversations/v1/service/conversation/participant.ts index 04b75f6603..e3a558eb40 100644 --- a/lib/rest/conversations/v1/service/conversation/participant.ts +++ b/lib/rest/conversations/v1/service/conversation/participant.ts @@ -406,15 +406,15 @@ export class ParticipantInstance { } /** - * The unique ID of the Account responsible for this participant. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this participant. */ accountSid: string; /** - * The SID of the Conversation Service that the resource is associated with. + * The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) the Participant resource is associated with. */ chatServiceSid: string; /** - * The unique ID of the Conversation for this participant. + * The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this participant. */ conversationSid: string; /** @@ -422,19 +422,19 @@ export class ParticipantInstance { */ sid: string; /** - * A unique string identifier for the conversation participant as Conversation User. + * A unique string identifier for the conversation participant as [Conversation User](https://www.twilio.com/docs/conversations/api/user-resource). This parameter is non-null if (and only if) the participant is using the Conversation SDK to communicate. Limited to 256 characters. */ identity: string; /** - * An optional string metadata field you can use to store any data you wish. + * An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set \"{}\" will be returned. */ attributes: string; /** - * Information about how this participant exchanges messages with the conversation. + * Information about how this participant exchanges messages with the conversation. A JSON parameter consisting of type and address fields of the participant. */ messagingBinding: any; /** - * The SID of a conversation-level Role to assign to the participant + * The SID of a conversation-level [Role](https://www.twilio.com/docs/conversations/api/role-resource) to assign to the participant. */ roleSid: string; /** @@ -446,15 +446,15 @@ export class ParticipantInstance { */ dateUpdated: Date; /** - * An absolute URL for this participant. + * An absolute API resource URL for this participant. */ url: string; /** - * Index of last “read” message in the Conversation for the Participant. + * Index of last “read” message in the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for the Participant. */ lastReadMessageIndex: number; /** - * Timestamp of last “read” message in the Conversation for the Participant. + * Timestamp of last “read” message in the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for the Participant. */ lastReadTimestamp: string; diff --git a/lib/rest/conversations/v1/service/conversation/webhook.ts b/lib/rest/conversations/v1/service/conversation/webhook.ts index c3f054c45d..9fadcd602a 100644 --- a/lib/rest/conversations/v1/service/conversation/webhook.ts +++ b/lib/rest/conversations/v1/service/conversation/webhook.ts @@ -346,27 +346,27 @@ export class WebhookInstance { */ sid: string; /** - * The unique ID of the Account responsible for this conversation. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation. */ accountSid: string; /** - * The SID of the Conversation Service that the resource is associated with. + * The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) the Participant resource is associated with. */ chatServiceSid: string; /** - * The unique ID of the Conversation for this webhook. + * The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this webhook. */ conversationSid: string; /** - * The target of this webhook. + * The target of this webhook: `webhook`, `studio`, `trigger` */ target: string; /** - * An absolute URL for this webhook. + * An absolute API resource URL for this webhook. */ url: string; /** - * The configuration of this webhook. + * The configuration of this webhook. Is defined based on target. */ configuration: any; /** diff --git a/lib/rest/conversations/v1/service/participantConversation.ts b/lib/rest/conversations/v1/service/participantConversation.ts index 32c12975fd..64538db903 100644 --- a/lib/rest/conversations/v1/service/participantConversation.ts +++ b/lib/rest/conversations/v1/service/participantConversation.ts @@ -321,31 +321,31 @@ export class ParticipantConversationInstance { } /** - * The unique ID of the Account responsible for this conversation. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation. */ accountSid: string; /** - * The unique ID of the Conversation Service this conversation belongs to. + * The unique ID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) this conversation belongs to. */ chatServiceSid: string; /** - * The unique ID of the Participant. + * The unique ID of the [Participant](https://www.twilio.com/docs/conversations/api/conversation-participant-resource). */ participantSid: string; /** - * The unique ID for the conversation participant as Conversation User. + * The unique string that identifies the conversation participant as [Conversation User](https://www.twilio.com/docs/conversations/api/user-resource). */ participantUserSid: string; /** - * A unique string identifier for the conversation participant as Conversation User. + * A unique string identifier for the conversation participant as [Conversation User](https://www.twilio.com/docs/conversations/api/user-resource). This parameter is non-null if (and only if) the participant is using the Conversations SDK to communicate. Limited to 256 characters. */ participantIdentity: string; /** - * Information about how this participant exchanges messages with the conversation. + * Information about how this participant exchanges messages with the conversation. A JSON parameter consisting of type and address fields of the participant. */ participantMessagingBinding: any; /** - * The unique ID of the Conversation this Participant belongs to. + * The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) this Participant belongs to. */ conversationSid: string; /** @@ -353,32 +353,32 @@ export class ParticipantConversationInstance { */ conversationUniqueName: string; /** - * The human-readable name of this conversation. + * The human-readable name of this conversation, limited to 256 characters. Optional. */ conversationFriendlyName: string; /** - * An optional string metadata field you can use to store any data you wish. + * An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set \"{}\" will be returned. */ conversationAttributes: string; /** - * The date that this conversation was created. + * The date that this conversation was created, given in ISO 8601 format. */ conversationDateCreated: Date; /** - * The date that this conversation was last updated. + * The date that this conversation was last updated, given in ISO 8601 format. */ conversationDateUpdated: Date; /** - * Creator of this conversation. + * Identity of the creator of this Conversation. */ conversationCreatedBy: string; conversationState: ServiceParticipantConversationState; /** - * Timer date values for this conversation. + * Timer date values representing state update for this conversation. */ conversationTimers: any; /** - * Absolute URLs to access the participant and conversation of this Participant Conversation. + * Contains absolute URLs to access the [participant](https://www.twilio.com/docs/conversations/api/conversation-participant-resource) and [conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) of this conversation. */ links: Record; diff --git a/lib/rest/conversations/v1/service/role.ts b/lib/rest/conversations/v1/service/role.ts index f8f25f2256..3786fa2cb5 100644 --- a/lib/rest/conversations/v1/service/role.ts +++ b/lib/rest/conversations/v1/service/role.ts @@ -285,36 +285,36 @@ export class RoleInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Role resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Role resource. */ accountSid: string; /** - * The SID of the Conversation Service that the resource is associated with + * The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) the Role resource is associated with. */ chatServiceSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; type: ServiceRoleRoleType; /** - * An array of the permissions the role has been granted + * An array of the permissions the role has been granted. */ permissions: Array; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * An absolute URL for this user role. + * An absolute API resource URL for this user role. */ url: string; diff --git a/lib/rest/conversations/v1/service/user.ts b/lib/rest/conversations/v1/service/user.ts index 9f6b192481..f22a00a5b2 100644 --- a/lib/rest/conversations/v1/service/user.ts +++ b/lib/rest/conversations/v1/service/user.ts @@ -374,51 +374,51 @@ export class UserInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the User resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the User resource. */ accountSid: string; /** - * The SID of the Conversation Service that the resource is associated with + * The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) the User resource is associated with. */ chatServiceSid: string; /** - * The SID of a service-level Role assigned to the user + * The SID of a service-level [Role](https://www.twilio.com/docs/conversations/api/role-resource) assigned to the user. */ roleSid: string; /** - * The string that identifies the resource\'s User + * The application-defined string that uniquely identifies the resource\'s User within the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource). This value is often a username or an email address, and is case-sensitive. */ identity: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The JSON Object string that stores application-specific data + * The JSON Object string that stores application-specific data. If attributes have not been set, `{}` is returned. */ attributes: string; /** - * Whether the User is actively connected to this Conversations Service and online + * Whether the User is actively connected to this Conversations Service and online. This value is only returned by Fetch actions that return a single resource and `null` is always returned by a Read action. This value is `null` if the Service\'s `reachability_enabled` is `false`, if the User has never been online for this Conversations Service, even if the Service\'s `reachability_enabled` is `true`. */ isOnline: boolean; /** - * Whether the User has a potentially valid Push Notification registration for this Conversations Service + * Whether the User has a potentially valid Push Notification registration (APN or GCM) for this Conversations Service. If at least one registration exists, `true`; otherwise `false`. This value is only returned by Fetch actions that return a single resource and `null` is always returned by a Read action. This value is `null` if the Service\'s `reachability_enabled` is `false`, and if the User has never had a notification registration, even if the Service\'s `reachability_enabled` is `true`. */ isNotifiable: boolean; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * An absolute URL for this user. + * An absolute API resource URL for this user. */ url: string; links: Record; diff --git a/lib/rest/conversations/v1/service/user/userConversation.ts b/lib/rest/conversations/v1/service/user/userConversation.ts index 613febaca9..62193a3c2d 100644 --- a/lib/rest/conversations/v1/service/user/userConversation.ts +++ b/lib/rest/conversations/v1/service/user/userConversation.ts @@ -339,66 +339,66 @@ export class UserConversationInstance { } /** - * The unique ID of the Account responsible for this conversation. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation. */ accountSid: string; /** - * The unique ID of the Conversation Service this conversation belongs to. + * The unique ID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) this conversation belongs to. */ chatServiceSid: string; /** - * The unique ID of the Conversation for this User Conversation. + * The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this User Conversation. */ conversationSid: string; /** - * The number of unread Messages in the Conversation. + * The number of unread Messages in the Conversation for the Participant. */ unreadMessagesCount: number; /** - * The index of the last read Message . + * The index of the last Message in the Conversation that the Participant has read. */ lastReadMessageIndex: number; /** - * Participant Sid. + * The unique ID of the [participant](https://www.twilio.com/docs/conversations/api/conversation-participant-resource) the user conversation belongs to. */ participantSid: string; /** - * The unique ID for the User. + * The unique string that identifies the [User resource](https://www.twilio.com/docs/conversations/api/user-resource). */ userSid: string; /** - * The human-readable name of this conversation. + * The human-readable name of this conversation, limited to 256 characters. Optional. */ friendlyName: string; conversationState: ServiceUserConversationState; /** - * Timer date values for this conversation. + * Timer date values representing state update for this conversation. */ timers: any; /** - * An optional string metadata field you can use to store any data you wish. + * An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set \"{}\" will be returned. */ attributes: string; /** - * The date that this conversation was created. + * The date that this conversation was created, given in ISO 8601 format. */ dateCreated: Date; /** - * The date that this conversation was last updated. + * The date that this conversation was last updated, given in ISO 8601 format. */ dateUpdated: Date; /** - * Creator of this conversation. + * Identity of the creator of this Conversation. */ createdBy: string; notificationLevel: ServiceUserConversationNotificationLevel; /** - * An application-defined string that uniquely identifies the Conversation resource. + * An application-defined string that uniquely identifies the Conversation resource. It can be used to address the resource in place of the resource\'s `conversation_sid` in the URL. */ uniqueName: string; url: string; /** - * Absolute URLs to access the participant and conversation of this user conversation. + * Contains absolute URLs to access the [participant](https://www.twilio.com/docs/conversations/api/conversation-participant-resource) and [conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) of this conversation. */ links: Record; diff --git a/lib/rest/conversations/v1/user.ts b/lib/rest/conversations/v1/user.ts index 51667a2c12..74aa35a574 100644 --- a/lib/rest/conversations/v1/user.ts +++ b/lib/rest/conversations/v1/user.ts @@ -350,51 +350,51 @@ export class UserInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the User resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the User resource. */ accountSid: string; /** - * The SID of the Conversation Service that the resource is associated with + * The SID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) the User resource is associated with. */ chatServiceSid: string; /** - * The SID of a service-level Role assigned to the user + * The SID of a service-level [Role](https://www.twilio.com/docs/conversations/api/role-resource) assigned to the user. */ roleSid: string; /** - * The string that identifies the resource\'s User + * The application-defined string that uniquely identifies the resource\'s User within the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource). This value is often a username or an email address, and is case-sensitive. */ identity: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The JSON Object string that stores application-specific data + * The JSON Object string that stores application-specific data. If attributes have not been set, `{}` is returned. */ attributes: string; /** - * Whether the User is actively connected to this Conversations Service and online + * Whether the User is actively connected to this Conversations Service and online. This value is only returned by Fetch actions that return a single resource and `null` is always returned by a Read action. This value is `null` if the Service\'s `reachability_enabled` is `false`, if the User has never been online for this Conversations Service, even if the Service\'s `reachability_enabled` is `true`. */ isOnline: boolean; /** - * Whether the User has a potentially valid Push Notification registration for this Conversations Service + * Whether the User has a potentially valid Push Notification registration (APN or GCM) for this Conversations Service. If at least one registration exists, `true`; otherwise `false`. This value is only returned by Fetch actions that return a single resource and `null` is always returned by a Read action. This value is `null` if the Service\'s `reachability_enabled` is `false`, and if the User has never had a notification registration, even if the Service\'s `reachability_enabled` is `true`. */ isNotifiable: boolean; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * An absolute URL for this user. + * An absolute API resource URL for this user. */ url: string; links: Record; diff --git a/lib/rest/conversations/v1/user/userConversation.ts b/lib/rest/conversations/v1/user/userConversation.ts index 9cd986cd81..25f6d73a56 100644 --- a/lib/rest/conversations/v1/user/userConversation.ts +++ b/lib/rest/conversations/v1/user/userConversation.ts @@ -329,66 +329,66 @@ export class UserConversationInstance { } /** - * The unique ID of the Account responsible for this conversation. + * The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation. */ accountSid: string; /** - * The unique ID of the Conversation Service this conversation belongs to. + * The unique ID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) this conversation belongs to. */ chatServiceSid: string; /** - * The unique ID of the Conversation for this User Conversation. + * The unique ID of the [Conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) for this User Conversation. */ conversationSid: string; /** - * The number of unread Messages in the Conversation. + * The number of unread Messages in the Conversation for the Participant. */ unreadMessagesCount: number; /** - * The index of the last read Message . + * The index of the last Message in the Conversation that the Participant has read. */ lastReadMessageIndex: number; /** - * Participant Sid. + * The unique ID of the [participant](https://www.twilio.com/docs/conversations/api/conversation-participant-resource) the user conversation belongs to. */ participantSid: string; /** - * The unique ID for the User. + * The unique string that identifies the [User resource](https://www.twilio.com/docs/conversations/api/user-resource). */ userSid: string; /** - * The human-readable name of this conversation. + * The human-readable name of this conversation, limited to 256 characters. Optional. */ friendlyName: string; conversationState: UserConversationState; /** - * Timer date values for this conversation. + * Timer date values representing state update for this conversation. */ timers: any; /** - * An optional string metadata field you can use to store any data you wish. + * An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set \"{}\" will be returned. */ attributes: string; /** - * The date that this conversation was created. + * The date that this conversation was created, given in ISO 8601 format. */ dateCreated: Date; /** - * The date that this conversation was last updated. + * The date that this conversation was last updated, given in ISO 8601 format. */ dateUpdated: Date; /** - * Creator of this conversation. + * Identity of the creator of this Conversation. */ createdBy: string; notificationLevel: UserConversationNotificationLevel; /** - * An application-defined string that uniquely identifies the Conversation resource. + * An application-defined string that uniquely identifies the Conversation resource. It can be used to address the resource in place of the resource\'s `conversation_sid` in the URL. */ uniqueName: string; url: string; /** - * Absolute URLs to access the participant and conversation of this user conversation. + * Contains absolute URLs to access the [participant](https://www.twilio.com/docs/conversations/api/conversation-participant-resource) and [conversation](https://www.twilio.com/docs/conversations/api/conversation-resource) of this conversation. */ links: Record; diff --git a/lib/rest/events/v1/eventType.ts b/lib/rest/events/v1/eventType.ts index b07bf48d78..ec9cc6f623 100644 --- a/lib/rest/events/v1/eventType.ts +++ b/lib/rest/events/v1/eventType.ts @@ -173,23 +173,23 @@ export class EventTypeInstance { } /** - * The Event Type identifier. + * A string that uniquely identifies this Event Type. */ type: string; /** - * The Schema identifier for this Event Type. + * A string that uniquely identifies the Schema this Event Type adheres to. */ schemaId: string; /** - * The date this Event Type was created. + * The date that this Event Type was created, given in ISO 8601 format. */ dateCreated: Date; /** - * The date this Event Type was updated. + * The date that this Event Type was updated, given in ISO 8601 format. */ dateUpdated: Date; /** - * Event Type description. + * A human readable description for this Event Type. */ description: string; /** diff --git a/lib/rest/events/v1/schema.ts b/lib/rest/events/v1/schema.ts index be0e98dca8..8c9a857cda 100644 --- a/lib/rest/events/v1/schema.ts +++ b/lib/rest/events/v1/schema.ts @@ -129,7 +129,7 @@ export class SchemaInstance { } /** - * Schema Identifier. + * The unique identifier of the schema. Each schema can have multiple versions, that share the same id. */ id: string; /** @@ -137,15 +137,15 @@ export class SchemaInstance { */ url: string; /** - * Nested resource URLs. + * Contains a dictionary of URL links to nested resources of this schema. */ links: Record; /** - * The date that the latest schema version was created. + * The date that the latest schema version was created, given in ISO 8601 format. */ latestVersionDateCreated: Date; /** - * Latest schema version. + * The latest version published of this schema. */ latestVersion: number; diff --git a/lib/rest/events/v1/schema/schemaVersion.ts b/lib/rest/events/v1/schema/schemaVersion.ts index e64ea3c6b8..2f3c9ab789 100644 --- a/lib/rest/events/v1/schema/schemaVersion.ts +++ b/lib/rest/events/v1/schema/schemaVersion.ts @@ -170,7 +170,7 @@ export class SchemaVersionInstance { } /** - * The unique identifier of the schema. + * The unique identifier of the schema. Each schema can have multiple versions, that share the same id. */ id: string; /** @@ -178,7 +178,7 @@ export class SchemaVersionInstance { */ schemaVersion: number; /** - * The date the schema version was created. + * The date the schema version was created, given in ISO 8601 format. */ dateCreated: Date; /** diff --git a/lib/rest/events/v1/sink.ts b/lib/rest/events/v1/sink.ts index 986fe4b5d7..f02161ea67 100644 --- a/lib/rest/events/v1/sink.ts +++ b/lib/rest/events/v1/sink.ts @@ -300,23 +300,23 @@ export class SinkInstance { } /** - * The date this Sink was created + * The date that this Sink was created, given in ISO 8601 format. */ dateCreated: Date; /** - * The date this Sink was updated + * The date that this Sink was updated, given in ISO 8601 format. */ dateUpdated: Date; /** - * Sink Description + * A human readable description for the Sink */ description: string; /** - * A string that uniquely identifies this Sink. + * A 34 character string that uniquely identifies this Sink. */ sid: string; /** - * JSON Sink configuration. + * The information required for Twilio to connect to the provided Sink encoded as JSON. */ sinkConfiguration: any; sinkType: SinkSinkType; @@ -326,7 +326,7 @@ export class SinkInstance { */ url: string; /** - * Nested resource URLs. + * Contains a dictionary of URL links to nested resources of this Sink. */ links: Record; diff --git a/lib/rest/events/v1/subscription.ts b/lib/rest/events/v1/subscription.ts index 515fe5608b..4d9a919587 100644 --- a/lib/rest/events/v1/subscription.ts +++ b/lib/rest/events/v1/subscription.ts @@ -306,27 +306,27 @@ export class SubscriptionInstance { } /** - * Account SID. + * The unique SID identifier of the Account. */ accountSid: string; /** - * A string that uniquely identifies this Subscription. + * A 34 character string that uniquely identifies this Subscription. */ sid: string; /** - * The date this Subscription was created + * The date that this Subscription was created, given in ISO 8601 format. */ dateCreated: Date; /** - * The date this Subscription was updated + * The date that this Subscription was updated, given in ISO 8601 format. */ dateUpdated: Date; /** - * Subscription description + * A human readable description for the Subscription */ description: string; /** - * Sink SID. + * The SID of the sink that events selected by this subscription should be sent to. Sink must be active for the subscription to be created. */ sinkSid: string; /** @@ -334,7 +334,7 @@ export class SubscriptionInstance { */ url: string; /** - * Nested resource URLs. + * Contains a dictionary of URL links to nested resources of this Subscription. */ links: Record; diff --git a/lib/rest/events/v1/subscription/subscribedEvent.ts b/lib/rest/events/v1/subscription/subscribedEvent.ts index 94a1d2d551..42f3ba886f 100644 --- a/lib/rest/events/v1/subscription/subscribedEvent.ts +++ b/lib/rest/events/v1/subscription/subscribedEvent.ts @@ -288,7 +288,7 @@ export class SubscribedEventInstance { } /** - * Account SID. + * The unique SID identifier of the Account. */ accountSid: string; /** @@ -300,7 +300,7 @@ export class SubscribedEventInstance { */ schemaVersion: number; /** - * Subscription SID. + * The unique SID identifier of the Subscription. */ subscriptionSid: string; /** diff --git a/lib/rest/flexApi/v1/channel.ts b/lib/rest/flexApi/v1/channel.ts index b30f08badb..1adc94bbb4 100644 --- a/lib/rest/flexApi/v1/channel.ts +++ b/lib/rest/flexApi/v1/channel.ts @@ -214,35 +214,35 @@ export class ChannelInstance { } /** - * The SID of the Account that created the resource and owns this Workflow + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Channel resource and owns this Workflow. */ accountSid: string; /** - * The SID of the Flex Flow + * The SID of the Flex Flow. */ flexFlowSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Channel resource. */ sid: string; /** - * The SID of the chat user + * The SID of the chat user. */ userSid: string; /** - * The SID of the TaskRouter Task + * The SID of the TaskRouter Task. Only valid when integration type is `task`. `null` for integration types `studio` & `external` */ taskSid: string; /** - * The absolute URL of the Flex chat channel resource + * The absolute URL of the Flex chat channel resource. */ url: string; /** - * The ISO 8601 date and time in GMT when the Flex chat channel was created + * The date and time in GMT when the Flex chat channel was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the Flex chat channel was last updated + * The date and time in GMT when the Flex chat channel was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; diff --git a/lib/rest/flexApi/v1/configuration.ts b/lib/rest/flexApi/v1/configuration.ts index 15ff9dc67d..115ef5ed2f 100644 --- a/lib/rest/flexApi/v1/configuration.ts +++ b/lib/rest/flexApi/v1/configuration.ts @@ -229,164 +229,164 @@ export class ConfigurationInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Configuration resource. */ accountSid: string; /** - * The ISO 8601 date and time in GMT when the Configuration resource was created + * The date and time in GMT when the Configuration resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the Configuration resource was last updated + * The date and time in GMT when the Configuration resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * An object that contains application-specific data + * An object that contains application-specific data. */ attributes: any; status: ConfigurationStatus; /** - * The SID of the TaskRouter Workspace + * The SID of the TaskRouter Workspace. */ taskrouterWorkspaceSid: string; /** - * The SID of the TaskRouter target Workflow + * The SID of the TaskRouter target Workflow. */ taskrouterTargetWorkflowSid: string; /** - * The SID of the TaskRouter Target TaskQueue + * The SID of the TaskRouter Target TaskQueue. */ taskrouterTargetTaskqueueSid: string; /** - * The list of TaskRouter TaskQueues + * The list of TaskRouter TaskQueues. */ taskrouterTaskqueues: Array; /** - * The Skill description for TaskRouter workers + * The Skill description for TaskRouter workers. */ taskrouterSkills: Array; /** - * The TaskRouter default channel capacities and availability for workers + * The TaskRouter default channel capacities and availability for workers. */ taskrouterWorkerChannels: any; /** - * The TaskRouter Worker attributes + * The TaskRouter Worker attributes. */ taskrouterWorkerAttributes: any; /** - * The TaskRouter SID of the offline activity + * The TaskRouter SID of the offline activity. */ taskrouterOfflineActivitySid: string; /** - * The URL where the Flex instance is hosted + * The URL where the Flex instance is hosted. */ runtimeDomain: string; /** - * The SID of the Messaging service instance + * The SID of the Messaging service instance. */ messagingServiceInstanceSid: string; /** - * The SID of the chat service this user belongs to + * The SID of the chat service this user belongs to. */ chatServiceInstanceSid: string; /** - * The SID of the Flex service instance + * The SID of the Flex service instance. */ flexServiceInstanceSid: string; /** - * The primary language of the Flex UI + * The primary language of the Flex UI. */ uiLanguage: string; /** - * The object that describes Flex UI characteristics and settings + * The object that describes Flex UI characteristics and settings. */ uiAttributes: any; /** - * The object that defines the NPM packages and versions to be used in Hosted Flex + * The object that defines the NPM packages and versions to be used in Hosted Flex. */ uiDependencies: any; /** - * The Pinned UI version + * The Pinned UI version. */ uiVersion: string; /** - * The Flex Service version + * The Flex Service version. */ serviceVersion: string; /** - * Whether call recording is enabled + * Whether call recording is enabled. */ callRecordingEnabled: boolean; /** - * The call recording webhook URL + * The call recording webhook URL. */ callRecordingWebhookUrl: string; /** - * Whether CRM is present for Flex + * Whether CRM is present for Flex. */ crmEnabled: boolean; /** - * The CRM Type + * The CRM type. */ crmType: string; /** - * The CRM Callback URL + * The CRM Callback URL. */ crmCallbackUrl: string; /** - * The CRM Fallback URL + * The CRM Fallback URL. */ crmFallbackUrl: string; /** - * An object that contains the CRM attributes + * An object that contains the CRM attributes. */ crmAttributes: any; /** - * The list of public attributes + * The list of public attributes, which are visible to unauthenticated clients. */ publicAttributes: any; /** - * Whether the plugin service enabled + * Whether the plugin service enabled. */ pluginServiceEnabled: boolean; /** - * The plugin service attributes + * The plugin service attributes. */ pluginServiceAttributes: any; /** - * A list of objects that contain the configurations for the Integrations supported in this configuration + * A list of objects that contain the configurations for the Integrations supported in this configuration. */ integrations: Array; /** - * The list of outbound call flows + * The list of outbound call flows. */ outboundCallFlows: any; /** - * The list of serverless service SIDs + * The list of serverless service SIDs. */ serverlessServiceSids: Array; /** - * Configurable parameters for Queues Statistics + * Configurable parameters for Queues Statistics. */ queueStatsConfiguration: any; /** - * Configurable parameters for Notifications + * Configurable parameters for Notifications. */ notifications: any; /** - * Configurable parameters for Markdown + * Configurable parameters for Markdown. */ markdown: any; /** - * The absolute URL of the Configuration resource + * The absolute URL of the Configuration resource. */ url: string; /** - * Object that controls workspace reporting + * Object with enabled/disabled flag with list of workspaces. */ flexInsightsHr: any; /** - * Setting to enable Flex UI redirection + * Setting this to true will redirect Flex UI to the URL set in flex_url */ flexInsightsDrilldown: boolean; /** @@ -394,15 +394,15 @@ export class ConfigurationInstance { */ flexUrl: string; /** - * Flex Conversations channels\' attachments configurations + * Settings for different limits for Flex Conversations channels attachments. */ channelConfigs: Array; /** - * Configurable parameters for Debugger Integration + * Configurable parameters for Debugger Integration. */ debuggerIntegration: any; /** - * Configurable parameters for Flex UI Status report + * Configurable parameters for Flex UI Status report. */ flexUiStatusReport: any; diff --git a/lib/rest/flexApi/v1/flexFlow.ts b/lib/rest/flexApi/v1/flexFlow.ts index 52daf5b45f..44ff96a447 100644 --- a/lib/rest/flexApi/v1/flexFlow.ts +++ b/lib/rest/flexApi/v1/flexFlow.ts @@ -395,53 +395,53 @@ export class FlexFlowInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Flex Flow resource and owns this Workflow. */ accountSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Flex Flow resource. */ sid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The SID of the chat service + * The SID of the chat service. */ chatServiceSid: string; channelType: FlexFlowChannelType; /** - * The channel contact\'s Identity + * The channel contact\'s Identity. */ contactIdentity: string; /** - * Whether the Flex Flow is enabled + * Whether the Flex Flow is enabled. */ enabled: boolean; integrationType: FlexFlowIntegrationType; /** - * An object that contains specific parameters for the integration + * An object that contains specific parameters for the integration. */ integration: any; /** - * Re-use this chat channel for future interactions with a contact + * When enabled, Flex will keep the chat channel active so that it may be used for subsequent interactions with a contact identity. Defaults to `false`. */ longLived: boolean; /** - * Remove active Proxy sessions if the corresponding Task is deleted. + * When enabled, the Messaging Channel Janitor will remove active Proxy sessions if the associated Task is deleted outside of the Flex UI. Defaults to `false`. */ janitorEnabled: boolean; /** - * The absolute URL of the Flex Flow resource + * The absolute URL of the Flex Flow resource. */ url: string; diff --git a/lib/rest/flexApi/v1/goodData.ts b/lib/rest/flexApi/v1/goodData.ts index 42fac8ca56..3552fe000d 100644 --- a/lib/rest/flexApi/v1/goodData.ts +++ b/lib/rest/flexApi/v1/goodData.ts @@ -149,15 +149,15 @@ export class GoodDataInstance { */ workspaceId: string; /** - * The session expiry date and time + * The session expiry date and time, given in ISO 8601 format. */ sessionExpiry: string; /** - * Unique session ID + * The unique ID for the session */ sessionId: string; /** - * Base URL to fetch reports and dashboards + * The base URL to fetch reports and dashboards */ baseUrl: string; /** diff --git a/lib/rest/flexApi/v1/interaction.ts b/lib/rest/flexApi/v1/interaction.ts index c635957cd4..27ed8b55fe 100644 --- a/lib/rest/flexApi/v1/interaction.ts +++ b/lib/rest/flexApi/v1/interaction.ts @@ -145,15 +145,15 @@ export class InteractionInstance { } /** - * The unique string that identifies the resource + * The unique string created by Twilio to identify an Interaction resource, prefixed with KD. */ sid: string; /** - * The Interaction\'s channel + * A JSON object that defines the Interaction’s communication channel and includes details about the channel. See the [Outbound SMS](https://www.twilio.com/docs/flex/developer/conversations/interactions-api/interactions#agent-initiated-outbound-interactions) and [inbound (API-initiated)](https://www.twilio.com/docs/flex/developer/conversations/interactions-api/interactions#api-initiated-contact) Channel object examples. */ channel: any; /** - * A JSON Object representing the routing rules for the Interaction Channel + * A JSON Object representing the routing rules for the Interaction Channel. See [Outbound SMS Example](https://www.twilio.com/docs/flex/developer/conversations/interactions-api/interactions#agent-initiated-outbound-interactions) for an example Routing object. The Interactions resource uses TaskRouter for all routing functionality. All attributes in the Routing object on your Interaction request body are added “as is” to the task. For a list of known attributes consumed by the Flex UI and/or Flex Insights, see [Known Task Attributes](https://www.twilio.com/docs/flex/developer/conversations/interactions-api#task-attributes). */ routing: any; url: string; diff --git a/lib/rest/flexApi/v1/interaction/interactionChannel.ts b/lib/rest/flexApi/v1/interaction/interactionChannel.ts index 01eafe10c4..4556a4c155 100644 --- a/lib/rest/flexApi/v1/interaction/interactionChannel.ts +++ b/lib/rest/flexApi/v1/interaction/interactionChannel.ts @@ -294,11 +294,11 @@ export class InteractionChannelInstance { } /** - * The unique string that identifies the resource + * The unique string created by Twilio to identify an Interaction Channel resource, prefixed with UO. */ sid: string; /** - * The unique string that identifies the resource. + * The unique string created by Twilio to identify an Interaction resource, prefixed with KD. */ interactionSid: string; type: InteractionChannelType; diff --git a/lib/rest/flexApi/v1/interaction/interactionChannel/interactionChannelInvite.ts b/lib/rest/flexApi/v1/interaction/interactionChannel/interactionChannelInvite.ts index e8383db3a2..5038977629 100644 --- a/lib/rest/flexApi/v1/interaction/interactionChannel/interactionChannelInvite.ts +++ b/lib/rest/flexApi/v1/interaction/interactionChannel/interactionChannelInvite.ts @@ -356,19 +356,19 @@ export class InteractionChannelInviteInstance { } /** - * The unique string that identifies the resource + * The unique string created by Twilio to identify an Interaction Channel Invite resource. */ sid: string; /** - * The Interaction SID for this Channel + * The Interaction SID for this Channel. */ interactionSid: string; /** - * The Channel SID for this Invite + * The Channel SID for this Invite. */ channelSid: string; /** - * A JSON object representing the routing rules for the Interaction Channel + * A JSON object representing the routing rules for the Interaction Channel. See [Outbound SMS Example](https://www.twilio.com/docs/flex/developer/conversations/interactions-api/interactions#agent-initiated-outbound-interactions) for an example Routing object. The Interactions resource uses TaskRouter for all routing functionality. All attributes in the Routing object on your Interaction request body are added “as is” to the task. For a list of known attributes consumed by the Flex UI and/or Flex Insights, see [Known Task Attributes](https://www.twilio.com/docs/flex/developer/conversations/interactions-api#task-attributes). */ routing: any; url: string; diff --git a/lib/rest/flexApi/v1/interaction/interactionChannel/interactionChannelParticipant.ts b/lib/rest/flexApi/v1/interaction/interactionChannel/interactionChannelParticipant.ts index bae1477387..2415846b98 100644 --- a/lib/rest/flexApi/v1/interaction/interactionChannel/interactionChannelParticipant.ts +++ b/lib/rest/flexApi/v1/interaction/interactionChannel/interactionChannelParticipant.ts @@ -239,7 +239,7 @@ export class InteractionChannelParticipantInstance { } /** - * The unique string that identifies the resource + * The unique string created by Twilio to identify an Interaction Channel Participant resource. */ sid: string; type: InteractionChannelParticipantType; diff --git a/lib/rest/flexApi/v1/webChannel.ts b/lib/rest/flexApi/v1/webChannel.ts index 4e5aea7874..4865ee1ab9 100644 --- a/lib/rest/flexApi/v1/webChannel.ts +++ b/lib/rest/flexApi/v1/webChannel.ts @@ -293,27 +293,27 @@ export class WebChannelInstance { } /** - * The SID of the Account that created the resource and owns this Workflow + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the WebChannel resource and owns this Workflow. */ accountSid: string; /** - * The SID of the Flex Flow + * The SID of the Flex Flow. */ flexFlowSid: string; /** - * The unique string that identifies the WebChannel resource + * The unique string that we created to identify the WebChannel resource. */ sid: string; /** - * The absolute URL of the WebChannel resource + * The absolute URL of the WebChannel resource. */ url: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; diff --git a/lib/rest/flexApi/v2/webChannels.ts b/lib/rest/flexApi/v2/webChannels.ts index c1bac939ea..8db145ca78 100644 --- a/lib/rest/flexApi/v2/webChannels.ts +++ b/lib/rest/flexApi/v2/webChannels.ts @@ -138,11 +138,11 @@ export class WebChannelsInstance { } /** - * The unique string representing the Conversation resource created + * The unique string representing the [Conversation resource](https://www.twilio.com/docs/conversations/api/conversation-resource) created. */ conversationSid: string; /** - * The unique string representing the User created + * The unique string representing the User created and should be authorized to participate in the Conversation. For more details, see [User Identity & Access Tokens](https://www.twilio.com/docs/conversations/identity). */ identity: string; diff --git a/lib/rest/frontlineApi/v1/user.ts b/lib/rest/frontlineApi/v1/user.ts index 8a61f5369b..b136cca475 100644 --- a/lib/rest/frontlineApi/v1/user.ts +++ b/lib/rest/frontlineApi/v1/user.ts @@ -204,28 +204,28 @@ export class UserInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the User resource. */ sid: string; /** - * The string that identifies the resource\'s User + * The application-defined string that uniquely identifies the resource\'s User. This value is often a username or an email address, and is case-sensitive. */ identity: string; /** - * The string that you assigned to describe the User + * The string that you assigned to describe the User. */ friendlyName: string; /** - * The avatar URL which will be shown in Frontline application + * The avatar URL which will be shown in Frontline application. */ avatar: string; state: UserStateType; /** - * Whether the User is available for new conversations + * Whether the User is available for new conversations. Defaults to `false` for new users. */ isAvailable: boolean; /** - * An absolute URL for this user. + * An absolute API resource URL for this user. */ url: string; diff --git a/lib/rest/insights/v1/call/annotation.ts b/lib/rest/insights/v1/call/annotation.ts index c22bdef91c..7d650ab46c 100644 --- a/lib/rest/insights/v1/call/annotation.ts +++ b/lib/rest/insights/v1/call/annotation.ts @@ -242,33 +242,33 @@ export class AnnotationInstance { } /** - * Call SID. + * The unique SID identifier of the Call. */ callSid: string; /** - * Account SID. + * The unique SID identifier of the Account. */ accountSid: string; answeredBy: AnnotationAnsweredBy; connectivityIssue: AnnotationConnectivityIssue; /** - * Indicates if the call had audio quality issues. + * Specify if the call had any subjective quality issues. Possible values, one or more of: no_quality_issue, low_volume, choppy_robotic, echo, dtmf, latency, owa, static_noise. Use comma separated values to indicate multiple quality issues for the same call */ qualityIssues: Array; /** - * Call spam indicator + * Specify if the call was a spam call. Use this to provide feedback on whether calls placed from your account were marked as spam, or if inbound calls received by your account were unwanted spam. Is of type Boolean: true, false. Use true if the call was a spam call. */ spam: boolean; /** - * Call Score + * Specify the call score. This is of type integer. Use a range of 1-5 to indicate the call experience score, with the following mapping as a reference for rating the call [5: Excellent, 4: Good, 3 : Fair, 2 : Poor, 1: Bad]. */ callScore: number; /** - * User comments + * Specify any comments pertaining to the call. This of type string with a max limit of 100 characters. Twilio does not treat this field as PII, so don’t put any PII in here. */ comment: string; /** - * Call tag for incidents or support ticket + * Associate this call with an incident or support ticket. This is of type string with a max limit of 100 characters. Twilio does not treat this field as PII, so don’t put any PII in here. */ incident: string; /** diff --git a/lib/rest/insights/v1/conference.ts b/lib/rest/insights/v1/conference.ts index 68c0bb3066..c2456a0844 100644 --- a/lib/rest/insights/v1/conference.ts +++ b/lib/rest/insights/v1/conference.ts @@ -308,27 +308,27 @@ export class ConferenceInstance { } /** - * Conference SID. + * The unique SID identifier of the Conference. */ conferenceSid: string; /** - * Account SID. + * The unique SID identifier of the Account. */ accountSid: string; /** - * Custom label for the conference. + * Custom label for the conference resource, up to 64 characters. */ friendlyName: string; /** - * Conference creation date/time. + * Conference creation date and time in ISO 8601 format. */ createTime: Date; /** - * Timestamp in ISO 8601 format when the conference started. + * Timestamp in ISO 8601 format when the conference started. Conferences do not start until at least two participants join, at least one of whom has startConferenceOnEnter=true. */ startTime: Date; /** - * Conference end date/time. + * Conference end date and time in ISO 8601 format. */ endTime: Date; /** @@ -336,43 +336,43 @@ export class ConferenceInstance { */ durationSeconds: number; /** - * Duration of the conference in seconds. + * Duration of the between conference start event and conference end event in seconds. */ connectDurationSeconds: number; status: ConferenceConferenceStatus; /** - * Max participants specified in config. + * Maximum number of concurrent participants as specified by the configuration. */ maxParticipants: number; /** - * Actual maximum concurrent participants. + * Actual maximum number of concurrent participants in the conference. */ maxConcurrentParticipants: number; /** - * Unique conference participants. + * Unique conference participants based on caller ID. */ uniqueParticipants: number; endReason: ConferenceConferenceEndReason; /** - * Call SID that ended the conference. + * Call SID of the participant whose actions ended the conference. */ endedBy: string; mixerRegion: ConferenceRegion; mixerRegionRequested: ConferenceRegion; /** - * Boolean. Indicates whether recording was enabled. + * Boolean. Indicates whether recording was enabled at the conference mixer. */ recordingEnabled: boolean; /** - * Potential issues detected during the conference. + * Potential issues detected by Twilio during the conference. */ detectedIssues: any; /** - * Tags for detected conference conditions and participant behaviors. + * Tags for detected conference conditions and participant behaviors which may be of interest. */ tags: Array; /** - * Object. Contains details about conference tags. + * Object. Contains details about conference tags including severity. */ tagInfo: any; processingState: ConferenceProcessingState; @@ -381,7 +381,7 @@ export class ConferenceInstance { */ url: string; /** - * Nested resource URLs. + * Contains a dictionary of URL links to nested resources of this Conference. */ links: Record; diff --git a/lib/rest/insights/v1/conference/conferenceParticipant.ts b/lib/rest/insights/v1/conference/conferenceParticipant.ts index aa66c1feea..3f0d1dbbd3 100644 --- a/lib/rest/insights/v1/conference/conferenceParticipant.ts +++ b/lib/rest/insights/v1/conference/conferenceParticipant.ts @@ -339,15 +339,15 @@ export class ConferenceParticipantInstance { */ label: string; /** - * Conference SID. + * The unique SID identifier of the Conference. */ conferenceSid: string; /** - * Unique SID identifier of the call. + * Unique SID identifier of the call that generated the Participant resource. */ callSid: string; /** - * Account SID. + * The unique SID identifier of the Account. */ accountSid: string; callDirection: ConferenceParticipantCallDirection; @@ -361,7 +361,7 @@ export class ConferenceParticipantInstance { to: string; callStatus: ConferenceParticipantCallStatus; /** - * ISO alpha-2 country code of the participant. + * ISO alpha-2 country code of the participant based on caller ID or called number. */ countryCode: string; /** @@ -381,11 +381,11 @@ export class ConferenceParticipantInstance { */ durationSeconds: number; /** - * Estimated time in queue at call creation. + * Add Participant API only. Estimated time in queue at call creation. */ outboundQueueLength: number; /** - * Actual time in queue (seconds). + * Add Participant API only. Actual time in queue in seconds. */ outboundTimeInQueue: number; jitterBufferSize: ConferenceParticipantJitterBufferSize; @@ -406,11 +406,11 @@ export class ConferenceParticipantInstance { */ properties: any; /** - * Object containing information of actions taken by participants. Nested resource URLs. + * Object containing information of actions taken by participants. Contains a dictionary of URL links to nested resources of this Conference Participant. */ events: any; /** - * Object. Contains participant quality metrics. + * Object. Contains participant call quality metrics. */ metrics: any; /** diff --git a/lib/rest/insights/v1/room.ts b/lib/rest/insights/v1/room.ts index f10b094f9b..8deb507961 100644 --- a/lib/rest/insights/v1/room.ts +++ b/lib/rest/insights/v1/room.ts @@ -296,7 +296,7 @@ export class RoomInstance { */ roomSid: string; /** - * room friendly name. + * Room friendly name. */ roomName: string; /** @@ -340,7 +340,7 @@ export class RoomInstance { */ maxConcurrentParticipants: number; /** - * Codecs used by participants in the room. + * Codecs used by participants in the room. Can be `VP8`, `H264`, or `VP9`. */ codecs: Array; mediaRegion: VideoRoomSummaryTwilioRealm; diff --git a/lib/rest/insights/v1/room/participant.ts b/lib/rest/insights/v1/room/participant.ts index 7638b573a6..d7cef61956 100644 --- a/lib/rest/insights/v1/room/participant.ts +++ b/lib/rest/insights/v1/room/participant.ts @@ -236,7 +236,7 @@ export class ParticipantInstance { */ joinTime: Date; /** - * When the participant left the room + * When the participant left the room. */ leaveTime: Date; /** @@ -253,11 +253,11 @@ export class ParticipantInstance { roomSid: string; status: VideoParticipantSummaryRoomStatus; /** - * Codecs detected from the participant. + * Codecs detected from the participant. Can be `VP8`, `H264`, or `VP9`. */ codecs: Array; /** - * Reason the participant left the room. + * Reason the participant left the room. See [the list of possible values here](https://www.twilio.com/docs/video/video-log-analyzer/video-log-analyzer-api#end_reason). */ endReason: string; /** @@ -270,12 +270,12 @@ export class ParticipantInstance { errorCodeUrl: string; mediaRegion: VideoParticipantSummaryTwilioRealm; /** - * Object containing information about the participant\'s data from the room. + * Object containing information about the participant\'s data from the room. See [below](https://www.twilio.com/docs/video/video-log-analyzer/video-log-analyzer-api#properties) for more information. */ properties: any; edgeLocation: VideoParticipantSummaryEdgeLocation; /** - * Object containing information about the SDK name and version. + * Object containing information about the SDK name and version. See [below](https://www.twilio.com/docs/video/video-log-analyzer/video-log-analyzer-api#publisher_info) for more information. */ publisherInfo: any; /** diff --git a/lib/rest/lookups/v1/phoneNumber.ts b/lib/rest/lookups/v1/phoneNumber.ts index a4bc065833..328d842460 100644 --- a/lib/rest/lookups/v1/phoneNumber.ts +++ b/lib/rest/lookups/v1/phoneNumber.ts @@ -181,31 +181,31 @@ export class PhoneNumberInstance { } /** - * The name of the phone number\'s owner + * The name of the phone number\'s owner. If `null`, that information was not available. */ callerName: any; /** - * The ISO country code for the phone number + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) for the phone number. */ countryCode: string; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The phone number, in national format + * The phone number, in national format. */ nationalFormat: string; /** - * The telecom company that provides the phone number + * The telecom company that provides the phone number. */ carrier: any; /** - * A JSON string with the results of the Add-ons you specified + * A JSON string with the results of the Add-ons you specified in the `add_ons` parameters. For the format of the object, see [Using Add-ons](https://www.twilio.com/docs/add-ons). */ addOns: any; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/lookups/v2/phoneNumber.ts b/lib/rest/lookups/v2/phoneNumber.ts index f9ff3b5759..da648518ef 100644 --- a/lib/rest/lookups/v2/phoneNumber.ts +++ b/lib/rest/lookups/v2/phoneNumber.ts @@ -226,55 +226,55 @@ export class PhoneNumberInstance { } /** - * International dialing prefix + * International dialing prefix of the phone number defined in the E.164 standard. */ callingCountryCode: string; /** - * Phone number\'s ISO country code + * The phone number\'s [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). */ countryCode: string; /** - * Phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * Phone number in national format + * The phone number in [national format](https://en.wikipedia.org/wiki/National_conventions_for_writing_telephone_numbers). */ nationalFormat: string; /** - * Boolean which indicates if the phone number is valid + * Boolean which indicates if the phone number is in a valid range that can be freely assigned by a carrier to a user. */ valid: boolean; /** - * Contains reasons why a phone number is invalid + * Contains reasons why a phone number is invalid. Possible values: TOO_SHORT, TOO_LONG, INVALID_BUT_POSSIBLE, INVALID_COUNTRY_CODE, INVALID_LENGTH, NOT_A_NUMBER. */ validationErrors: Array; /** - * An object that contains caller name information + * An object that contains caller name information based on [CNAM](https://support.twilio.com/hc/en-us/articles/360051670533-Getting-Started-with-CNAM-Caller-ID). */ callerName: any; /** - * An object that contains SIM swap information + * An object that contains information on the last date the subscriber identity module (SIM) was changed for a mobile phone number. */ simSwap: any; /** - * An object that contains call forwarding status information + * An object that contains information on the unconditional call forwarding status of mobile phone number. */ callForwarding: any; /** - * An object that contains live activity information + * An object that contains live activity information for a mobile phone number. */ liveActivity: any; /** - * An object that contains line type information + * An object that contains line type information including the carrier name, mobile country code, and mobile network code. */ lineTypeIntelligence: any; /** - * An object that contains identity match information + * An object that contains identity match information. The result of comparing user-provided information including name, address, date of birth, national ID, against authoritative phone-based data sources */ identityMatch: any; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/media/v1/mediaProcessor.ts b/lib/rest/media/v1/mediaProcessor.ts index c7c17e40fe..d4113321c2 100644 --- a/lib/rest/media/v1/mediaProcessor.ts +++ b/lib/rest/media/v1/mediaProcessor.ts @@ -288,48 +288,48 @@ export class MediaProcessorInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the MediaProcessor resource. */ accountSid: string; /** - * The unique string that identifies the resource + * The unique string generated to identify the MediaProcessor resource. */ sid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The Media Extension name or URL + * The [Media Extension](/docs/live/api/media-extensions-overview) name or URL. Ex: `video-composer-v2` */ extension: string; /** - * The Media Extension context + * The context of the Media Extension, represented as a JSON dictionary. See the documentation for the specific [Media Extension](/docs/live/api/media-extensions-overview) you are using for more information about the context to send. */ extensionContext: string; status: MediaProcessorStatus; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The reason why a MediaProcessor ended + * The reason why a MediaProcessor ended. When a MediaProcessor is in progress, will be `null`. When a MediaProcessor is completed, can be `ended-via-api`, `max-duration-exceeded`, `error-loading-extension`, `error-streaming-media` or `internal-service-error`. See [ended reasons](/docs/live/api/mediaprocessors#mediaprocessor-ended-reason-values) for more details. */ endedReason: string; /** - * The URL to which Twilio will send MediaProcessor event updates + * The URL to which Twilio will send asynchronous webhook requests for every MediaProcessor event. See [Status Callbacks](/docs/live/status-callbacks) for details. */ statusCallback: string; /** - * The HTTP method Twilio should use to call the `status_callback` URL + * The HTTP method Twilio should use to call the `status_callback` URL. Can be `POST` or `GET` and the default is `POST`. */ statusCallbackMethod: MediaProcessorStatusCallbackMethod; /** - * Maximum MediaProcessor duration in seconds + * The maximum time, in seconds, that the MediaProcessor can run before automatically ends. The default value is 300 seconds, and the maximum value is 90000 seconds. Once this maximum duration is reached, Twilio will end the MediaProcessor, regardless of whether media is still streaming. */ maxDuration: number; diff --git a/lib/rest/media/v1/mediaRecording.ts b/lib/rest/media/v1/mediaRecording.ts index b7d5332cfb..e25fca3b51 100644 --- a/lib/rest/media/v1/mediaRecording.ts +++ b/lib/rest/media/v1/mediaRecording.ts @@ -252,57 +252,57 @@ export class MediaRecordingInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the MediaRecording resource. */ accountSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The duration of the MediaRecording + * The duration of the MediaRecording in seconds. */ duration: number; format: MediaRecordingFormat; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; /** - * The SID of the MediaProcessor + * The SID of the MediaProcessor resource which produced the MediaRecording. */ processorSid: string; /** - * The dimensions of the video image in pixels + * The dimensions of the video image in pixels expressed as columns (width) and rows (height). */ resolution: string; /** - * The SID of the resource that generated the original media + * The SID of the resource that generated the original media track(s) of the MediaRecording. */ sourceSid: string; /** - * The unique string that identifies the resource + * The unique string generated to identify the MediaRecording resource. */ sid: string; /** - * The size of the recording media + * The size of the recording media in bytes. */ mediaSize: number; status: MediaRecordingStatus; /** - * The URL to which Twilio will send MediaRecording event updates + * The URL to which Twilio will send asynchronous webhook requests for every MediaRecording event. See [Status Callbacks](/docs/live/status-callbacks) for more details. */ statusCallback: string; /** - * The HTTP method Twilio should use to call the `status_callback` URL + * The HTTP method Twilio should use to call the `status_callback` URL. Can be `POST` or `GET` and the default is `POST`. */ statusCallbackMethod: MediaRecordingStatusCallbackMethod; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/media/v1/playerStreamer.ts b/lib/rest/media/v1/playerStreamer.ts index 94a8e4f9b4..6d7cd9c3ca 100644 --- a/lib/rest/media/v1/playerStreamer.ts +++ b/lib/rest/media/v1/playerStreamer.ts @@ -302,45 +302,45 @@ export class PlayerStreamerInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the PlayerStreamer resource. */ accountSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * Whether the PlayerStreamer is configured to stream video + * Specifies whether the PlayerStreamer is configured to stream video. Defaults to `true`. */ video: boolean; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; /** - * The unique string that identifies the resource + * The unique string generated to identify the PlayerStreamer resource. */ sid: string; status: PlayerStreamerStatus; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URL to which Twilio will send PlayerStreamer event updates + * The URL to which Twilio will send asynchronous webhook requests for every PlayerStreamer event. See [Status Callbacks](/docs/live/status-callbacks) for more details. */ statusCallback: string; /** - * The HTTP method Twilio should use to call the `status_callback` URL + * The HTTP method Twilio should use to call the `status_callback` URL. Can be `POST` or `GET` and the default is `POST`. */ statusCallbackMethod: PlayerStreamerStatusCallbackMethod; endedReason: PlayerStreamerEndedReason; /** - * Maximum PlayerStreamer duration in seconds + * The maximum time, in seconds, that the PlayerStreamer is active (`created` or `started`) before automatically ends. The default value is 300 seconds, and the maximum value is 90000 seconds. Once this maximum duration is reached, Twilio will end the PlayerStreamer, regardless of whether media is still streaming. */ maxDuration: number; diff --git a/lib/rest/media/v1/playerStreamer/playbackGrant.ts b/lib/rest/media/v1/playerStreamer/playbackGrant.ts index 6e45bef6e7..f9f8fd3ad1 100644 --- a/lib/rest/media/v1/playerStreamer/playbackGrant.ts +++ b/lib/rest/media/v1/playerStreamer/playbackGrant.ts @@ -203,19 +203,19 @@ export class PlaybackGrantInstance { } /** - * The unique string that identifies the PlayerStreamer associated with this PlaybackGrant. + * The unique string generated to identify the PlayerStreamer resource that this PlaybackGrant authorizes views for. */ sid: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this resource. */ accountSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** diff --git a/lib/rest/messaging/v1/brandRegistration.ts b/lib/rest/messaging/v1/brandRegistration.ts index 9a2d749bee..289d4bd7fc 100644 --- a/lib/rest/messaging/v1/brandRegistration.ts +++ b/lib/rest/messaging/v1/brandRegistration.ts @@ -280,69 +280,69 @@ export class BrandRegistrationInstance { } /** - * A2P BrandRegistration Sid + * The unique string to identify Brand Registration. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Brand Registration resource. */ accountSid: string; /** - * A2P Messaging Profile Bundle BundleSid + * A2P Messaging Profile Bundle BundleSid. */ customerProfileBundleSid: string; /** - * A2P Messaging Profile Bundle BundleSid + * A2P Messaging Profile Bundle BundleSid. */ a2pProfileBundleSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * Type of brand. One of: \"STANDARD\", \"STARTER\". + * Type of brand. One of: \"STANDARD\", \"STARTER\". STARTER is for the low volume, STARTER campaign use case. There can only be one STARTER campaign created per STARTER brand. STANDARD is for all other campaign use cases. Multiple campaign use cases can be created per STANDARD brand. */ brandType: string; status: BrandRegistrationsStatus; /** - * Campaign Registry (TCR) Brand ID + * Campaign Registry (TCR) Brand ID. Assigned only after successful brand registration. */ tcrId: string; /** - * A reason why brand registration has failed + * A reason why brand registration has failed. Only applicable when status is FAILED. */ failureReason: string; /** - * The absolute URL of the Brand Registration + * The absolute URL of the Brand Registration resource. */ url: string; /** - * Brand score + * The secondary vetting score if it was done. Otherwise, it will be the brand score if it\'s returned from TCR. It may be null if no score is available. */ brandScore: number; /** - * Brand feedback + * Feedback on how to improve brand score */ brandFeedback: Array; identityStatus: BrandRegistrationsIdentityStatus; /** - * Russell 3000 + * Publicly traded company identified in the Russell 3000 Index */ russell3000: boolean; /** - * Government Entity + * Identified as a government entity */ governmentEntity: boolean; /** - * Tax Exempt Status + * Nonprofit organization tax-exempt status per section 501 of the U.S. tax code. */ taxExemptStatus: string; /** - * Skip Automatic Secondary Vetting + * A flag to disable automatic secondary vetting for brands which it would otherwise be done. */ skipAutomaticSecVet: boolean; /** diff --git a/lib/rest/messaging/v1/brandRegistration/brandVetting.ts b/lib/rest/messaging/v1/brandRegistration/brandVetting.ts index 976d6fec9a..e939be135c 100644 --- a/lib/rest/messaging/v1/brandRegistration/brandVetting.ts +++ b/lib/rest/messaging/v1/brandRegistration/brandVetting.ts @@ -204,40 +204,40 @@ export class BrandVettingInstance { } /** - * The SID of the Account that created the vetting + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the vetting record. */ accountSid: string; /** - * A2P BrandRegistration Sid + * The unique string to identify Brand Registration. */ brandSid: string; /** - * SID for third-party vetting record + * The Twilio SID of the third-party vetting record. */ brandVettingSid: string; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The unique ID of the vetting + * The unique identifier of the vetting from the third-party provider. */ vettingId: string; /** - * The type of vetting + * The type of vetting that has been conducted. One of “STANDARD” (Aegis) or “POLITICAL” (Campaign Verify). */ vettingClass: string; /** - * Status of vetting attempt + * The status of the import vetting attempt. One of “PENDING,” “SUCCESS,” or “FAILED”. */ vettingStatus: string; vettingProvider: BrandVettingVettingProvider; /** - * The absolute URL of the Brand Vetting + * The absolute URL of the Brand Vetting resource. */ url: string; diff --git a/lib/rest/messaging/v1/deactivations.ts b/lib/rest/messaging/v1/deactivations.ts index caf7f27908..46366c441d 100644 --- a/lib/rest/messaging/v1/deactivations.ts +++ b/lib/rest/messaging/v1/deactivations.ts @@ -139,7 +139,7 @@ export class DeactivationsInstance { } /** - * Redirect url to the list of deactivated numbers. + * Returns an authenticated url that redirects to a file containing the deactivated numbers for the requested day. This url is valid for up to two minutes. */ redirectTo: string; diff --git a/lib/rest/messaging/v1/domainCerts.ts b/lib/rest/messaging/v1/domainCerts.ts index 9bbc13a46d..4b79b347ef 100644 --- a/lib/rest/messaging/v1/domainCerts.ts +++ b/lib/rest/messaging/v1/domainCerts.ts @@ -230,11 +230,11 @@ export class DomainCertsInstance { */ dateUpdated: Date; /** - * Expiration date for your private certificate. + * Date that the private certificate associated with this domain expires. You will need to update the certificate before that date to ensure your shortened links will continue to work. */ dateExpires: Date; /** - * Date this Domain SID was created. + * Date that this Domain was registered to the Twilio platform to create a new Domain object. */ dateCreated: Date; /** @@ -247,7 +247,7 @@ export class DomainCertsInstance { certificateSid: string; url: string; /** - * Certificate validation field + * Boolean value indicating whether certificate has been validated */ validated: boolean; diff --git a/lib/rest/messaging/v1/domainConfig.ts b/lib/rest/messaging/v1/domainConfig.ts index e67e24e097..3ce9642567 100644 --- a/lib/rest/messaging/v1/domainConfig.ts +++ b/lib/rest/messaging/v1/domainConfig.ts @@ -226,7 +226,7 @@ export class DomainConfigInstance { */ messagingServiceSids: Array; /** - * We will redirect requests to urls we are unable to identify to this url. + * Any requests we receive to this domain that do not match an existing shortened message will be redirected to the fallback url. These will likely be either expired messages, random misdirected traffic, or intentional scraping. */ fallbackUrl: string; /** diff --git a/lib/rest/messaging/v1/externalCampaign.ts b/lib/rest/messaging/v1/externalCampaign.ts index 5cb7cd8d84..b0fd197867 100644 --- a/lib/rest/messaging/v1/externalCampaign.ts +++ b/lib/rest/messaging/v1/externalCampaign.ts @@ -147,11 +147,11 @@ export class ExternalCampaignInstance { } /** - * The unique string that identifies a US A2P Compliance resource + * The unique string that identifies a US A2P Compliance resource `QE2c6890da8086d771620e9b13fadeba0b`. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that the Campaign belongs to. */ accountSid: string; /** @@ -159,11 +159,11 @@ export class ExternalCampaignInstance { */ campaignId: string; /** - * The SID of the Messaging Service the resource is associated with + * The SID of the [Messaging Service](https://www.twilio.com/docs/messaging/services/api) that the resource is associated with. */ messagingServiceSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; diff --git a/lib/rest/messaging/v1/service.ts b/lib/rest/messaging/v1/service.ts index fe68310c20..080a017e0c 100644 --- a/lib/rest/messaging/v1/service.ts +++ b/lib/rest/messaging/v1/service.ts @@ -461,84 +461,84 @@ export class ServiceInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Service resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The URL we call using inbound_method when a message is received by any phone number or short code in the Service. This field will be overridden if the `use_inbound_webhook_on_number` field is enabled. + * The URL we call using `inbound_method` when a message is received by any phone number or short code in the Service. When this property is `null`, receiving inbound messages is disabled. All messages sent to the Twilio phone number or short code will not be logged and received on the Account. If the `use_inbound_webhook_on_number` field is enabled then the webhook url defined on the phone number will override the `inbound_request_url` defined for the Messaging Service. */ inboundRequestUrl: string; /** - * The HTTP method we use to call inbound_request_url + * The HTTP method we use to call `inbound_request_url`. Can be `GET` or `POST`. */ inboundMethod: ServiceInboundMethod; /** - * The URL that we call using fallback_method if an error occurs while retrieving or executing the TwiML from the Inbound Request URL. This field will be overridden if the `use_inbound_webhook_on_number` field is enabled. + * The URL that we call using `fallback_method` if an error occurs while retrieving or executing the TwiML from the Inbound Request URL. If the `use_inbound_webhook_on_number` field is enabled then the webhook url defined on the phone number will override the `fallback_url` defined for the Messaging Service. */ fallbackUrl: string; /** - * The HTTP method we use to call fallback_url + * The HTTP method we use to call `fallback_url`. Can be: `GET` or `POST`. */ fallbackMethod: ServiceFallbackMethod; /** - * The URL we call to pass status updates about message delivery + * The URL we call to [pass status updates](https://www.twilio.com/docs/sms/api/message-resource#message-status-values) about message delivery. */ statusCallback: string; /** - * Whether to enable Sticky Sender on the Service instance + * Whether to enable [Sticky Sender](https://www.twilio.com/docs/sms/services#sticky-sender) on the Service instance. */ stickySender: boolean; /** - * Whether to enable the MMS Converter for messages sent through the Service instance + * Whether to enable the [MMS Converter](https://www.twilio.com/docs/sms/services#mms-converter) for messages sent through the Service instance. */ mmsConverter: boolean; /** - * Whether to enable Encoding for messages sent through the Service instance + * Whether to enable [Smart Encoding](https://www.twilio.com/docs/sms/services#smart-encoding) for messages sent through the Service instance. */ smartEncoding: boolean; scanMessageContent: ServiceScanMessageContent; /** - * Whether to enable Fallback to Long Code for messages sent through the Service instance + * Whether to enable [Fallback to Long Code](https://www.twilio.com/docs/sms/services#fallback-to-long-code) for messages sent through the Service instance. */ fallbackToLongCode: boolean; /** - * Whether to enable Area Code Geomatch on the Service Instance + * Whether to enable [Area Code Geomatch](https://www.twilio.com/docs/sms/services#area-code-geomatch) on the Service Instance. */ areaCodeGeomatch: boolean; /** - * Reserved + * Reserved. */ synchronousValidation: boolean; /** - * How long, in seconds, messages sent from the Service are valid + * How long, in seconds, messages sent from the Service are valid. Can be an integer from `1` to `14,400`. */ validityPeriod: number; /** - * The absolute URL of the Service resource + * The absolute URL of the Service resource. */ url: string; /** - * The absolute URLs of related resources + * The absolute URLs of related resources. */ links: Record; /** - * A string describing the scenario in which the Messaging Service will be used + * A string that describes the scenario in which the Messaging Service will be used. Examples: [notification, marketing, verification, poll ..] */ usecase: string; /** @@ -546,7 +546,7 @@ export class ServiceInstance { */ usAppToPersonRegistered: boolean; /** - * If enabled, the webhook url configured on the phone number will be used and will override the `inbound_request_url`/`fallback_url` url called when an inbound message is received. + * A boolean value that indicates either the webhook url configured on the phone number will be used or `inbound_request_url`/`fallback_url` url will be called when a message is received from the phone number. If this field is enabled then the webhook url defined on the phone number will override the `inbound_request_url`/`fallback_url` defined for the Messaging Service. */ useInboundWebhookOnNumber: boolean; diff --git a/lib/rest/messaging/v1/service/alphaSender.ts b/lib/rest/messaging/v1/service/alphaSender.ts index 2a74b1ebb5..fd4cd70c81 100644 --- a/lib/rest/messaging/v1/service/alphaSender.ts +++ b/lib/rest/messaging/v1/service/alphaSender.ts @@ -211,35 +211,35 @@ export class AlphaSenderInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the AlphaSender resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the AlphaSender resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the resource is associated with. */ serviceSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The Alphanumeric Sender ID string + * The Alphanumeric Sender ID string. */ alphaSender: string; /** - * An array of values that describe whether the number can receive calls or messages + * An array of values that describe whether the number can receive calls or messages. Can be: `SMS`. */ capabilities: Array; /** - * The absolute URL of the AlphaSender resource + * The absolute URL of the AlphaSender resource. */ url: string; diff --git a/lib/rest/messaging/v1/service/phoneNumber.ts b/lib/rest/messaging/v1/service/phoneNumber.ts index a5395421ce..4bea8d6ea3 100644 --- a/lib/rest/messaging/v1/service/phoneNumber.ts +++ b/lib/rest/messaging/v1/service/phoneNumber.ts @@ -213,39 +213,39 @@ export class PhoneNumberInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the PhoneNumber resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the PhoneNumber resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the resource is associated with. */ serviceSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The 2-character ISO Country Code of the number + * The 2-character [ISO Country Code](https://www.iso.org/iso-3166-country-codes.html) of the number. */ countryCode: string; /** - * An array of values that describe whether the number can receive calls or messages + * An array of values that describe whether the number can receive calls or messages. Can be: `Voice`, `SMS`, and `MMS`. */ capabilities: Array; /** - * The absolute URL of the PhoneNumber resource + * The absolute URL of the PhoneNumber resource. */ url: string; diff --git a/lib/rest/messaging/v1/service/shortCode.ts b/lib/rest/messaging/v1/service/shortCode.ts index 7170fd5de3..081ddf7177 100644 --- a/lib/rest/messaging/v1/service/shortCode.ts +++ b/lib/rest/messaging/v1/service/shortCode.ts @@ -213,39 +213,39 @@ export class ShortCodeInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the ShortCode resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the ShortCode resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/chat/rest/service-resource) the resource is associated with. */ serviceSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The E.164 format of the short code + * The [E.164](https://www.twilio.com/docs/glossary/what-e164) format of the short code. */ shortCode: string; /** - * The 2-character ISO Country Code of the number + * The 2-character [ISO Country Code](https://www.iso.org/iso-3166-country-codes.html) of the number. */ countryCode: string; /** - * An array of values that describe whether the number can receive calls or messages + * An array of values that describe whether the number can receive calls or messages. Can be: `SMS` and `MMS`. */ capabilities: Array; /** - * The absolute URL of the ShortCode resource + * The absolute URL of the ShortCode resource. */ url: string; diff --git a/lib/rest/messaging/v1/service/usAppToPerson.ts b/lib/rest/messaging/v1/service/usAppToPerson.ts index 4f1949a8cc..d7deac9b40 100644 --- a/lib/rest/messaging/v1/service/usAppToPerson.ts +++ b/lib/rest/messaging/v1/service/usAppToPerson.ts @@ -271,43 +271,43 @@ export class UsAppToPersonInstance { } /** - * The unique string that identifies a US A2P Compliance resource + * The unique string that identifies a US A2P Compliance resource `QE2c6890da8086d771620e9b13fadeba0b`. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that the Campaign belongs to. */ accountSid: string; /** - * A2P Brand Registration SID + * The unique string to identify the A2P brand. */ brandRegistrationSid: string; /** - * The SID of the Messaging Service the resource is associated with + * The SID of the [Messaging Service](https://www.twilio.com/docs/messaging/services/api) that the resource is associated with. */ messagingServiceSid: string; /** - * A short description of what this SMS campaign does + * A short description of what this SMS campaign does. Min length: 40 characters. Max length: 4096 characters. */ description: string; /** - * Message samples + * Message samples, at least 1 and up to 5 sample messages (at least 2 for starter/sole proprietor), >=20 chars, <=1024 chars each. */ messageSamples: Array; /** - * A2P Campaign Use Case. + * A2P Campaign Use Case. Examples: [ 2FA, EMERGENCY, MARKETING, STARTER...]. STARTER campaign use cases can only be created by STARTER Brands, and there can only be one STARTER campaign created per STARTER Brand. */ usAppToPersonUsecase: string; /** - * Indicate that this SMS campaign will send messages that contain links + * Indicate that this SMS campaign will send messages that contain links. */ hasEmbeddedLinks: boolean; /** - * Indicates that this SMS campaign will send messages that contain phone numbers + * Indicates that this SMS campaign will send messages that contain phone numbers. */ hasEmbeddedPhone: boolean; /** - * Campaign status + * Campaign status. Examples: IN_PROGRESS, VERIFIED, FAILED. */ campaignStatus: string; /** @@ -315,55 +315,55 @@ export class UsAppToPersonInstance { */ campaignId: string; /** - * Indicates whether the campaign was registered externally or not + * Indicates whether the campaign was registered externally or not. */ isExternallyRegistered: boolean; /** - * Rate limit and/or classification set by each carrier + * Rate limit and/or classification set by each carrier, Ex. AT&T or T-Mobile. */ rateLimits: any; /** - * Consumer opt-in flow + * Details around how a consumer opts-in to their campaign, therefore giving consent to receive their messages. If multiple opt-in methods can be used for the same campaign, they must all be listed. 40 character minimum. 2048 character maximum. */ messageFlow: string; /** - * Opt In Message + * If end users can text in a keyword to start receiving messages from this campaign, the auto-reply messages sent to the end users must be provided. The opt-in response should include the Brand name, confirmation of opt-in enrollment to a recurring message campaign, how to get help, and clear description of how to opt-out. This field is required if end users can text in a keyword to start receiving messages from this campaign. 20 character minimum. 320 character maximum. */ optInMessage: string; /** - * Opt Out Message + * Upon receiving the opt-out keywords from the end users, Twilio customers are expected to send back an auto-generated response, which must provide acknowledgment of the opt-out request and confirmation that no further messages will be sent. It is also recommended that these opt-out messages include the brand name. This field is required if managing opt out keywords yourself (i.e. not using Twilio\'s Default or Advanced Opt Out features). 20 character minimum. 320 character maximum. */ optOutMessage: string; /** - * Help Message + * When customers receive the help keywords from their end users, Twilio customers are expected to send back an auto-generated response; this may include the brand name and additional support contact information. This field is required if managing help keywords yourself (i.e. not using Twilio\'s Default or Advanced Opt Out features). 20 character minimum. 320 character maximum. */ helpMessage: string; /** - * Opt In Keywords + * If end users can text in a keyword to start receiving messages from this campaign, those keywords must be provided. This field is required if end users can text in a keyword to start receiving messages from this campaign. Values must be alphanumeric. 255 character maximum. */ optInKeywords: Array; /** - * Opt Out Keywords + * End users should be able to text in a keyword to stop receiving messages from this campaign. Those keywords must be provided. This field is required if managing opt out keywords yourself (i.e. not using Twilio\'s Default or Advanced Opt Out features). Values must be alphanumeric. 255 character maximum. */ optOutKeywords: Array; /** - * Help Keywords + * End users should be able to text in a keyword to receive help. Those keywords must be provided as part of the campaign registration request. This field is required if managing help keywords yourself (i.e. not using Twilio\'s Default or Advanced Opt Out features). Values must be alphanumeric. 255 character maximum. */ helpKeywords: Array; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the US App to Person resource + * The absolute URL of the US App to Person resource. */ url: string; /** - * A boolean that specifies whether campaign is a mock or not. + * A boolean that specifies whether campaign is a mock or not. Mock campaigns will be automatically created if using a mock brand. Mock campaigns should only be used for testing purposes. */ mock: boolean; diff --git a/lib/rest/messaging/v1/service/usAppToPersonUsecase.ts b/lib/rest/messaging/v1/service/usAppToPersonUsecase.ts index d5f5581977..8bca92e439 100644 --- a/lib/rest/messaging/v1/service/usAppToPersonUsecase.ts +++ b/lib/rest/messaging/v1/service/usAppToPersonUsecase.ts @@ -153,7 +153,7 @@ export class UsAppToPersonUsecaseInstance { } /** - * Human readable A2P Use Case details + * Human readable name, code, description and post_approval_required (indicates whether or not post approval is required for this Use Case) of A2P Campaign Use Cases. */ usAppToPersonUsecases: Array; diff --git a/lib/rest/messaging/v1/tollfreeVerification.ts b/lib/rest/messaging/v1/tollfreeVerification.ts index fc624e4f05..018dcadbe4 100644 --- a/lib/rest/messaging/v1/tollfreeVerification.ts +++ b/lib/rest/messaging/v1/tollfreeVerification.ts @@ -454,121 +454,121 @@ export class TollfreeVerificationInstance { } /** - * Tollfree Verification Sid + * The unique string to identify Tollfree Verification. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Tollfree Verification resource. */ accountSid: string; /** - * Customer\'s Profile Bundle BundleSid + * Customer\'s Profile Bundle BundleSid. */ customerProfileSid: string; /** - * Tollfree TrustProduct Bundle BundleSid + * Tollfree TrustProduct Bundle BundleSid. */ trustProductSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The SID of the Regulated Item + * The SID of the Regulated Item. */ regulatedItemSid: string; /** - * The name of the business or organization using the Tollfree number + * The name of the business or organization using the Tollfree number. */ businessName: string; /** - * The address of the business or organization using the Tollfree number + * The address of the business or organization using the Tollfree number. */ businessStreetAddress: string; /** - * The address of the business or organization using the Tollfree number + * The address of the business or organization using the Tollfree number. */ businessStreetAddress2: string; /** - * The city of the business or organization using the Tollfree number + * The city of the business or organization using the Tollfree number. */ businessCity: string; /** - * The state/province/region of the business or organization using the Tollfree number + * The state/province/region of the business or organization using the Tollfree number. */ businessStateProvinceRegion: string; /** - * The postal code of the business or organization using the Tollfree number + * The postal code of the business or organization using the Tollfree number. */ businessPostalCode: string; /** - * The country of the business or organization using the Tollfree number + * The country of the business or organization using the Tollfree number. */ businessCountry: string; /** - * The website of the business or organization using the Tollfree number + * The website of the business or organization using the Tollfree number. */ businessWebsite: string; /** - * The first name of the contact for the business or organization using the Tollfree number + * The first name of the contact for the business or organization using the Tollfree number. */ businessContactFirstName: string; /** - * The last name of the contact for the business or organization using the Tollfree number + * The last name of the contact for the business or organization using the Tollfree number. */ businessContactLastName: string; /** - * The email address of the contact for the business or organization using the Tollfree number + * The email address of the contact for the business or organization using the Tollfree number. */ businessContactEmail: string; /** - * The phone number of the contact for the business or organization using the Tollfree number + * The phone number of the contact for the business or organization using the Tollfree number. */ businessContactPhone: string; /** - * The email address to receive the notification about the verification result. + * The email address to receive the notification about the verification result. . */ notificationEmail: string; /** - * The category of the use case for the Tollfree Number. List as many are applicable. + * The category of the use case for the Tollfree Number. List as many are applicable.. */ useCaseCategories: Array; /** - * Further explaination on how messaging is used by the business or organization + * Use this to further explain how messaging is used by the business or organization. */ useCaseSummary: string; /** - * An example of message content, i.e. a sample message + * An example of message content, i.e. a sample message. */ productionMessageSample: string; /** - * Link to an image that shows the opt-in workflow. Multiple images allowed and must be a publicly hosted URL + * Link to an image that shows the opt-in workflow. Multiple images allowed and must be a publicly hosted URL. */ optInImageUrls: Array; optInType: TollfreeVerificationOptInType; /** - * Estimate monthly volume of messages from the Tollfree Number + * Estimate monthly volume of messages from the Tollfree Number. */ messageVolume: string; /** - * Additional information to be provided for verification + * Additional information to be provided for verification. */ additionalInformation: string; /** - * The SID of the Phone Number associated with the Tollfree Verification + * The SID of the Phone Number associated with the Tollfree Verification. */ tollfreePhoneNumberSid: string; status: TollfreeVerificationStatus; /** - * The absolute URL of the Tollfree Verification + * The absolute URL of the Tollfree Verification resource. */ url: string; /** - * The URLs of the documents associated with the Tollfree Verification resource + * The URLs of the documents associated with the Tollfree Verification resource. */ resourceLinks: any; diff --git a/lib/rest/messaging/v1/usecase.ts b/lib/rest/messaging/v1/usecase.ts index 4a50b69269..d67020fcdb 100644 --- a/lib/rest/messaging/v1/usecase.ts +++ b/lib/rest/messaging/v1/usecase.ts @@ -96,7 +96,7 @@ export class UsecaseInstance { } /** - * Human readable Messaging Service Use Case details + * Human readable use case details (usecase, description and purpose) of Messaging Service Use Cases. */ usecases: Array; diff --git a/lib/rest/microvisor/v1/app.ts b/lib/rest/microvisor/v1/app.ts index 124f2f52b5..6e1c6a5235 100644 --- a/lib/rest/microvisor/v1/app.ts +++ b/lib/rest/microvisor/v1/app.ts @@ -187,27 +187,27 @@ export class AppInstance { } /** - * A string that uniquely identifies this App. + * A 34-character string that uniquely identifies this App. */ sid: string; /** - * The Account SID. + * The unique SID identifier of the Account. */ accountSid: string; /** - * App manifest hash represented as hash_algorithm:hash_value. + * App manifest hash represented as `hash_algorithm:hash_value`. */ hash: string; /** - * An developer-defined string that uniquely identifies the App. + * A developer-defined string that uniquely identifies the App. This value must be unique for all Apps on this Account. The `unique_name` value may be used as an alternative to the `sid` in the URL path to address the resource. */ uniqueName: string; /** - * The date that this App was created. + * The date that this App was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The date that this App was last updated. + * The date that this App was last updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** diff --git a/lib/rest/microvisor/v1/device.ts b/lib/rest/microvisor/v1/device.ts index 11257974b7..86e89eced1 100644 --- a/lib/rest/microvisor/v1/device.ts +++ b/lib/rest/microvisor/v1/device.ts @@ -243,31 +243,31 @@ export class DeviceInstance { } /** - * A string that uniquely identifies this Device. + * A 34-character string that uniquely identifies this Device. */ sid: string; /** - * A developer-defined string that uniquely identifies the Device. + * A developer-defined string that uniquely identifies the Device. This value must be unique for all Devices on this Account. The `unique_name` value may be used as an alternative to the `sid` in the URL path to address the resource. */ uniqueName: string; /** - * Account SID. + * The unique SID identifier of the Account. */ accountSid: string; /** - * Information about the target App and the App reported by this Device. + * Information about the target App and the App reported by this Device. Contains the properties `target_sid`, `date_targeted`, `update_status` (one of `up-to-date`, `pending` and `error`), `update_error_code`, `reported_sid` and `date_reported`. */ app: any; /** - * Object specifying whether application logging is enabled for this Device. + * Object specifying whether application logging is enabled for this Device. Contains the properties `enabled` and `date_expires`. */ logging: any; /** - * The date that this Device was created. + * The date that this Device was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The date that this Device was last updated. + * The date that this Device was last updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** @@ -275,7 +275,7 @@ export class DeviceInstance { */ url: string; /** - * The absolute URLs of related resources + * The absolute URLs of related resources. */ links: Record; diff --git a/lib/rest/monitor/v1/alert.ts b/lib/rest/monitor/v1/alert.ts index cf716d89b8..0d75841f10 100644 --- a/lib/rest/monitor/v1/alert.ts +++ b/lib/rest/monitor/v1/alert.ts @@ -209,79 +209,79 @@ export class AlertInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Alert resource. */ accountSid: string; /** - * The text of the alert + * The text of the alert. */ alertText: string; /** - * The API version used when the alert was generated + * The API version used when the alert was generated. Can be empty for events that don\'t have a specific API version. */ apiVersion: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The date and time when the alert was generated specified in ISO 8601 format + * The date and time in GMT when the alert was generated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format. Due to buffering, this can be different than `date_created`. */ dateGenerated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The error code for the condition that generated the alert + * The error code for the condition that generated the alert. See the [Error Dictionary](https://www.twilio.com/docs/api/errors) for possible causes and solutions to the error. */ errorCode: string; /** - * The log level + * The log level. Can be: `error`, `warning`, `notice`, or `debug`. */ logLevel: string; /** - * The URL of the page in our Error Dictionary with more information about the error condition + * The URL of the page in our [Error Dictionary](https://www.twilio.com/docs/api/errors) with more information about the error condition. */ moreInfo: string; /** - * The method used by the request that generated the alert + * The method used by the request that generated the alert. If the alert was generated by a request we made to your server, this is the method we used. If the alert was generated by a request from your application to our API, this is the method your application used. */ requestMethod: AlertRequestMethod; /** - * The URL of the request that generated the alert + * The URL of the request that generated the alert. If the alert was generated by a request we made to your server, this is the URL on your server that generated the alert. If the alert was generated by a request from your application to our API, this is the URL of the resource requested. */ requestUrl: string; /** - * The variables passed in the request that generated the alert + * The variables passed in the request that generated the alert. This value is only returned when a single Alert resource is fetched. */ requestVariables: string; /** - * The SID of the resource for which the alert was generated + * The SID of the resource for which the alert was generated. For instance, if your server failed to respond to an HTTP request during the flow of a particular call, this value would be the SID of the server. This value is empty if the alert was not generated for a particular resource. */ resourceSid: string; /** - * The response body of the request that generated the alert + * The response body of the request that generated the alert. This value is only returned when a single Alert resource is fetched. */ responseBody: string; /** - * The response headers of the request that generated the alert + * The response headers of the request that generated the alert. This value is only returned when a single Alert resource is fetched. */ responseHeaders: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Alert resource. */ sid: string; /** - * The absolute URL of the Alert resource + * The absolute URL of the Alert resource. */ url: string; /** - * The request headers of the request that generated the alert + * The request headers of the request that generated the alert. This value is only returned when a single Alert resource is fetched. */ requestHeaders: string; /** - * The SID of the service or resource that generated the alert + * The SID of the service or resource that generated the alert. Can be `null`. */ serviceSid: string; diff --git a/lib/rest/monitor/v1/event.ts b/lib/rest/monitor/v1/event.ts index 57a989a9a3..b6b096be78 100644 --- a/lib/rest/monitor/v1/event.ts +++ b/lib/rest/monitor/v1/event.ts @@ -209,59 +209,59 @@ export class EventInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Event resource. */ accountSid: string; /** - * The SID of the actor that caused the event, if available + * The SID of the actor that caused the event, if available. Can be `null`. */ actorSid: string; /** - * The type of actor that caused the event + * The type of actor that caused the event. Can be: `user` for a change made by a logged-in user in the Twilio Console, `account` for an event caused by an API request by an authenticating Account, `twilio-admin` for an event caused by a Twilio employee, and so on. */ actorType: string; /** - * A description of the event + * A description of the event. Can be `null`. */ description: string; /** - * A JSON string that represents an object with additional data about the event + * An object with additional data about the event. The contents depend on `event_type`. For example, event-types of the form `RESOURCE.updated`, this value contains a `resource_properties` dictionary that describes the previous and updated properties of the resource. */ eventData: any; /** - * The ISO 8601 date and time in GMT when the event was recorded + * The date and time in GMT when the event was recorded specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ eventDate: Date; /** - * The event\'s type + * The event\'s type. Event-types are typically in the form: `RESOURCE_TYPE.ACTION`, where `RESOURCE_TYPE` is the type of resource that was affected and `ACTION` is what happened to it. For example, `phone-number.created`. For a full list of all event-types, see the [Monitor Event Types](https://www.twilio.com/docs/usage/monitor-events#event-types). */ eventType: string; /** - * The SID of the resource that was affected + * The SID of the resource that was affected. */ resourceSid: string; /** - * The type of resource that was affected + * The type of resource that was affected. For a full list of all resource-types, see the [Monitor Event Types](https://www.twilio.com/docs/usage/monitor-events#event-types). */ resourceType: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Event resource. */ sid: string; /** - * The originating system or interface that caused the event + * The originating system or interface that caused the event. Can be: `web` for events caused by user action in the Twilio Console, `api` for events caused by a request to our API, or `twilio` for events caused by an automated or internal Twilio system. */ source: string; /** - * The IP address of the source + * The IP address of the source, if the source is outside the Twilio cloud. This value is `null` for events with `source` of `twilio` */ sourceIpAddress: string; /** - * The absolute URL of the resource that was affected + * The absolute URL of the resource that was affected. Can be `null`. */ url: string; /** - * The absolute URLs of related resources + * The absolute URLs of related resources. */ links: Record; diff --git a/lib/rest/notify/v1/credential.ts b/lib/rest/notify/v1/credential.ts index d997526e75..3002b9bbc5 100644 --- a/lib/rest/notify/v1/credential.ts +++ b/lib/rest/notify/v1/credential.ts @@ -313,32 +313,32 @@ export class CredentialInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Credential resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Credential resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; type: CredentialPushService; /** - * [APN only] Whether to send the credential to sandbox APNs + * [APN only] Whether to send the credential to sandbox APNs. Can be `true` to send to sandbox APNs or `false` to send to production. */ sandbox: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The absolute URL of the Credential resource + * The absolute URL of the Credential resource. */ url: string; diff --git a/lib/rest/notify/v1/service.ts b/lib/rest/notify/v1/service.ts index 3207234b84..5ac5c8aa98 100644 --- a/lib/rest/notify/v1/service.ts +++ b/lib/rest/notify/v1/service.ts @@ -408,83 +408,83 @@ export class ServiceInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Service resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The SID of the Credential to use for APN Bindings + * The SID of the [Credential](https://www.twilio.com/docs/notify/api/credential-resource) to use for APN Bindings. */ apnCredentialSid: string; /** - * The SID of the Credential to use for GCM Bindings + * The SID of the [Credential](https://www.twilio.com/docs/notify/api/credential-resource) to use for GCM Bindings. */ gcmCredentialSid: string; /** - * The SID of the Credential to use for FCM Bindings + * The SID of the [Credential](https://www.twilio.com/docs/notify/api/credential-resource) to use for FCM Bindings. */ fcmCredentialSid: string; /** - * The SID of the Messaging Service to use for SMS Bindings + * The SID of the [Messaging Service](https://www.twilio.com/docs/sms/send-messages#messaging-services) to use for SMS Bindings. In order to send SMS notifications this parameter has to be set. */ messagingServiceSid: string; /** - * Deprecated + * Deprecated. */ facebookMessengerPageId: string; /** - * The protocol version to use for sending APNS notifications + * The protocol version to use for sending APNS notifications. Can be overridden on a Binding by Binding basis when creating a [Binding](https://www.twilio.com/docs/notify/api/binding-resource) resource. */ defaultApnNotificationProtocolVersion: string; /** - * The protocol version to use for sending GCM notifications + * The protocol version to use for sending GCM notifications. Can be overridden on a Binding by Binding basis when creating a [Binding](https://www.twilio.com/docs/notify/api/binding-resource) resource. */ defaultGcmNotificationProtocolVersion: string; /** - * The protocol version to use for sending FCM notifications + * The protocol version to use for sending FCM notifications. Can be overridden on a Binding by Binding basis when creating a [Binding](https://www.twilio.com/docs/notify/api/binding-resource) resource. */ defaultFcmNotificationProtocolVersion: string; /** - * Whether to log notifications + * Whether to log notifications. Can be: `true` or `false` and the default is `true`. */ logEnabled: boolean; /** - * The absolute URL of the Service resource + * The absolute URL of the Service resource. */ url: string; /** - * The URLs of the resources related to the service + * The URLs of the Binding, Notification, Segment, and User resources related to the service. */ links: Record; /** - * Deprecated + * Deprecated. */ alexaSkillId: string; /** - * Deprecated + * Deprecated. */ defaultAlexaNotificationProtocolVersion: string; /** - * Webhook URL + * URL to send delivery status callback. */ deliveryCallbackUrl: string; /** - * Enable delivery callbacks + * Callback configuration that enables delivery callbacks, default false */ deliveryCallbackEnabled: boolean; diff --git a/lib/rest/notify/v1/service/binding.ts b/lib/rest/notify/v1/service/binding.ts index 72cf6d0025..a45ec23786 100644 --- a/lib/rest/notify/v1/service/binding.ts +++ b/lib/rest/notify/v1/service/binding.ts @@ -267,59 +267,59 @@ export class BindingInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Binding resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Binding resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/notify/api/service-resource) the resource is associated with. */ serviceSid: string; /** - * The SID of the Credential resource to be used to send notifications to this Binding + * The SID of the [Credential](https://www.twilio.com/docs/notify/api/credential-resource) resource to be used to send notifications to this Binding. If present, this overrides the Credential specified in the Service resource. Applicable only to `apn`, `fcm`, and `gcm` type Bindings. */ credentialSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The protocol version to use to send the notification + * The protocol version to use to send the notification. This defaults to the value of `default_xxxx_notification_protocol_version` in the [Service](https://www.twilio.com/docs/notify/api/service-resource) for the protocol. The current version is `\"3\"` for `apn`, `fcm`, and `gcm` type Bindings. The parameter is not applicable to `sms` and `facebook-messenger` type Bindings as the data format is fixed. */ notificationProtocolVersion: string; /** - * Deprecated + * Deprecated. */ endpoint: string; /** - * The `identity` value that identifies the new resource\'s User + * The `identity` value that uniquely identifies the resource\'s [User](https://www.twilio.com/docs/chat/rest/user-resource) within the [Service](https://www.twilio.com/docs/notify/api/service-resource). Up to 20 Bindings can be created for the same Identity in a given Service. */ identity: string; /** - * The type of the Binding + * The transport technology to use for the Binding. Can be: `apn`, `fcm`, `gcm`, `sms`, or `facebook-messenger`. */ bindingType: string; /** - * The channel-specific address + * The channel-specific address. For APNS, the device token. For FCM and GCM, the registration token. For SMS, a phone number in E.164 format. For Facebook Messenger, the Messenger ID of the user or a phone number in E.164 format. */ address: string; /** - * The list of tags associated with this Binding + * The list of tags associated with this Binding. Tags can be used to select the Bindings to use when sending a notification. Maximum 20 tags are allowed. */ tags: Array; /** - * The absolute URL of the Binding resource + * The absolute URL of the Binding resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/notify/v1/service/notification.ts b/lib/rest/notify/v1/service/notification.ts index 9c8e4e18f3..8003c51e11 100644 --- a/lib/rest/notify/v1/service/notification.ts +++ b/lib/rest/notify/v1/service/notification.ts @@ -256,80 +256,80 @@ export class NotificationInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Notification resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Notification resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/notify/api/service-resource) the resource is associated with. */ serviceSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The list of identity values of the Users to notify + * The list of `identity` values of the Users to notify. We will attempt to deliver notifications only to Bindings with an identity in this list. */ identities: Array; /** - * The tags that select the Bindings to notify + * The tags that select the Bindings to notify. Notifications will be attempted only to Bindings that have all of the tags listed in this property. */ tags: Array; /** - * The list of Segments to notify + * The list of Segments to notify. The [Segment](https://www.twilio.com/docs/notify/api/segment-resource) resource is deprecated. Use the `tags` property, instead. */ segments: Array; priority: NotificationPriority; /** - * How long, in seconds, the notification is valid + * How long, in seconds, the notification is valid. Can be an integer between 0 and 2,419,200, which is 4 weeks, the default and the maximum supported time to live (TTL). Delivery should be attempted if the device is offline until the TTL elapses. Zero means that the notification delivery is attempted immediately, only once, and is not stored for future delivery. SMS does not support this property. */ ttl: number; /** - * The notification title + * The notification title. For FCM and GCM, this translates to the `data.twi_title` value. For APNS, this translates to the `aps.alert.title` value. SMS does not support this property. This field is not visible on iOS phones and tablets but appears on Apple Watch and Android devices. */ title: string; /** - * The notification body text + * The notification text. For FCM and GCM, translates to `data.twi_body`. For APNS, translates to `aps.alert.body`. For SMS, translates to `body`. SMS requires either this `body` value, or `media_urls` attribute defined in the `sms` parameter of the notification. */ body: string; /** - * The name of the sound to be played for the notification + * The name of the sound to be played for the notification. For FCM and GCM, this Translates to `data.twi_sound`. For APNS, this translates to `aps.sound`. SMS does not support this property. */ sound: string; /** - * The actions to display for the notification + * The actions to display for the notification. For APNS, translates to the `aps.category` value. For GCM, translates to the `data.twi_action` value. For SMS, this parameter is not supported and is omitted from deliveries to those channels. */ action: string; /** - * The custom key-value pairs of the notification\'s payload + * The custom key-value pairs of the notification\'s payload. For FCM and GCM, this value translates to `data` in the FCM and GCM payloads. FCM and GCM [reserve certain keys](https://firebase.google.com/docs/cloud-messaging/http-server-ref) that cannot be used in those channels. For APNS, attributes of `data` are inserted into the APNS payload as custom properties outside of the `aps` dictionary. In all channels, we reserve keys that start with `twi_` for future use. Custom keys that start with `twi_` are not allowed and are rejected as 400 Bad request with no delivery attempted. For SMS, this parameter is not supported and is omitted from deliveries to those channels. */ data: any; /** - * The APNS-specific payload that overrides corresponding attributes in a generic payload for APNS Bindings + * The APNS-specific payload that overrides corresponding attributes in the generic payload for APNS Bindings. This property maps to the APNS `Payload` item, therefore the `aps` key must be used to change standard attributes. Adds custom key-value pairs to the root of the dictionary. See the [APNS documentation](https://developer.apple.com/library/content/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/CommunicatingwithAPNs.html) for more details. We reserve keys that start with `twi_` for future use. Custom keys that start with `twi_` are not allowed. */ apn: any; /** - * The GCM-specific payload that overrides corresponding attributes in generic payload for GCM Bindings + * The GCM-specific payload that overrides corresponding attributes in the generic payload for GCM Bindings. This property maps to the root JSON dictionary. Target parameters `to`, `registration_ids`, and `notification_key` are not allowed. We reserve keys that start with `twi_` for future use. Custom keys that start with `twi_` are not allowed. */ gcm: any; /** - * The FCM-specific payload that overrides corresponding attributes in generic payload for FCM Bindings + * The FCM-specific payload that overrides corresponding attributes in the generic payload for FCM Bindings. This property maps to the root JSON dictionary. See the [FCM documentation](https://firebase.google.com/docs/cloud-messaging/http-server-ref#downstream) for more details. Target parameters `to`, `registration_ids`, `condition`, and `notification_key` are not allowed in this parameter. We reserve keys that start with `twi_` for future use. Custom keys that start with `twi_` are not allowed. FCM also [reserves certain keys](https://firebase.google.com/docs/cloud-messaging/http-server-ref), which cannot be used in that channel. */ fcm: any; /** - * The SMS-specific payload that overrides corresponding attributes in generic payload for SMS Bindings + * The SMS-specific payload that overrides corresponding attributes in the generic payload for SMS Bindings. Each attribute in this value maps to the corresponding `form` parameter of the Twilio [Message](https://www.twilio.com/docs/sms/api/message-resource) resource. These parameters of the Message resource are supported in snake case format: `body`, `media_urls`, `status_callback`, and `max_price`. The `status_callback` parameter overrides the corresponding parameter in the messaging service, if configured. The `media_urls` property expects a JSON array. */ sms: any; /** - * Deprecated + * Deprecated. */ facebookMessenger: any; /** - * Deprecated + * Deprecated. */ alexa: any; diff --git a/lib/rest/numbers/v2/regulatoryCompliance/bundle.ts b/lib/rest/numbers/v2/regulatoryCompliance/bundle.ts index bf2302739b..90bda22fbe 100644 --- a/lib/rest/numbers/v2/regulatoryCompliance/bundle.ts +++ b/lib/rest/numbers/v2/regulatoryCompliance/bundle.ts @@ -421,28 +421,28 @@ export class BundleInstance { } /** - * The unique string that identifies the resource. + * The unique string that we created to identify the Bundle resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Bundle resource. */ accountSid: string; /** - * The unique string of a regulation. + * The unique string of a regulation that is associated to the Bundle resource. */ regulationSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; status: BundleStatus; /** - * The ISO 8601 date and time in GMT when the resource will be valid until. + * The date and time in GMT in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format when the resource will be valid until. */ validUntil: Date; /** - * The email address + * The email address that will receive updates when the Bundle resource changes status. */ email: string; /** @@ -450,19 +450,19 @@ export class BundleInstance { */ statusCallback: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Bundle resource + * The absolute URL of the Bundle resource. */ url: string; /** - * The URLs of the Assigned Items of the Bundle resource + * The URLs of the Assigned Items of the Bundle resource. */ links: Record; diff --git a/lib/rest/numbers/v2/regulatoryCompliance/bundle/bundleCopy.ts b/lib/rest/numbers/v2/regulatoryCompliance/bundle/bundleCopy.ts index 0bad489f65..b08d4a099d 100644 --- a/lib/rest/numbers/v2/regulatoryCompliance/bundle/bundleCopy.ts +++ b/lib/rest/numbers/v2/regulatoryCompliance/bundle/bundleCopy.ts @@ -349,40 +349,40 @@ export class BundleCopyInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Bundle resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Bundle resource. */ accountSid: string; /** - * The unique string of a regulation + * The unique string of a regulation that is associated to the Bundle resource. */ regulationSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; status: BundleCopyStatus; /** - * The ISO 8601 date and time in GMT when the resource will be valid until + * The date and time in GMT in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format when the resource will be valid until. */ validUntil: Date; /** - * The email address + * The email address that will receive updates when the Bundle resource changes status. */ email: string; /** - * The URL we call to inform your application of status changes + * The URL we call to inform your application of status changes. */ statusCallback: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; diff --git a/lib/rest/numbers/v2/regulatoryCompliance/bundle/evaluation.ts b/lib/rest/numbers/v2/regulatoryCompliance/bundle/evaluation.ts index 7e5b3a03fe..bdb4b76846 100644 --- a/lib/rest/numbers/v2/regulatoryCompliance/bundle/evaluation.ts +++ b/lib/rest/numbers/v2/regulatoryCompliance/bundle/evaluation.ts @@ -178,24 +178,24 @@ export class EvaluationInstance { } /** - * The unique string that identifies the Evaluation resource + * The unique string that identifies the Evaluation resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Bundle resource. */ accountSid: string; /** - * The unique string of a regulation + * The unique string of a regulation that is associated to the Bundle resource. */ regulationSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Bundle resource. */ bundleSid: string; status: EvaluationStatus; /** - * The results of the Evaluation resource + * The results of the Evaluation which includes the valid and invalid attributes. */ results: Array; dateCreated: Date; diff --git a/lib/rest/numbers/v2/regulatoryCompliance/bundle/itemAssignment.ts b/lib/rest/numbers/v2/regulatoryCompliance/bundle/itemAssignment.ts index 33c5b58bce..435c46a6ee 100644 --- a/lib/rest/numbers/v2/regulatoryCompliance/bundle/itemAssignment.ts +++ b/lib/rest/numbers/v2/regulatoryCompliance/bundle/itemAssignment.ts @@ -210,27 +210,27 @@ export class ItemAssignmentInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Item Assignment resource. */ sid: string; /** - * The unique string that identifies the Bundle resource. + * The unique string that we created to identify the Bundle resource. */ bundleSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Item Assignment resource. */ accountSid: string; /** - * The sid of an object bag + * The SID of an object bag that holds information of the different items. */ objectSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The absolute URL of the Identity resource + * The absolute URL of the Identity resource. */ url: string; diff --git a/lib/rest/numbers/v2/regulatoryCompliance/bundle/replaceItems.ts b/lib/rest/numbers/v2/regulatoryCompliance/bundle/replaceItems.ts index 105f0375be..cdcbcac8d3 100644 --- a/lib/rest/numbers/v2/regulatoryCompliance/bundle/replaceItems.ts +++ b/lib/rest/numbers/v2/regulatoryCompliance/bundle/replaceItems.ts @@ -173,40 +173,40 @@ export class ReplaceItemsInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Bundle resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Bundle resource. */ accountSid: string; /** - * The unique string of a regulation + * The unique string of a regulation that is associated to the Bundle resource. */ regulationSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; status: ReplaceItemsStatus; /** - * The ISO 8601 date and time in GMT when the resource will be valid until + * The date and time in GMT in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format when the resource will be valid until. */ validUntil: Date; /** - * The email address + * The email address that will receive updates when the Bundle resource changes status. */ email: string; /** - * The URL we call to inform your application of status changes + * The URL we call to inform your application of status changes. */ statusCallback: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; diff --git a/lib/rest/numbers/v2/regulatoryCompliance/endUser.ts b/lib/rest/numbers/v2/regulatoryCompliance/endUser.ts index 270b87fa29..bb473d6331 100644 --- a/lib/rest/numbers/v2/regulatoryCompliance/endUser.ts +++ b/lib/rest/numbers/v2/regulatoryCompliance/endUser.ts @@ -279,32 +279,32 @@ export class EndUserInstance { } /** - * The unique string that identifies the resource + * The unique string created by Twilio to identify the End User resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the End User resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; type: EndUserType; /** - * The set of parameters that compose the End Users resource + * The set of parameters that are the attributes of the End Users resource which are listed in the End User Types. */ attributes: any; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the End User resource + * The absolute URL of the End User resource. */ url: string; diff --git a/lib/rest/numbers/v2/regulatoryCompliance/endUserType.ts b/lib/rest/numbers/v2/regulatoryCompliance/endUserType.ts index 3fd2fc1642..e24031d073 100644 --- a/lib/rest/numbers/v2/regulatoryCompliance/endUserType.ts +++ b/lib/rest/numbers/v2/regulatoryCompliance/endUserType.ts @@ -163,23 +163,23 @@ export class EndUserTypeInstance { } /** - * The unique string that identifies the End-User Type resource + * The unique string that identifies the End-User Type resource. */ sid: string; /** - * A human-readable description of the End-User Type resource + * A human-readable description that is assigned to describe the End-User Type resource. Examples can include first name, last name, email, business name, etc */ friendlyName: string; /** - * A machine-readable description of the End-User Type resource + * A machine-readable description of the End-User Type resource. Examples can include first_name, last_name, email, business_name, etc. */ machineName: string; /** - * The required information for creating an End-User. + * The required information for creating an End-User. The required fields will change as regulatory needs change and will differ for businesses and individuals. */ fields: Array; /** - * The absolute URL of the End-User Type resource + * The absolute URL of the End-User Type resource. */ url: string; diff --git a/lib/rest/numbers/v2/regulatoryCompliance/regulation.ts b/lib/rest/numbers/v2/regulatoryCompliance/regulation.ts index d027fb5a88..ef6be48549 100644 --- a/lib/rest/numbers/v2/regulatoryCompliance/regulation.ts +++ b/lib/rest/numbers/v2/regulatoryCompliance/regulation.ts @@ -187,28 +187,28 @@ export class RegulationInstance { } /** - * The unique string that identifies the Regulation resource + * The unique string that identifies the Regulation resource. */ sid: string; /** - * A human-readable description of the Regulation resource + * A human-readable description that is assigned to describe the Regulation resource. Examples can include Germany: Mobile - Business. */ friendlyName: string; /** - * The ISO country code of the phone number\'s country + * The ISO country code of the phone number\'s country. */ isoCountry: string; /** - * The type of phone number restricted by the regulatory requirement + * The type of phone number restricted by the regulatory requirement. For example, Germany mobile phone numbers provisioned by businesses require a business name with commercial register proof from the Handelsregisterauszug and a proof of address from Handelsregisterauszug or a trade license by Gewerbeanmeldung. */ numberType: string; endUserType: RegulationEndUserType; /** - * The sid of a regulation object that dictates requirements + * The SID of an object that holds the regulatory information of the phone number country, phone number type, and end user type. */ requirements: any; /** - * The absolute URL of the Regulation resource + * The absolute URL of the Regulation resource. */ url: string; diff --git a/lib/rest/numbers/v2/regulatoryCompliance/supportingDocument.ts b/lib/rest/numbers/v2/regulatoryCompliance/supportingDocument.ts index 75d4164022..1e4271fc1f 100644 --- a/lib/rest/numbers/v2/regulatoryCompliance/supportingDocument.ts +++ b/lib/rest/numbers/v2/regulatoryCompliance/supportingDocument.ts @@ -308,19 +308,19 @@ export class SupportingDocumentInstance { } /** - * The unique string that identifies the resource + * The unique string created by Twilio to identify the Supporting Document resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Document resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The image type of the file + * The image type uploaded in the Supporting Document container. */ mimeType: string; status: SupportingDocumentStatus; @@ -329,23 +329,23 @@ export class SupportingDocumentInstance { */ failureReason: string; /** - * The type of the Supporting Document + * The type of the Supporting Document. */ type: string; /** - * The set of parameters that compose the Supporting Documents resource + * The set of parameters that are the attributes of the Supporting Documents resource which are listed in the Supporting Document Types. */ attributes: any; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Supporting Document resource + * The absolute URL of the Supporting Document resource. */ url: string; diff --git a/lib/rest/numbers/v2/regulatoryCompliance/supportingDocumentType.ts b/lib/rest/numbers/v2/regulatoryCompliance/supportingDocumentType.ts index c3f20f8015..02ed9c8855 100644 --- a/lib/rest/numbers/v2/regulatoryCompliance/supportingDocumentType.ts +++ b/lib/rest/numbers/v2/regulatoryCompliance/supportingDocumentType.ts @@ -174,23 +174,23 @@ export class SupportingDocumentTypeInstance { } /** - * The unique string that identifies the Supporting Document Type resource + * The unique string that identifies the Supporting Document Type resource. */ sid: string; /** - * A human-readable description of the Supporting Document Type resource + * A human-readable description of the Supporting Document Type resource. */ friendlyName: string; /** - * The machine-readable description of the Supporting Document Type resource + * The machine-readable description of the Supporting Document Type resource. */ machineName: string; /** - * The required information for creating a Supporting Document + * The required information for creating a Supporting Document. The required fields will change as regulatory needs change and will differ for businesses and individuals. */ fields: Array; /** - * The absolute URL of the Supporting Document Type resource + * The absolute URL of the Supporting Document Type resource. */ url: string; diff --git a/lib/rest/oauth/v1/deviceCode.ts b/lib/rest/oauth/v1/deviceCode.ts index 4c404d4f9f..da60047a46 100644 --- a/lib/rest/oauth/v1/deviceCode.ts +++ b/lib/rest/oauth/v1/deviceCode.ts @@ -146,27 +146,27 @@ export class DeviceCodeInstance { } /** - * The device verification code + * The device verification code. */ deviceCode: string; /** - * The verification code for the end user + * The verification code which end user uses to verify authorization request. */ userCode: string; /** - * The URI that the end user visits to verify request + * The URI that the end user visits to verify authorization request. */ verificationUri: string; /** - * he URI with user_code that the end-user alternatively visits to verify request + * The URI with user_code that the end-user alternatively visits to verify authorization request. */ verificationUriComplete: string; /** - * The expiration time of the device_code and user_code in seconds + * The expiration time of the device_code and user_code in seconds. */ expiresIn: number; /** - * The minimum amount of time in seconds that the client should wait between polling requests to the token endpoint + * The minimum amount of time in seconds that the client should wait between polling requests to the token endpoint. */ interval: number; diff --git a/lib/rest/oauth/v1/oauth.ts b/lib/rest/oauth/v1/oauth.ts index db120911cb..7752f30008 100644 --- a/lib/rest/oauth/v1/oauth.ts +++ b/lib/rest/oauth/v1/oauth.ts @@ -102,7 +102,7 @@ export class OauthInstance { } /** - * A collection of certificates + * A collection of certificates where are signed Twilio-issued tokens. */ keys: any; url: string; diff --git a/lib/rest/oauth/v1/openidDiscovery.ts b/lib/rest/oauth/v1/openidDiscovery.ts index 285849854e..24b8aa9a9f 100644 --- a/lib/rest/oauth/v1/openidDiscovery.ts +++ b/lib/rest/oauth/v1/openidDiscovery.ts @@ -125,51 +125,51 @@ export class OpenidDiscoveryInstance { } /** - * The issuer URL + * The URL of the party that will create the token and sign it with its private key. */ issuer: string; /** - * The URL of authorization endpoint + * The endpoint that validates all authorization requests. */ authorizationEndpoint: string; /** - * The URL of device code authorization endpoint + * The endpoint that validates all device code related authorization requests. */ deviceAuthorizationEndpoint: string; /** - * The URL of token endpoint + * The URL of the token endpoint. After a client has received an authorization code, that code is presented to the token endpoint and exchanged for an identity token, an access token, and a refresh token. */ tokenEndpoint: string; /** - * The URL of user info endpoint + * The URL of the user info endpoint, which returns user profile information to a client. Keep in mind that the user info endpoint returns only the information that has been requested. */ userinfoEndpoint: string; /** - * The URL of revocation endpoint + * The endpoint used to revoke access or refresh tokens issued by the authorization server. */ revocationEndpoint: string; /** - * The URL of public JWK endpoint + * The URL of your JSON Web Key Set. This set is a collection of JSON Web Keys, a standard method for representing cryptographic keys in a JSON structure. */ jwkUri: string; /** - * List of response type supported for identity token + * A collection of response type supported by authorization server. */ responseTypeSupported: Array; /** - * List of subject supported for identity token + * A collection of subject by authorization server. */ subjectTypeSupported: Array; /** - * List of JWS signing algorithms supported for identity token + * A collection of JWS signing algorithms supported by authorization server to sign identity token. */ idTokenSigningAlgValuesSupported: Array; /** - * List of scopes supported identity token + * A collection of scopes supported by authorization server for identity token */ scopesSupported: Array; /** - * List of claims supported for identity token + * A collection of claims supported by authorization server for identity token */ claimsSupported: Array; url: string; diff --git a/lib/rest/oauth/v1/token.ts b/lib/rest/oauth/v1/token.ts index 0da607b905..918bb2576b 100644 --- a/lib/rest/oauth/v1/token.ts +++ b/lib/rest/oauth/v1/token.ts @@ -166,20 +166,20 @@ export class TokenInstance { } /** - * Token which carries the necessary information to access a Twilio resource directly + * Token which carries the necessary information to access a Twilio resource directly. */ accessToken: string; /** - * Token which carries the information necessary to get a new access token + * Token which carries the information necessary to get a new access token. */ refreshToken: string; idToken: string; /** - * The RFC 2822 date and time in GMT when the refresh token expires + * The date and time in GMT when the refresh token expires in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ refreshTokenExpiresAt: Date; /** - * The RFC 2822 date and time in GMT when the access token expires + * The date and time in GMT when the refresh token expires in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ accessTokenExpiresAt: Date; diff --git a/lib/rest/oauth/v1/userInfo.ts b/lib/rest/oauth/v1/userInfo.ts index a2f32565fc..5b974309b8 100644 --- a/lib/rest/oauth/v1/userInfo.ts +++ b/lib/rest/oauth/v1/userInfo.ts @@ -110,23 +110,23 @@ export class UserInfoInstance { } /** - * The user sid + * The URL of the party that will create the token and sign it with its private key. */ userSid: string; /** - * The first name of the end-user + * The first name of the end-user. */ firstName: string; /** - * The last name of the end-user + * The last name of the end-user. */ lastName: string; /** - * The friendly name of the end-user + * The friendly name of the end-user. */ friendlyName: string; /** - * The end-user\'s preferred email address + * The end-user\'s preferred email address. */ email: string; url: string; diff --git a/lib/rest/preview/deployed_devices/fleet.ts b/lib/rest/preview/deployed_devices/fleet.ts index ee2187d814..1a63121ae7 100644 --- a/lib/rest/preview/deployed_devices/fleet.ts +++ b/lib/rest/preview/deployed_devices/fleet.ts @@ -319,39 +319,39 @@ export class FleetInstance { } /** - * A string that uniquely identifies this Fleet. + * Contains a 34 character string that uniquely identifies this Fleet resource. */ sid: string; /** - * URL of this Fleet. + * Contains an absolute URL for this Fleet resource. */ url: string; /** - * A unique, addressable name of this Fleet. + * Contains a unique and addressable name of this Fleet, e.g. \'default\', up to 128 characters long. */ uniqueName: string; /** - * A human readable description for this Fleet. + * Contains a human readable descriptive text for this Fleet, up to 256 characters long. */ friendlyName: string; /** - * The unique SID that identifies this Account. + * Speicifies the unique string identifier of the Account responsible for this Fleet. */ accountSid: string; /** - * The unique SID that identifies this Fleet\'s default Deployment. + * Contains the string identifier of the automatically provisioned default Deployment of this Fleet. */ defaultDeploymentSid: string; /** - * The date this Fleet was created. + * Specifies the date this Fleet was created, given in UTC ISO 8601 format. */ dateCreated: Date; /** - * The date this Fleet was updated. + * Specifies the date this Fleet was last updated, given in UTC ISO 8601 format. */ dateUpdated: Date; /** - * Nested resource URLs. + * Contains a dictionary of URL links to nested resources of this Fleet. */ links: Record; diff --git a/lib/rest/preview/deployed_devices/fleet/certificate.ts b/lib/rest/preview/deployed_devices/fleet/certificate.ts index b1e23a9211..788abbc0a7 100644 --- a/lib/rest/preview/deployed_devices/fleet/certificate.ts +++ b/lib/rest/preview/deployed_devices/fleet/certificate.ts @@ -309,39 +309,39 @@ export class CertificateInstance { } /** - * A string that uniquely identifies this Certificate. + * Contains a 34 character string that uniquely identifies this Certificate credential resource. */ sid: string; /** - * URL of this Certificate. + * Contains an absolute URL for this Certificate credential resource. */ url: string; /** - * A human readable description for this Certificate. + * Contains a human readable descriptive text for this Certificate credential, up to 256 characters long. */ friendlyName: string; /** - * The unique identifier of the Fleet. + * Specifies the unique string identifier of the Fleet that the given Certificate credential belongs to. */ fleetSid: string; /** - * The unique SID that identifies this Account. + * Specifies the unique string identifier of the Account responsible for this Certificate credential. */ accountSid: string; /** - * The unique identifier of a mapped Device. + * Specifies the unique string identifier of a Device authenticated with this Certificate credential. */ deviceSid: string; /** - * A Certificate unique payload hash. + * Contains a unique hash of the payload of this Certificate credential, used to authenticate the Device. */ thumbprint: string; /** - * The date this Certificate was created. + * Specifies the date this Certificate credential was created, given in UTC ISO 8601 format. */ dateCreated: Date; /** - * The date this Certificate was updated. + * Specifies the date this Certificate credential was last updated, given in UTC ISO 8601 format. */ dateUpdated: Date; diff --git a/lib/rest/preview/deployed_devices/fleet/deployment.ts b/lib/rest/preview/deployed_devices/fleet/deployment.ts index 30af14b4fc..21c07750bc 100644 --- a/lib/rest/preview/deployed_devices/fleet/deployment.ts +++ b/lib/rest/preview/deployed_devices/fleet/deployment.ts @@ -299,35 +299,35 @@ export class DeploymentInstance { } /** - * A string that uniquely identifies this Deployment. + * Contains a 34 character string that uniquely identifies this Deployment resource. */ sid: string; /** - * URL of this Deployment. + * Contains an absolute URL for this Deployment resource. */ url: string; /** - * A human readable description for this Deployment + * Contains a human readable descriptive text for this Deployment, up to 64 characters long */ friendlyName: string; /** - * The unique identifier of the Fleet. + * Specifies the unique string identifier of the Fleet that the given Deployment belongs to. */ fleetSid: string; /** - * The unique SID that identifies this Account. + * Specifies the unique string identifier of the Account responsible for this Deployment. */ accountSid: string; /** - * The unique identifier of the Sync service instance. + * Specifies the unique string identifier of the Twilio Sync service instance linked to and accessible by this Deployment. */ syncServiceSid: string; /** - * The date this Deployment was created. + * Specifies the date this Deployment was created, given in UTC ISO 8601 format. */ dateCreated: Date; /** - * The date this Deployment was updated. + * Specifies the date this Deployment was last updated, given in UTC ISO 8601 format. */ dateUpdated: Date; diff --git a/lib/rest/preview/deployed_devices/fleet/device.ts b/lib/rest/preview/deployed_devices/fleet/device.ts index ef05ba821f..f6ad90ac4d 100644 --- a/lib/rest/preview/deployed_devices/fleet/device.ts +++ b/lib/rest/preview/deployed_devices/fleet/device.ts @@ -328,51 +328,51 @@ export class DeviceInstance { } /** - * A string that uniquely identifies this Device. + * Contains a 34 character string that uniquely identifies this Device resource. */ sid: string; /** - * URL of this Device. + * Contains an absolute URL for this Device resource. */ url: string; /** - * A unique, addressable name of this Device. + * Contains a unique and addressable name of this Device, assigned by the developer, up to 128 characters long. */ uniqueName: string; /** - * A human readable description for this Device + * Contains a human readable descriptive text for this Device, up to 256 characters long */ friendlyName: string; /** - * The unique identifier of the Fleet. + * Specifies the unique string identifier of the Fleet that the given Device belongs to. */ fleetSid: string; /** - * Device enabled flag. + * Contains a boolean flag indicating whether the device is enabled or not, blocks device connectivity if set to false. */ enabled: boolean; /** - * The unique SID that identifies this Account. + * Specifies the unique string identifier of the Account responsible for this Device. */ accountSid: string; /** - * An identifier of the Device user. + * Contains an arbitrary string identifier representing a human user associated with this Device, assigned by the developer, up to 256 characters long. */ identity: string; /** - * The unique SID of the Deployment group. + * Specifies the unique string identifier of the Deployment group that this Device is associated with. */ deploymentSid: string; /** - * The date this Device was created. + * Specifies the date this Device was created, given in UTC ISO 8601 format. */ dateCreated: Date; /** - * The date this Device was updated. + * Specifies the date this Device was last updated, given in UTC ISO 8601 format. */ dateUpdated: Date; /** - * The date this Device was authenticated. + * Specifies the date this Device was last authenticated, given in UTC ISO 8601 format. */ dateAuthenticated: Date; diff --git a/lib/rest/preview/deployed_devices/fleet/key.ts b/lib/rest/preview/deployed_devices/fleet/key.ts index 2d6a4f9d75..0d334f582b 100644 --- a/lib/rest/preview/deployed_devices/fleet/key.ts +++ b/lib/rest/preview/deployed_devices/fleet/key.ts @@ -307,39 +307,39 @@ export class KeyInstance { } /** - * A string that uniquely identifies this Key. + * Contains a 34 character string that uniquely identifies this Key credential resource. */ sid: string; /** - * URL of this Key. + * Contains an absolute URL for this Key credential resource. */ url: string; /** - * A human readable description for this Key. + * Contains a human readable descriptive text for this Key credential, up to 256 characters long. */ friendlyName: string; /** - * The unique identifier of the Fleet. + * Specifies the unique string identifier of the Fleet that the given Key credential belongs to. */ fleetSid: string; /** - * The unique SID that identifies this Account. + * Specifies the unique string identifier of the Account responsible for this Key credential. */ accountSid: string; /** - * The unique identifier of a mapped Device. + * Specifies the unique string identifier of a Device authenticated with this Key credential. */ deviceSid: string; /** - * The key secret. + * Contains the automatically generated secret belonging to this Key credential, used to authenticate the Device. */ secret: string; /** - * The date this Key credential was created. + * Specifies the date this Key credential was created, given in UTC ISO 8601 format. */ dateCreated: Date; /** - * The date this Key credential was updated. + * Specifies the date this Key credential was last updated, given in UTC ISO 8601 format. */ dateUpdated: Date; diff --git a/lib/rest/preview/hosted_numbers/authorizationDocument.ts b/lib/rest/preview/hosted_numbers/authorizationDocument.ts index 6bd6e83d0d..2ba09d9106 100644 --- a/lib/rest/preview/hosted_numbers/authorizationDocument.ts +++ b/lib/rest/preview/hosted_numbers/authorizationDocument.ts @@ -341,28 +341,28 @@ export class AuthorizationDocumentInstance { } /** - * AuthorizationDocument sid. + * A 34 character string that uniquely identifies this AuthorizationDocument. */ sid: string; /** - * Address sid. + * A 34 character string that uniquely identifies the Address resource that is associated with this AuthorizationDocument. */ addressSid: string; status: AuthorizationDocumentStatus; /** - * Email. + * Email that this AuthorizationDocument will be sent to for signing. */ email: string; /** - * A list of emails. + * Email recipients who will be informed when an Authorization Document has been sent and signed. */ ccEmails: Array; /** - * The date this AuthorizationDocument was created. + * The date this resource was created, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The date this AuthorizationDocument was updated. + * The date that this resource was updated, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; url: string; diff --git a/lib/rest/preview/hosted_numbers/authorizationDocument/dependentHostedNumberOrder.ts b/lib/rest/preview/hosted_numbers/authorizationDocument/dependentHostedNumberOrder.ts index 2078375370..81f23a8907 100644 --- a/lib/rest/preview/hosted_numbers/authorizationDocument/dependentHostedNumberOrder.ts +++ b/lib/rest/preview/hosted_numbers/authorizationDocument/dependentHostedNumberOrder.ts @@ -383,74 +383,74 @@ export class DependentHostedNumberOrderInstance { } /** - * HostedNumberOrder sid. + * A 34 character string that uniquely identifies this Authorization Document */ sid: string; /** - * Account sid. + * The unique SID identifier of the Account. */ accountSid: string; /** - * IncomingPhoneNumber sid. + * A 34 character string that uniquely identifies the IncomingPhoneNumber resource created by this HostedNumberOrder. */ incomingPhoneNumberSid: string; /** - * Address sid. + * A 34 character string that uniquely identifies the Address resource that represents the address of the owner of this phone number. */ addressSid: string; /** - * LOA document sid. + * A 34 character string that uniquely identifies the LOA document associated with this HostedNumberOrder. */ signingDocumentSid: string; /** - * An E164 formatted phone number. + * An E164 formatted phone number hosted by this HostedNumberOrder. */ phoneNumber: string; capabilities: PhoneNumberCapabilities; /** - * A human readable description of this resource. + * A human readable description of this resource, up to 64 characters. */ friendlyName: string; /** - * A unique, developer assigned name of this HostedNumberOrder. + * Provides a unique and addressable name to be assigned to this HostedNumberOrder, assigned by the developer, to be optionally used in addition to SID. */ uniqueName: string; status: DependentHostedNumberOrderStatus; /** - * Why a hosted_number_order reached status \"action-required\" + * A message that explains why a hosted_number_order went to status \"action-required\" */ failureReason: string; /** - * The date this HostedNumberOrder was created. + * The date this resource was created, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The date this HostedNumberOrder was updated. + * The date that this resource was updated, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The number of attempts made to verify ownership of the phone number. + * The number of attempts made to verify ownership of the phone number that is being hosted. */ verificationAttempts: number; /** - * Email. + * Email of the owner of this phone number that is being hosted. */ email: string; /** - * A list of emails. + * Email recipients who will be informed when an Authorization Document has been sent and signed */ ccEmails: Array; verificationType: DependentHostedNumberOrderVerificationType; /** - * Verification Document Sid. + * A 34 character string that uniquely identifies the Identity Document resource that represents the document for verifying ownership of the number to be hosted. */ verificationDocumentSid: string; /** - * Phone extension to use for ownership verification call. + * A numerical extension to be used when making the ownership verification call. */ extension: string; /** - * Seconds (0-30) to delay ownership verification call by. + * A value between 0-30 specifying the number of seconds to delay initiating the ownership verification call. */ callDelay: number; /** @@ -458,7 +458,7 @@ export class DependentHostedNumberOrderInstance { */ verificationCode: string; /** - * List of IDs for ownership verification calls. + * A list of 34 character strings that are unique identifiers for the calls placed as part of ownership verification. */ verificationCallSids: Array; diff --git a/lib/rest/preview/hosted_numbers/hostedNumberOrder.ts b/lib/rest/preview/hosted_numbers/hostedNumberOrder.ts index 8d38ae58d0..f1b3beaaa8 100644 --- a/lib/rest/preview/hosted_numbers/hostedNumberOrder.ts +++ b/lib/rest/preview/hosted_numbers/hostedNumberOrder.ts @@ -426,61 +426,61 @@ export class HostedNumberOrderInstance { } /** - * HostedNumberOrder sid. + * A 34 character string that uniquely identifies this HostedNumberOrder. */ sid: string; /** - * Account Sid. + * A 34 character string that uniquely identifies the account. */ accountSid: string; /** - * IncomingPhoneNumber sid. + * A 34 character string that uniquely identifies the [IncomingPhoneNumber](https://www.twilio.com/docs/api/rest/incoming-phone-numbers) resource that represents the phone number being hosted. */ incomingPhoneNumberSid: string; /** - * Address sid. + * A 34 character string that uniquely identifies the Address resource that represents the address of the owner of this phone number. */ addressSid: string; /** - * LOA document sid. + * A 34 character string that uniquely identifies the [Authorization Document](https://www.twilio.com/docs/api/phone-numbers/hosted-number-authorization-documents) the user needs to sign. */ signingDocumentSid: string; /** - * An E164 formatted phone number. + * Phone number to be hosted. This must be in [E.164](https://en.wikipedia.org/wiki/E.164) format, e.g., +16175551212 */ phoneNumber: string; capabilities: PhoneNumberCapabilities; /** - * A human readable description of this resource. + * A 64 character string that is a human-readable text that describes this resource. */ friendlyName: string; /** - * A unique, developer assigned name of this HostedNumberOrder. + * Provides a unique and addressable name to be assigned to this HostedNumberOrder, assigned by the developer, to be optionally used in addition to SID. */ uniqueName: string; status: HostedNumberOrderStatus; /** - * Why a hosted_number_order reached status \"action-required\" + * A message that explains why a hosted_number_order went to status \"action-required\" */ failureReason: string; /** - * The date this HostedNumberOrder was created. + * The date this resource was created, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The date this HostedNumberOrder was updated. + * The date that this resource was updated, given as [GMT RFC 2822](http://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The number of attempts made to verify ownership of the phone number. + * The number of attempts made to verify ownership of the phone number that is being hosted. */ verificationAttempts: number; /** - * Email. + * Email of the owner of this phone number that is being hosted. */ email: string; /** - * A list of emails. + * A list of emails that LOA document for this HostedNumberOrder will be carbon copied to. */ ccEmails: Array; /** @@ -489,23 +489,23 @@ export class HostedNumberOrderInstance { url: string; verificationType: HostedNumberOrderVerificationType; /** - * Verification Document Sid. + * A 34 character string that uniquely identifies the Identity Document resource that represents the document for verifying ownership of the number to be hosted. */ verificationDocumentSid: string; /** - * Phone extension to use for ownership verification call. + * A numerical extension to be used when making the ownership verification call. */ extension: string; /** - * Seconds (0-30) to delay ownership verification call by. + * A value between 0-30 specifying the number of seconds to delay initiating the ownership verification call. */ callDelay: number; /** - * The digits passed during the ownership verification call. + * A verification code provided in the response for a user to enter when they pick up the phone call. */ verificationCode: string; /** - * List of IDs for ownership verification calls. + * A list of 34 character strings that are unique identifiers for the calls placed as part of ownership verification. */ verificationCallSids: Array; diff --git a/lib/rest/preview/marketplace/availableAddOn.ts b/lib/rest/preview/marketplace/availableAddOn.ts index 900b98ef22..50345400ea 100644 --- a/lib/rest/preview/marketplace/availableAddOn.ts +++ b/lib/rest/preview/marketplace/availableAddOn.ts @@ -182,31 +182,31 @@ export class AvailableAddOnInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the AvailableAddOn resource. */ sid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * A short description of the Add-on\'s functionality + * A short description of the Add-on\'s functionality. */ description: string; /** - * How customers are charged for using this Add-on + * How customers are charged for using this Add-on. */ pricingType: string; /** - * The JSON object with the configuration that must be provided when installing a given Add-on + * The JSON object with the configuration that must be provided when installing a given Add-on. */ configurationSchema: any; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/preview/marketplace/availableAddOn/availableAddOnExtension.ts b/lib/rest/preview/marketplace/availableAddOn/availableAddOnExtension.ts index 88169eae81..ae2b742c54 100644 --- a/lib/rest/preview/marketplace/availableAddOn/availableAddOnExtension.ts +++ b/lib/rest/preview/marketplace/availableAddOn/availableAddOnExtension.ts @@ -187,27 +187,27 @@ export class AvailableAddOnExtensionInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the AvailableAddOnExtension resource. */ sid: string; /** - * The SID of the AvailableAddOn resource to which this extension applies + * The SID of the AvailableAddOn resource to which this extension applies. */ availableAddOnSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The name of the Extension\'s Product + * The name of the Product this Extension is used within. */ productName: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. */ uniqueName: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/preview/marketplace/installedAddOn.ts b/lib/rest/preview/marketplace/installedAddOn.ts index 76a3dac81e..d1ec97b731 100644 --- a/lib/rest/preview/marketplace/installedAddOn.ts +++ b/lib/rest/preview/marketplace/installedAddOn.ts @@ -310,43 +310,43 @@ export class InstalledAddOnInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the InstalledAddOn resource. This Sid can also be found in the Console on that specific Add-ons page as the \'Available Add-on Sid\'. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the InstalledAddOn resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * A short description of the Add-on\'s functionality + * A short description of the Add-on\'s functionality. */ description: string; /** - * The JSON object that represents the current configuration of installed Add-on + * The JSON object that represents the current configuration of installed Add-on. */ configuration: any; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. */ uniqueName: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/preview/marketplace/installedAddOn/installedAddOnExtension.ts b/lib/rest/preview/marketplace/installedAddOn/installedAddOnExtension.ts index f6a81967b7..602e5667e6 100644 --- a/lib/rest/preview/marketplace/installedAddOn/installedAddOnExtension.ts +++ b/lib/rest/preview/marketplace/installedAddOn/installedAddOnExtension.ts @@ -260,31 +260,31 @@ export class InstalledAddOnExtensionInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the InstalledAddOn Extension resource. */ sid: string; /** - * The SID of the InstalledAddOn resource to which this extension applies + * The SID of the InstalledAddOn resource to which this extension applies. */ installedAddOnSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The name of the Extension\'s Product + * The name of the Product this Extension is used within. */ productName: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. */ uniqueName: string; /** - * Whether the Extension will be invoked + * Whether the Extension will be invoked. */ enabled: boolean; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/preview/sync/service/document/documentPermission.ts b/lib/rest/preview/sync/service/document/documentPermission.ts index b94b967874..ef4c458b76 100644 --- a/lib/rest/preview/sync/service/document/documentPermission.ts +++ b/lib/rest/preview/sync/service/document/documentPermission.ts @@ -307,35 +307,35 @@ export class DocumentPermissionInstance { } /** - * Twilio Account SID. + * The unique SID identifier of the Twilio Account. */ accountSid: string; /** - * Sync Service Instance SID. + * The unique SID identifier of the Sync Service Instance. */ serviceSid: string; /** - * Sync Document SID. + * The unique SID identifier of the Sync Document to which the Permission applies. */ documentSid: string; /** - * Identity of the user to whom the Sync Document Permission applies. + * Arbitrary string identifier representing a human user associated with an FPA token, assigned by the developer. */ identity: string; /** - * Read access. + * Boolean flag specifying whether the identity can read the Sync Document. */ read: boolean; /** - * Write access. + * Boolean flag specifying whether the identity can update the Sync Document. */ write: boolean; /** - * Manage access. + * Boolean flag specifying whether the identity can delete the Sync Document. */ manage: boolean; /** - * URL of this Sync Document Permission. + * Contains an absolute URL for this Sync Document Permission. */ url: string; diff --git a/lib/rest/preview/sync/service/syncList/syncListPermission.ts b/lib/rest/preview/sync/service/syncList/syncListPermission.ts index 91d0b63cb2..556dd378da 100644 --- a/lib/rest/preview/sync/service/syncList/syncListPermission.ts +++ b/lib/rest/preview/sync/service/syncList/syncListPermission.ts @@ -307,35 +307,35 @@ export class SyncListPermissionInstance { } /** - * Twilio Account SID. + * The unique SID identifier of the Twilio Account. */ accountSid: string; /** - * Sync Service Instance SID. + * The unique SID identifier of the Sync Service Instance. */ serviceSid: string; /** - * Sync List SID. + * The unique SID identifier of the Sync List to which the Permission applies. */ listSid: string; /** - * Identity of the user to whom the Sync List Permission applies. + * Arbitrary string identifier representing a human user associated with an FPA token, assigned by the developer. */ identity: string; /** - * Read access. + * Boolean flag specifying whether the identity can read the Sync List and its Items. */ read: boolean; /** - * Write access. + * Boolean flag specifying whether the identity can create, update and delete Items of the Sync List. */ write: boolean; /** - * Manage access. + * Boolean flag specifying whether the identity can delete the Sync List. */ manage: boolean; /** - * URL of this Sync List Permission. + * Contains an absolute URL for this Sync List Permission. */ url: string; diff --git a/lib/rest/preview/sync/service/syncMap/syncMapPermission.ts b/lib/rest/preview/sync/service/syncMap/syncMapPermission.ts index 15fc4febbd..e2df61e773 100644 --- a/lib/rest/preview/sync/service/syncMap/syncMapPermission.ts +++ b/lib/rest/preview/sync/service/syncMap/syncMapPermission.ts @@ -305,35 +305,35 @@ export class SyncMapPermissionInstance { } /** - * Twilio Account SID. + * The unique SID identifier of the Twilio Account. */ accountSid: string; /** - * Sync Service Instance SID. + * The unique SID identifier of the Sync Service Instance. */ serviceSid: string; /** - * Sync Map SID. + * The unique SID identifier of the Sync Map to which the Permission applies. */ mapSid: string; /** - * Identity of the user to whom the Sync Map Permission applies. + * Arbitrary string identifier representing a human user associated with an FPA token, assigned by the developer. */ identity: string; /** - * Read access. + * Boolean flag specifying whether the identity can read the Sync Map and its Items. */ read: boolean; /** - * Write access. + * Boolean flag specifying whether the identity can create, update and delete Items of the Sync Map. */ write: boolean; /** - * Manage access. + * Boolean flag specifying whether the identity can delete the Sync Map. */ manage: boolean; /** - * URL of this Sync Map Permission. + * Contains an absolute URL for this Sync Map Permission. */ url: string; diff --git a/lib/rest/preview/understand/assistant/task/field.ts b/lib/rest/preview/understand/assistant/task/field.ts index 766c90a95b..55edb15383 100644 --- a/lib/rest/preview/understand/assistant/task/field.ts +++ b/lib/rest/preview/understand/assistant/task/field.ts @@ -239,7 +239,7 @@ export class FieldInstance { */ dateUpdated: Date; /** - * 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 any [Built-in Field Type](https://www.twilio.com/docs/assistant/api/built-in-field-types) or the unique_name or sid of a custom Field Type. */ fieldType: string; /** diff --git a/lib/rest/preview/understand/assistant/task/sample.ts b/lib/rest/preview/understand/assistant/task/sample.ts index 5e22d1c26d..6ae6d01734 100644 --- a/lib/rest/preview/understand/assistant/task/sample.ts +++ b/lib/rest/preview/understand/assistant/task/sample.ts @@ -356,7 +356,7 @@ export class SampleInstance { taggedText: string; url: string; /** - * The communication channel 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 the sample was captured. It can be: *voice*, *sms*, *chat*, *alexa*, *google-assistant*, or *slack*. If not included the value will be null */ sourceChannel: string; diff --git a/lib/rest/pricing/v1/messaging/country.ts b/lib/rest/pricing/v1/messaging/country.ts index c3d814ee22..72cf4eea23 100644 --- a/lib/rest/pricing/v1/messaging/country.ts +++ b/lib/rest/pricing/v1/messaging/country.ts @@ -184,27 +184,27 @@ export class CountryInstance { } /** - * The name of the country + * The name of the country. */ country: string; /** - * The ISO country code + * The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). */ isoCountry: string; /** - * The list of OutboundSMSPrice records + * The list of [OutboundSMSPrice](https://www.twilio.com/docs/sms/api/pricing#outbound-sms-price) records that represent the price to send a message for each MCC/MNC applicable in this country. */ outboundSmsPrices: Array; /** - * The list of InboundPrice records + * The list of [InboundPrice](https://www.twilio.com/docs/sms/api/pricing#inbound-price) records that describe the price to receive an inbound SMS to the different Twilio phone number types supported in this country */ inboundSmsPrices: Array; /** - * The currency in which prices are measured, in ISO 4127 format (e.g. usd, eur, jpy) + * The currency in which prices are measured, specified in [ISO 4127](http://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). */ priceUnit: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/pricing/v1/phoneNumber/country.ts b/lib/rest/pricing/v1/phoneNumber/country.ts index 57346771bc..6d6c45639a 100644 --- a/lib/rest/pricing/v1/phoneNumber/country.ts +++ b/lib/rest/pricing/v1/phoneNumber/country.ts @@ -169,23 +169,23 @@ export class CountryInstance { } /** - * The name of the country + * The name of the country. */ country: string; /** - * The ISO country code + * The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). */ isoCountry: string; /** - * The list of PhoneNumberPrices records + * The list of [PhoneNumberPrice](https://www.twilio.com/docs/phone-numbers/pricing#phone-number-price) records. */ phoneNumberPrices: Array; /** - * The currency in which prices are measured, in ISO 4127 format (e.g. usd, eur, jpy) + * The currency in which prices are measured, specified in [ISO 4127](http://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). */ priceUnit: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/pricing/v1/voice/country.ts b/lib/rest/pricing/v1/voice/country.ts index 6e7d03118b..0b62639675 100644 --- a/lib/rest/pricing/v1/voice/country.ts +++ b/lib/rest/pricing/v1/voice/country.ts @@ -178,27 +178,27 @@ export class CountryInstance { } /** - * The name of the country + * The name of the country. */ country: string; /** - * The ISO country code + * The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). */ isoCountry: string; /** - * The list of OutboundPrefixPrice records + * The list of OutboundPrefixPrice records, which include a list of the `prefixes`, the `friendly_name`, `base_price`, and the `current_price` for those prefixes. */ outboundPrefixPrices: Array; /** - * The list of InboundCallPrice records + * The list of [InboundCallPrice](https://www.twilio.com/docs/voice/pricing#inbound-call-price) records. */ inboundCallPrices: Array; /** - * The currency in which prices are measured, in ISO 4127 format (e.g. usd, eur, jpy) + * The currency in which prices are measured, specified in [ISO 4127](http://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). */ priceUnit: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/pricing/v1/voice/number.ts b/lib/rest/pricing/v1/voice/number.ts index c50fac4bbf..6b24f76f2e 100644 --- a/lib/rest/pricing/v1/voice/number.ts +++ b/lib/rest/pricing/v1/voice/number.ts @@ -19,7 +19,7 @@ const serialize = require("../../../../base/serialize"); import { isValidPathParam } from "../../../../base/utility"; /** - * The InboundCallPrice record + * The [InboundCallPrice](https://www.twilio.com/docs/voice/pricing#inbound-call-price) record. If `null`, the Phone Number is not a Twilio number owned by this account. */ export class PricingV1VoiceVoiceNumberInboundCallPrice { "basePrice"?: number; @@ -28,7 +28,7 @@ export class PricingV1VoiceVoiceNumberInboundCallPrice { } /** - * The OutboundCallPrice record + * The OutboundCallPrice record, which includes a list of `origination_prefixes` and the `base_price` and `current_price` for those prefixes. */ export class PricingV1VoiceVoiceNumberOutboundCallPrice { "basePrice"?: number; @@ -140,25 +140,25 @@ export class NumberInstance { } /** - * The phone number + * The phone number. */ number: string; /** - * The name of the country + * The name of the country. */ country: string; /** - * The ISO country code + * The [ISO country code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). */ isoCountry: string; outboundCallPrice: PricingV1VoiceVoiceNumberOutboundCallPrice; inboundCallPrice: PricingV1VoiceVoiceNumberInboundCallPrice; /** - * The currency in which prices are measured, in ISO 4127 format (e.g. usd, eur, jpy) + * The currency in which prices are measured, specified in [ISO 4127](http://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). */ priceUnit: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/pricing/v2/country.ts b/lib/rest/pricing/v2/country.ts index 0763f04c93..8a31b21293 100644 --- a/lib/rest/pricing/v2/country.ts +++ b/lib/rest/pricing/v2/country.ts @@ -179,27 +179,27 @@ export class CountryInstance { } /** - * The name of the country + * The name of the country. */ country: string; /** - * The ISO country code + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). */ isoCountry: string; /** - * The list of TerminatingPrefixPrice records + * The list of [TerminatingPrefixPrice](https://www.twilio.com/docs/voice/pricing#outbound-prefix-price-with-origin) records. */ terminatingPrefixPrices: Array; /** - * The list of OriginatingCallPrice records + * The list of [OriginatingCallPrice](https://www.twilio.com/docs/voice/pricing#inbound-call-price) records. */ originatingCallPrices: Array; /** - * The currency in which prices are measured, in ISO 4127 format (e.g. usd, eur, jpy) + * The currency in which prices are measured, specified in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). */ priceUnit: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/pricing/v2/number.ts b/lib/rest/pricing/v2/number.ts index 0925fa48f9..7670572a1b 100644 --- a/lib/rest/pricing/v2/number.ts +++ b/lib/rest/pricing/v2/number.ts @@ -27,7 +27,7 @@ export class PricingV2TrunkingCountryInstanceTerminatingPrefixPrices { } /** - * The OriginatingCallPrice record + * The [OriginatingCallPrice](https://www.twilio.com/docs/voice/pricing#inbound-call-price) record. */ export class PricingV2TrunkingNumberOriginatingCallPrice { "basePrice"?: number; @@ -187,29 +187,29 @@ export class NumberInstance { } /** - * The destination phone number, in E.164 format + * The destination phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ destinationNumber: string; /** - * The origination phone number, in E.164 format + * The origination phone number in [[E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ originationNumber: string; /** - * The name of the country + * The name of the country. */ country: string; /** - * The ISO country code + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) */ isoCountry: string; terminatingPrefixPrices: Array; originatingCallPrice: PricingV2TrunkingNumberOriginatingCallPrice; /** - * The currency in which prices are measured, in ISO 4127 format (e.g. usd, eur, jpy) + * The currency in which prices are measured, specified in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). */ priceUnit: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/pricing/v2/voice/country.ts b/lib/rest/pricing/v2/voice/country.ts index 2cdc097403..19c6394200 100644 --- a/lib/rest/pricing/v2/voice/country.ts +++ b/lib/rest/pricing/v2/voice/country.ts @@ -179,27 +179,27 @@ export class CountryInstance { } /** - * The name of the country + * The name of the country. */ country: string; /** - * The ISO country code + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). */ isoCountry: string; /** - * The list of OutboundPrefixPriceWithOrigin records + * The list of [OutboundPrefixPriceWithOrigin](https://www.twilio.com/docs/voice/pricing#outbound-prefix-price-with-origin) records. */ outboundPrefixPrices: Array; /** - * The list of InboundCallPrice records + * The list of [InboundCallPrice](https://www.twilio.com/docs/voice/pricing#inbound-call-price) records. */ inboundCallPrices: Array; /** - * The currency in which prices are measured, in ISO 4127 format (e.g. usd, eur, jpy) + * The currency in which prices are measured, specified in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). */ priceUnit: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/pricing/v2/voice/number.ts b/lib/rest/pricing/v2/voice/number.ts index 997918fa50..546129ecf0 100644 --- a/lib/rest/pricing/v2/voice/number.ts +++ b/lib/rest/pricing/v2/voice/number.ts @@ -19,7 +19,7 @@ const serialize = require("../../../../base/serialize"); import { isValidPathParam } from "../../../../base/utility"; /** - * The InboundCallPrice record + * The [InboundCallPrice](https://www.twilio.com/docs/voice/pricing#inbound-call-price) record. */ export class PricingV2VoiceVoiceNumberInboundCallPrice { "basePrice"?: number; @@ -185,32 +185,32 @@ export class NumberInstance { } /** - * The destination phone number, in E.164 format + * The destination phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ destinationNumber: string; /** - * The origination phone number, in E.164 format + * The origination phone number in [[E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ originationNumber: string; /** - * The name of the country + * The name of the country. */ country: string; /** - * The ISO country code + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) */ isoCountry: string; /** - * The list of OutboundCallPriceWithOrigin records + * The list of [OutboundCallPriceWithOrigin](https://www.twilio.com/docs/voice/pricing#outbound-call-price-with-origin) records. */ outboundCallPrices: Array; inboundCallPrice: PricingV2VoiceVoiceNumberInboundCallPrice; /** - * The currency in which prices are measured, in ISO 4127 format (e.g. usd, eur, jpy) + * The currency in which prices are measured, specified in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`). */ priceUnit: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/proxy/v1/service.ts b/lib/rest/proxy/v1/service.ts index 35ace8e7ac..609bf00046 100644 --- a/lib/rest/proxy/v1/service.ts +++ b/lib/rest/proxy/v1/service.ts @@ -358,53 +358,53 @@ export class ServiceInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Service resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. This value must be 191 characters or fewer in length and be unique. Supports UTF-8 characters. **This value should not have PII.** */ uniqueName: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource. */ accountSid: string; /** - * The SID of the Chat Service Instance + * The SID of the Chat Service Instance managed by Proxy Service. The Chat Service enables Proxy to forward SMS and channel messages to this chat instance. This is a one-to-one relationship. */ chatInstanceSid: string; /** - * The URL we call when the interaction status changes + * The URL we call when the interaction status changes. */ callbackUrl: string; /** - * Default TTL for a Session, in seconds + * The default `ttl` value for Sessions created in the Service. The TTL (time to live) is measured in seconds after the Session\'s last create or last Interaction. The default value of `0` indicates an unlimited Session length. You can override a Session\'s default TTL value by setting its `ttl` value. */ defaultTtl: number; numberSelectionBehavior: ServiceNumberSelectionBehavior; geoMatchLevel: ServiceGeoMatchLevel; /** - * The URL we call on each interaction + * The URL we call on each interaction. If we receive a 403 status, we block the interaction; otherwise the interaction continues. */ interceptCallbackUrl: string; /** - * The URL we call when an inbound call or SMS action occurs on a closed or non-existent Session + * The URL we call when an inbound call or SMS action occurs on a closed or non-existent Session. If your server (or a Twilio [function](https://www.twilio.com/functions)) responds with valid [TwiML](https://www.twilio.com/docs/voice/twiml), we will process it. This means it is possible, for example, to play a message for a call, send an automated text message response, or redirect a call to another Phone Number. See [Out-of-Session Callback Response Guide](https://www.twilio.com/docs/proxy/out-session-callback-response-guide) for more information. */ outOfSessionCallbackUrl: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was created. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated. */ dateUpdated: Date; /** - * The absolute URL of the Service resource + * The absolute URL of the Service resource. */ url: string; /** - * The URLs of resources related to the Service + * The URLs of resources related to the Service. */ links: Record; diff --git a/lib/rest/proxy/v1/service/phoneNumber.ts b/lib/rest/proxy/v1/service/phoneNumber.ts index e3eeef753f..d4689b4e74 100644 --- a/lib/rest/proxy/v1/service/phoneNumber.ts +++ b/lib/rest/proxy/v1/service/phoneNumber.ts @@ -302,48 +302,48 @@ export class PhoneNumberInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the PhoneNumber resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the PhoneNumber resource. */ accountSid: string; /** - * The SID of the PhoneNumber resource\'s parent Service resource + * The SID of the PhoneNumber resource\'s parent [Service](https://www.twilio.com/docs/proxy/api/service) resource. */ serviceSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was created. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated. */ dateUpdated: Date; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The ISO Country Code + * The ISO Country Code for the phone number. */ isoCountry: string; capabilities: PhoneNumberCapabilities; /** - * The absolute URL of the PhoneNumber resource + * The absolute URL of the PhoneNumber resource. */ url: string; /** - * Reserve the phone number for manual assignment to participants only + * Whether the phone number should be reserved and not be assigned to a participant using proxy pool logic. See [Reserved Phone Numbers](https://www.twilio.com/docs/proxy/reserved-phone-numbers) for more information. */ isReserved: boolean; /** - * The number of open session assigned to the number. + * The number of open session assigned to the number. See the [How many Phone Numbers do I need?](https://www.twilio.com/docs/proxy/phone-numbers-needed) guide for more information. */ inUse: number; diff --git a/lib/rest/proxy/v1/service/session.ts b/lib/rest/proxy/v1/service/session.ts index 704ba68d4c..5b8b0360bf 100644 --- a/lib/rest/proxy/v1/service/session.ts +++ b/lib/rest/proxy/v1/service/session.ts @@ -357,61 +357,61 @@ export class SessionInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Session resource. */ sid: string; /** - * The SID of the resource\'s parent Service + * The SID of the [Service](https://www.twilio.com/docs/proxy/api/service) the session is associated with. */ serviceSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Session resource. */ accountSid: string; /** - * The ISO 8601 date when the Session started + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date when the Session started. */ dateStarted: Date; /** - * The ISO 8601 date when the Session ended + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date when the Session ended. */ dateEnded: Date; /** - * The ISO 8601 date when the Session last had an interaction + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date when the Session last had an interaction. */ dateLastInteraction: Date; /** - * The ISO 8601 date when the Session should expire + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date when the Session should expire. If this is value is present, it overrides the `ttl` value. */ dateExpiry: Date; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. This value must be 191 characters or fewer in length and be unique. Supports UTF-8 characters. **This value should not have PII.** */ uniqueName: string; status: SessionStatus; /** - * The reason the Session ended + * The reason the Session ended. */ closedReason: string; /** - * When the session will expire + * The time, in seconds, when the session will expire. The time is measured from the last Session create or the Session\'s last Interaction. */ ttl: number; mode: SessionMode; /** - * The ISO 8601 date and time in GMT when the resource was created + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was created. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated. */ dateUpdated: Date; /** - * The absolute URL of the Session resource + * The absolute URL of the Session resource. */ url: string; /** - * The URLs of resources related to the Session + * The URLs of resources related to the Session. */ links: Record; diff --git a/lib/rest/proxy/v1/service/session/interaction.ts b/lib/rest/proxy/v1/service/session/interaction.ts index 9354be7a87..86a546bb02 100644 --- a/lib/rest/proxy/v1/service/session/interaction.ts +++ b/lib/rest/proxy/v1/service/session/interaction.ts @@ -263,37 +263,37 @@ export class InteractionInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Interaction resource. */ sid: string; /** - * The SID of the resource\'s parent Session + * The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) resource. */ sessionSid: string; /** - * The SID of the resource\'s parent Service + * The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) resource. */ serviceSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Interaction resource. */ accountSid: string; /** - * A JSON string that includes the message body of message interactions + * A JSON string that includes the message body of message interactions (e.g. `{\"body\": \"hello\"}`) or the call duration (when available) of a call (e.g. `{\"duration\": \"5\"}`). */ data: string; type: InteractionType; /** - * The SID of the inbound Participant resource + * The SID of the inbound [Participant](https://www.twilio.com/docs/proxy/api/participant) resource. */ inboundParticipantSid: string; /** - * The SID of the inbound resource + * The SID of the inbound resource; either the [Call](https://www.twilio.com/docs/voice/api/call-resource) or [Message](https://www.twilio.com/docs/sms/api/message. */ inboundResourceSid: string; inboundResourceStatus: InteractionResourceStatus; /** - * The inbound resource type + * The inbound resource type. Can be [Call](https://www.twilio.com/docs/voice/api/call-resource) or [Message](https://www.twilio.com/docs/sms/api/message-resource). */ inboundResourceType: string; /** @@ -301,32 +301,32 @@ export class InteractionInstance { */ inboundResourceUrl: string; /** - * The SID of the outbound Participant + * The SID of the outbound [Participant](https://www.twilio.com/docs/proxy/api/participant)). */ outboundParticipantSid: string; /** - * The SID of the outbound resource + * The SID of the outbound resource; either the [Call](https://www.twilio.com/docs/voice/api/call-resource) or [Message](https://www.twilio.com/docs/sms/api/message-resource). */ outboundResourceSid: string; outboundResourceStatus: InteractionResourceStatus; /** - * The outbound resource type + * The outbound resource type. Can be: [Call](https://www.twilio.com/docs/voice/api/call-resource) or [Message](https://www.twilio.com/docs/sms/api/message-resource). */ outboundResourceType: string; /** - * The URL of the Twilio outbound resource + * The URL of the Twilio outbound resource. */ outboundResourceUrl: string; /** - * The ISO 8601 date and time in GMT when the Interaction was created + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the Interaction was created. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated. */ dateUpdated: Date; /** - * The absolute URL of the Interaction resource + * The absolute URL of the Interaction resource. */ url: string; diff --git a/lib/rest/proxy/v1/service/session/participant.ts b/lib/rest/proxy/v1/service/session/participant.ts index fd8a60a102..dd4ed916cd 100644 --- a/lib/rest/proxy/v1/service/session/participant.ts +++ b/lib/rest/proxy/v1/service/session/participant.ts @@ -256,55 +256,55 @@ export class ParticipantInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Participant resource. */ sid: string; /** - * The SID of the resource\'s parent Session + * The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) resource. */ sessionSid: string; /** - * The SID of the resource\'s parent Service + * The SID of the resource\'s parent [Service](https://www.twilio.com/docs/proxy/api/service) resource. */ serviceSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Participant resource. */ accountSid: string; /** - * The string that you assigned to describe the participant + * The string that you assigned to describe the participant. This value must be 255 characters or fewer. Supports UTF-8 characters. **This value should not have PII.** */ friendlyName: string; /** - * The phone number or channel identifier of the Participant + * The phone number or channel identifier of the Participant. This value must be 191 characters or fewer. Supports UTF-8 characters. */ identifier: string; /** - * The phone number or short code of the participant\'s partner + * The phone number or short code (masked number) of the participant\'s partner. The participant will call or message the partner participant at this number. */ proxyIdentifier: string; /** - * The SID of the Proxy Identifier assigned to the Participant + * The SID of the Proxy Identifier assigned to the Participant. */ proxyIdentifierSid: string; /** - * The ISO 8601 date the Participant was removed + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date when the Participant was removed from the session. */ dateDeleted: Date; /** - * The ISO 8601 date and time in GMT when the resource was created + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was created. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated. */ dateUpdated: Date; /** - * The absolute URL of the Participant resource + * The absolute URL of the Participant resource. */ url: string; /** - * The URLs to resources related the participant + * The URLs to resources related the participant. */ links: Record; diff --git a/lib/rest/proxy/v1/service/session/participant/messageInteraction.ts b/lib/rest/proxy/v1/service/session/participant/messageInteraction.ts index 8c8fc08b01..36ae8e72a0 100644 --- a/lib/rest/proxy/v1/service/session/participant/messageInteraction.ts +++ b/lib/rest/proxy/v1/service/session/participant/messageInteraction.ts @@ -264,74 +264,74 @@ export class MessageInteractionInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the MessageInteraction resource. */ sid: string; /** - * The SID of the resource\'s parent Session + * The SID of the parent [Session](https://www.twilio.com/docs/proxy/api/session) resource. */ sessionSid: string; /** - * The SID of the resource\'s parent Service + * The SID of the parent [Service](https://www.twilio.com/docs/proxy/api/service) resource. */ serviceSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the MessageInteraction resource. */ accountSid: string; /** - * A JSON string that includes the message body sent to the participant + * A JSON string that includes the message body sent to the participant. (e.g. `{\"body\": \"hello\"}`) */ data: string; type: MessageInteractionType; /** - * The SID of the Participant resource + * The SID of the [Participant](https://www.twilio.com/docs/proxy/api/participant) resource. */ participantSid: string; /** - * Always empty for Message Interactions + * Always empty for created Message Interactions. */ inboundParticipantSid: string; /** - * Always empty for Message Interactions + * Always empty for created Message Interactions. */ inboundResourceSid: string; inboundResourceStatus: MessageInteractionResourceStatus; /** - * Always empty for Message Interactions + * Always empty for created Message Interactions. */ inboundResourceType: string; /** - * Always empty for Message Interactions + * Always empty for created Message Interactions. */ inboundResourceUrl: string; /** - * The SID of the outbound Participant resource + * The SID of the outbound [Participant](https://www.twilio.com/docs/proxy/api/participant) resource. */ outboundParticipantSid: string; /** - * The SID of the outbound Message resource + * The SID of the outbound [Message](https://www.twilio.com/docs/sms/api/message-resource) resource. */ outboundResourceSid: string; outboundResourceStatus: MessageInteractionResourceStatus; /** - * The outbound resource type + * The outbound resource type. This value is always `Message`. */ outboundResourceType: string; /** - * The URL of the Twilio message resource + * The URL of the Twilio message resource. */ outboundResourceUrl: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was created. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated. */ dateUpdated: Date; /** - * The absolute URL of the MessageInteraction resource + * The absolute URL of the MessageInteraction resource. */ url: string; diff --git a/lib/rest/proxy/v1/service/shortCode.ts b/lib/rest/proxy/v1/service/shortCode.ts index ae3bb4f7a0..62f73b8e1e 100644 --- a/lib/rest/proxy/v1/service/shortCode.ts +++ b/lib/rest/proxy/v1/service/shortCode.ts @@ -294,40 +294,40 @@ export class ShortCodeInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the ShortCode resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the ShortCode resource. */ accountSid: string; /** - * The SID of the resource\'s parent Service + * The SID of the ShortCode resource\'s parent [Service](https://www.twilio.com/docs/proxy/api/service) resource. */ serviceSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was created. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated. */ dateUpdated: Date; /** - * The short code\'s number + * The short code\'s number. */ shortCode: string; /** - * The ISO Country Code + * The ISO Country Code for the short code. */ isoCountry: string; capabilities: PhoneNumberCapabilities; /** - * The absolute URL of the ShortCode resource + * The absolute URL of the ShortCode resource. */ url: string; /** - * Whether the short code should be reserved for manual assignment to participants only + * Whether the short code should be reserved and not be assigned to a participant using proxy pool logic. See [Reserved Phone Numbers](https://www.twilio.com/docs/proxy/reserved-phone-numbers) for more information. */ isReserved: boolean; diff --git a/lib/rest/routes/v2/phoneNumber.ts b/lib/rest/routes/v2/phoneNumber.ts index b187d49722..e0f366ccbe 100644 --- a/lib/rest/routes/v2/phoneNumber.ts +++ b/lib/rest/routes/v2/phoneNumber.ts @@ -210,23 +210,23 @@ export class PhoneNumberInstance { } /** - * The phone number + * The phone number in E.164 format */ phoneNumber: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * A string that uniquely identifies the Inbound Processing Region assignments for this phone number. + * A 34 character string that uniquely identifies the Inbound Processing Region assignments for this phone number. */ sid: string; /** - * Account Sid. + * The unique SID identifier of the Account. */ accountSid: string; /** - * A human readable description of the Inbound Processing Region assignments for this phone number. + * A human readable description of the Inbound Processing Region assignments for this phone number, up to 64 characters. */ friendlyName: string; /** @@ -234,11 +234,11 @@ export class PhoneNumberInstance { */ voiceRegion: string; /** - * The date that this phone number was assigned an Inbound Processing Region. + * The date that this phone number was assigned an Inbound Processing Region, given in ISO 8601 format. */ dateCreated: Date; /** - * The date that the Inbound Processing Region was updated for this phone number. + * The date that the Inbound Processing Region was updated for this phone number, given in ISO 8601 format. */ dateUpdated: Date; diff --git a/lib/rest/routes/v2/trunk.ts b/lib/rest/routes/v2/trunk.ts index 5d64b25c48..cb74fd4929 100644 --- a/lib/rest/routes/v2/trunk.ts +++ b/lib/rest/routes/v2/trunk.ts @@ -210,23 +210,23 @@ export class TrunkInstance { } /** - * The SIP Trunk + * The absolute URL of the SIP Trunk */ sipTrunkDomain: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * A string that uniquely identifies the Inbound Processing Region assignments for this SIP Trunk. + * A 34 character string that uniquely identifies the Inbound Processing Region assignments for this SIP Trunk. */ sid: string; /** - * Account Sid. + * The unique SID identifier of the Account. */ accountSid: string; /** - * A human readable description of the Inbound Processing Region assignments for this SIP Trunk. + * A human readable description of the Inbound Processing Region assignments for this SIP Trunk, up to 64 characters. */ friendlyName: string; /** @@ -234,11 +234,11 @@ export class TrunkInstance { */ voiceRegion: string; /** - * The date that this SIP Trunk was assigned an Inbound Processing Region. + * The date that this SIP Trunk was assigned an Inbound Processing Region, given in ISO 8601 format. */ dateCreated: Date; /** - * The date that the Inbound Processing Region was updated for this SIP Trunk. + * The date that the Inbound Processing Region was updated for this SIP Trunk, given in ISO 8601 format. */ dateUpdated: Date; diff --git a/lib/rest/serverless/v1/service.ts b/lib/rest/serverless/v1/service.ts index 96ff5bfb76..6326731f87 100644 --- a/lib/rest/serverless/v1/service.ts +++ b/lib/rest/serverless/v1/service.ts @@ -329,47 +329,47 @@ export class ServiceInstance { } /** - * The unique string that identifies the Service resource + * The unique string that we created to identify the Service resource. */ sid: string; /** - * The SID of the Account that created the Service resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource. */ accountSid: string; /** - * The string that you assigned to describe the Service resource + * The string that you assigned to describe the Service resource. */ friendlyName: string; /** - * A user-defined string that uniquely identifies the Service resource + * A user-defined string that uniquely identifies the Service resource. It can be used in place of the Service resource\'s `sid` in the URL to address the Service resource. */ uniqueName: string; /** - * Whether to inject Account credentials into a function invocation context + * Whether to inject Account credentials into a function invocation context. */ includeCredentials: boolean; /** - * Whether the Service resource\'s properties and subresources can be edited via the UI + * Whether the Service resource\'s properties and subresources can be edited via the UI. */ uiEditable: boolean; /** - * The base domain name for this Service, which is a combination of the unique name and a randomly generated string + * The base domain name for this Service, which is a combination of the unique name and a randomly generated string. */ domainBase: string; /** - * The ISO 8601 date and time in GMT when the Service resource was created + * The date and time in GMT when the Service resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the Service resource was last updated + * The date and time in GMT when the Service resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Service resource + * The absolute URL of the Service resource. */ url: string; /** - * The URLs of the Service\'s nested resources + * The URLs of the Service\'s nested resources. */ links: Record; diff --git a/lib/rest/serverless/v1/service/asset.ts b/lib/rest/serverless/v1/service/asset.ts index 54eae721bc..dfd6eb967f 100644 --- a/lib/rest/serverless/v1/service/asset.ts +++ b/lib/rest/serverless/v1/service/asset.ts @@ -296,35 +296,35 @@ export class AssetInstance { } /** - * The unique string that identifies the Asset resource + * The unique string that we created to identify the Asset resource. */ sid: string; /** - * The SID of the Account that created the Asset resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Asset resource. */ accountSid: string; /** - * The SID of the Service that the Asset resource is associated with + * The SID of the Service that the Asset resource is associated with. */ serviceSid: string; /** - * The string that you assigned to describe the Asset resource + * The string that you assigned to describe the Asset resource. It can be a maximum of 255 characters. */ friendlyName: string; /** - * The ISO 8601 date and time in GMT when the Asset resource was created + * The date and time in GMT when the Asset resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the Asset resource was last updated + * The date and time in GMT when the Asset resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Asset resource + * The absolute URL of the Asset resource. */ url: string; /** - * The URLs of the Asset resource\'s nested resources + * The URLs of the Asset resource\'s nested resources. */ links: Record; diff --git a/lib/rest/serverless/v1/service/asset/assetVersion.ts b/lib/rest/serverless/v1/service/asset/assetVersion.ts index dec8444135..faae74ffab 100644 --- a/lib/rest/serverless/v1/service/asset/assetVersion.ts +++ b/lib/rest/serverless/v1/service/asset/assetVersion.ts @@ -190,32 +190,32 @@ export class AssetVersionInstance { } /** - * The unique string that identifies the Asset Version resource + * The unique string that we created to identify the Asset Version resource. */ sid: string; /** - * The SID of the Account that created the Asset Version resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Asset Version resource. */ accountSid: string; /** - * The SID of the Service that the Asset Version resource is associated with + * The SID of the Service that the Asset Version resource is associated with. */ serviceSid: string; /** - * The SID of the Asset resource that is the parent of the Asset Version + * The SID of the Asset resource that is the parent of the Asset Version. */ assetSid: string; /** - * The URL-friendly string by which the Asset Version can be referenced + * The URL-friendly string by which the Asset Version can be referenced. It can be a maximum of 255 characters. All paths begin with a forward slash (\'/\'). If an Asset Version creation request is submitted with a path not containing a leading slash, the path will automatically be prepended with one. */ path: string; visibility: AssetVersionVisibility; /** - * The ISO 8601 date and time in GMT when the Asset Version resource was created + * The date and time in GMT when the Asset Version resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The absolute URL of the Asset Version resource + * The absolute URL of the Asset Version resource. */ url: string; diff --git a/lib/rest/serverless/v1/service/build.ts b/lib/rest/serverless/v1/service/build.ts index 256ae662e7..49e9a84c8c 100644 --- a/lib/rest/serverless/v1/service/build.ts +++ b/lib/rest/serverless/v1/service/build.ts @@ -245,41 +245,41 @@ export class BuildInstance { } /** - * The unique string that identifies the Build resource + * The unique string that we created to identify the Build resource. */ sid: string; /** - * The SID of the Account that created the Build resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Build resource. */ accountSid: string; /** - * The SID of the Service that the Build resource is associated with + * The SID of the Service that the Build resource is associated with. */ serviceSid: string; status: BuildStatus; /** - * The list of Asset Version resource SIDs that are included in the Build + * The list of Asset Version resource SIDs that are included in the Build. */ assetVersions: Array; /** - * The list of Function Version resource SIDs that are included in the Build + * The list of Function Version resource SIDs that are included in the Build. */ functionVersions: Array; /** - * A list of objects that describe the Dependencies included in the Build + * A list of objects that describe the Dependencies included in the Build. Each object contains the `name` and `version` of the dependency. */ dependencies: Array; runtime: BuildRuntime; /** - * The ISO 8601 date and time in GMT when the Build resource was created + * The date and time in GMT when the Build resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the Build resource was last updated + * The date and time in GMT when the Build resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Build resource + * The absolute URL of the Build resource. */ url: string; links: Record; diff --git a/lib/rest/serverless/v1/service/build/buildStatus.ts b/lib/rest/serverless/v1/service/build/buildStatus.ts index a6d10f2cd0..c7545c4440 100644 --- a/lib/rest/serverless/v1/service/build/buildStatus.ts +++ b/lib/rest/serverless/v1/service/build/buildStatus.ts @@ -132,20 +132,20 @@ export class BuildStatusInstance { } /** - * The unique string that identifies the Build resource + * The unique string that we created to identify the Build resource. */ sid: string; /** - * The SID of the Account that created the Build resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Build resource. */ accountSid: string; /** - * The SID of the Service that the Build resource is associated with + * The SID of the Service that the Build resource is associated with. */ serviceSid: string; status: BuildStatusStatus; /** - * The absolute URL of the Build Status resource + * The absolute URL of the Build Status resource. */ url: string; diff --git a/lib/rest/serverless/v1/service/environment.ts b/lib/rest/serverless/v1/service/environment.ts index 42f740e458..fcea89f8d2 100644 --- a/lib/rest/serverless/v1/service/environment.ts +++ b/lib/rest/serverless/v1/service/environment.ts @@ -263,47 +263,47 @@ export class EnvironmentInstance { } /** - * The unique string that identifies the Environment resource + * The unique string that we created to identify the Environment resource. */ sid: string; /** - * The SID of the Account that created the Environment resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Environment resource. */ accountSid: string; /** - * The SID of the Service that the Environment resource is associated with + * The SID of the Service that the Environment resource is associated with. */ serviceSid: string; /** - * The SID of the build deployed in the environment + * The SID of the build deployed in the environment. */ buildSid: string; /** - * A user-defined string that uniquely identifies the Environment resource + * A user-defined string that uniquely identifies the Environment resource. */ uniqueName: string; /** - * A URL-friendly name that represents the environment + * A URL-friendly name that represents the environment and forms part of the domain name. */ domainSuffix: string; /** - * The domain name for all Functions and Assets deployed in the Environment + * The domain name for all Functions and Assets deployed in the Environment, using the Service unique name, a randomly-generated Service suffix, and an optional Environment domain suffix. */ domainName: string; /** - * The ISO 8601 date and time in GMT when the Environment resource was created + * The date and time in GMT when the Environment resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the Environment resource was last updated + * The date and time in GMT when the Environment resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Environment resource + * The absolute URL of the Environment resource. */ url: string; /** - * The URLs of the Environment resource\'s nested resources + * The URLs of the Environment resource\'s nested resources. */ links: Record; diff --git a/lib/rest/serverless/v1/service/environment/deployment.ts b/lib/rest/serverless/v1/service/environment/deployment.ts index c754a71f9c..eed9503b72 100644 --- a/lib/rest/serverless/v1/service/environment/deployment.ts +++ b/lib/rest/serverless/v1/service/environment/deployment.ts @@ -195,35 +195,35 @@ export class DeploymentInstance { } /** - * The unique string that identifies the Deployment resource + * The unique string that we created to identify the Deployment resource. */ sid: string; /** - * The SID of the Account that created the Deployment resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Deployment resource. */ accountSid: string; /** - * The SID of the Service that the Deployment resource is associated with + * The SID of the Service that the Deployment resource is associated with. */ serviceSid: string; /** - * The SID of the Environment for the Deployment + * The SID of the Environment for the Deployment. */ environmentSid: string; /** - * The SID of the Build for the deployment + * The SID of the Build for the deployment. */ buildSid: string; /** - * The ISO 8601 date and time in GMT when the Deployment resource was created + * The date and time in GMT when the Deployment resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the Deployment resource was last updated + * The date and time in GMT when the Deployment resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Deployment resource + * The absolute URL of the Deployment resource. */ url: string; diff --git a/lib/rest/serverless/v1/service/environment/log.ts b/lib/rest/serverless/v1/service/environment/log.ts index d1811e4e4b..c507a7f78d 100644 --- a/lib/rest/serverless/v1/service/environment/log.ts +++ b/lib/rest/serverless/v1/service/environment/log.ts @@ -216,48 +216,48 @@ export class LogInstance { } /** - * The unique string that identifies the Log resource + * The unique string that we created to identify the Log resource. */ sid: string; /** - * The SID of the Account that created the Log resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Log resource. */ accountSid: string; /** - * The SID of the Service that the Log resource is associated with + * The SID of the Service that the Log resource is associated with. */ serviceSid: string; /** - * The SID of the environment in which the log occurred + * The SID of the environment in which the log occurred. */ environmentSid: string; /** - * The SID of the build that corresponds to the log + * The SID of the build that corresponds to the log. */ buildSid: string; /** - * The SID of the deployment that corresponds to the log + * The SID of the deployment that corresponds to the log. */ deploymentSid: string; /** - * The SID of the function whose invocation produced the log + * The SID of the function whose invocation produced the log. */ functionSid: string; /** - * The SID of the request associated with the log + * The SID of the request associated with the log. */ requestSid: string; level: LogLevel; /** - * The log message + * The log message. */ message: string; /** - * The ISO 8601 date and time in GMT when the Log resource was created + * The date and time in GMT when the Log resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The absolute URL of the Log resource + * The absolute URL of the Log resource. */ url: string; diff --git a/lib/rest/serverless/v1/service/environment/variable.ts b/lib/rest/serverless/v1/service/environment/variable.ts index 04721a4255..1d2b3ad2fc 100644 --- a/lib/rest/serverless/v1/service/environment/variable.ts +++ b/lib/rest/serverless/v1/service/environment/variable.ts @@ -308,39 +308,39 @@ export class VariableInstance { } /** - * The unique string that identifies the Variable resource + * The unique string that we created to identify the Variable resource. */ sid: string; /** - * The SID of the Account that created the Variable resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Variable resource. */ accountSid: string; /** - * The SID of the Service that the Variable resource is associated with + * The SID of the Service that the Variable resource is associated with. */ serviceSid: string; /** - * The SID of the Environment in which the Variable exists + * The SID of the Environment in which the Variable exists. */ environmentSid: string; /** - * A string by which the Variable resource can be referenced + * A string by which the Variable resource can be referenced. */ key: string; /** - * A string that contains the actual value of the Variable + * A string that contains the actual value of the Variable. */ value: string; /** - * The ISO 8601 date and time in GMT when the Variable resource was created + * The date and time in GMT when the Variable resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the Variable resource was last updated + * The date and time in GMT when the Variable resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Variable resource + * The absolute URL of the Variable resource. */ url: string; diff --git a/lib/rest/serverless/v1/service/function.ts b/lib/rest/serverless/v1/service/function.ts index 6b9185f9e5..ac795739bd 100644 --- a/lib/rest/serverless/v1/service/function.ts +++ b/lib/rest/serverless/v1/service/function.ts @@ -296,35 +296,35 @@ export class FunctionInstance { } /** - * The unique string that identifies the Function resource + * The unique string that we created to identify the Function resource. */ sid: string; /** - * The SID of the Account that created the Function resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Function resource. */ accountSid: string; /** - * The SID of the Service that the Function resource is associated with + * The SID of the Service that the Function resource is associated with. */ serviceSid: string; /** - * The string that you assigned to describe the Function resource + * The string that you assigned to describe the Function resource. It can be a maximum of 255 characters. */ friendlyName: string; /** - * The ISO 8601 date and time in GMT when the Function resource was created + * The date and time in GMT when the Function resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the Function resource was last updated + * The date and time in GMT when the Function resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Function resource + * The absolute URL of the Function resource. */ url: string; /** - * The URLs of nested resources of the Function resource + * The URLs of nested resources of the Function resource. */ links: Record; diff --git a/lib/rest/serverless/v1/service/function/functionVersion.ts b/lib/rest/serverless/v1/service/function/functionVersion.ts index f98aa06979..9a89fad315 100644 --- a/lib/rest/serverless/v1/service/function/functionVersion.ts +++ b/lib/rest/serverless/v1/service/function/functionVersion.ts @@ -212,32 +212,32 @@ export class FunctionVersionInstance { } /** - * The unique string that identifies the Function Version resource + * The unique string that we created to identify the Function Version resource. */ sid: string; /** - * The SID of the Account that created the Function Version resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Function Version resource. */ accountSid: string; /** - * The SID of the Service that the Function Version resource is associated with + * The SID of the Service that the Function Version resource is associated with. */ serviceSid: string; /** - * The SID of the Function resource that is the parent of the Function Version resource + * The SID of the Function resource that is the parent of the Function Version resource. */ functionSid: string; /** - * The URL-friendly string by which the Function Version resource can be referenced + * The URL-friendly string by which the Function Version resource can be referenced. It can be a maximum of 255 characters. All paths begin with a forward slash (\'/\'). If a Function Version creation request is submitted with a path not containing a leading slash, the path will automatically be prepended with one. */ path: string; visibility: FunctionVersionVisibility; /** - * The ISO 8601 date and time in GMT when the Function Version resource was created + * The date and time in GMT when the Function Version resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The absolute URL of the Function Version resource + * The absolute URL of the Function Version resource. */ url: string; links: Record; diff --git a/lib/rest/serverless/v1/service/function/functionVersion/functionVersionContent.ts b/lib/rest/serverless/v1/service/function/functionVersion/functionVersionContent.ts index 93e36a8c46..8b847cda7f 100644 --- a/lib/rest/serverless/v1/service/function/functionVersion/functionVersionContent.ts +++ b/lib/rest/serverless/v1/service/function/functionVersion/functionVersionContent.ts @@ -153,23 +153,23 @@ export class FunctionVersionContentInstance { } /** - * The unique string that identifies the Function Version resource + * The unique string that we created to identify the Function Version resource. */ sid: string; /** - * The SID of the Account that created the Function Version resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Function Version resource. */ accountSid: string; /** - * The SID of the Service that the Function Version resource is associated with + * The SID of the Service that the Function Version resource is associated with. */ serviceSid: string; /** - * The SID of the Function that is the parent of the Function Version + * The SID of the Function that is the parent of the Function Version. */ functionSid: string; /** - * The content of the Function Version resource + * The content of the Function Version resource. */ content: string; url: string; diff --git a/lib/rest/studio/v1/flow.ts b/lib/rest/studio/v1/flow.ts index 4637b97c3c..987837cde9 100644 --- a/lib/rest/studio/v1/flow.ts +++ b/lib/rest/studio/v1/flow.ts @@ -215,36 +215,36 @@ export class FlowInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Flow resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Flow resource. */ accountSid: string; /** - * The string that you assigned to describe the Flow + * The string that you assigned to describe the Flow. */ friendlyName: string; status: FlowStatus; /** - * The latest version number of the Flow\'s definition + * The latest version number of the Flow\'s definition. */ version: number; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * Nested resource URLs + * The URLs of the Flow\'s nested resources. */ links: Record; diff --git a/lib/rest/studio/v1/flow/engagement.ts b/lib/rest/studio/v1/flow/engagement.ts index d6e1ccc7ff..7aee89c757 100644 --- a/lib/rest/studio/v1/flow/engagement.ts +++ b/lib/rest/studio/v1/flow/engagement.ts @@ -253,44 +253,44 @@ export class EngagementInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Engagement resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Engagement resource. */ accountSid: string; /** - * The SID of the Flow + * The SID of the Flow. */ flowSid: string; /** - * The SID of the Contact + * The SID of the Contact. */ contactSid: string; /** - * The phone number, SIP address or Client identifier that triggered this Engagement + * The phone number, SIP address or Client identifier that triggered this Engagement. Phone numbers are in E.164 format (+16175551212). SIP addresses are formatted as `name@company.com`. Client identifiers are formatted `client:name`. */ contactChannelAddress: string; /** - * The current state of the execution flow + * The current state of the execution flow. As your flow executes, we save the state in a flow context. Your widgets can access the data in the flow context as variables, either in configuration fields or in text areas as variable substitution. */ context: any; status: EngagementStatus; /** - * The ISO 8601 date and time in GMT when the Engagement was created + * The date and time in GMT when the Engagement was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the Engagement was last updated + * The date and time in GMT when the Engagement was updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URLs of the Engagement\'s nested resources + * The URLs of the Engagement\'s nested resources. */ links: Record; diff --git a/lib/rest/studio/v1/flow/engagement/engagementContext.ts b/lib/rest/studio/v1/flow/engagement/engagementContext.ts index cad886d9c9..315ed90fe1 100644 --- a/lib/rest/studio/v1/flow/engagement/engagementContext.ts +++ b/lib/rest/studio/v1/flow/engagement/engagementContext.ts @@ -130,23 +130,23 @@ export class EngagementContextInstance { } /** - * Account SID + * The SID of the Account. */ accountSid: string; /** - * Flow state + * As your flow executes, we save the state in what\'s called the Flow Context. Any data in the flow context can be accessed by your widgets as variables, either in configuration fields or in text areas as variable substitution. */ context: any; /** - * Engagement SID + * The SID of the Engagement. */ engagementSid: string; /** - * Flow SID + * The SID of the Flow. */ flowSid: string; /** - * The URL of the resource + * The URL of the resource. */ url: string; diff --git a/lib/rest/studio/v1/flow/engagement/step.ts b/lib/rest/studio/v1/flow/engagement/step.ts index 036bdb89fc..d9a09e30ca 100644 --- a/lib/rest/studio/v1/flow/engagement/step.ts +++ b/lib/rest/studio/v1/flow/engagement/step.ts @@ -213,51 +213,51 @@ export class StepInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Step resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Step resource. */ accountSid: string; /** - * The SID of the Flow + * The SID of the Flow. */ flowSid: string; /** - * The SID of the Engagement + * The SID of the Engagement. */ engagementSid: string; /** - * The event that caused the Flow to transition to the Step + * The event that caused the Flow to transition to the Step. */ name: string; /** - * The current state of the flow + * The current state of the Flow\'s Execution. As a flow executes, we save its state in this context. We save data that your widgets can access as variables in configuration fields or in text areas as variable substitution. */ context: any; /** - * The Widget that preceded the Widget for the Step + * The Widget that preceded the Widget for the Step. */ transitionedFrom: string; /** - * The Widget that will follow the Widget for the Step + * The Widget that will follow the Widget for the Step. */ transitionedTo: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/studio/v1/flow/engagement/step/stepContext.ts b/lib/rest/studio/v1/flow/engagement/step/stepContext.ts index 219e408598..811401018d 100644 --- a/lib/rest/studio/v1/flow/engagement/step/stepContext.ts +++ b/lib/rest/studio/v1/flow/engagement/step/stepContext.ts @@ -144,27 +144,27 @@ export class StepContextInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the StepContext resource. */ accountSid: string; /** - * The current state of the flow + * The current state of the Flow\'s Execution. As a flow executes, we save its state in this context. We save data that your widgets can access as variables in configuration fields or in text areas as variable substitution. */ context: any; /** - * The SID of the Engagement + * The SID of the Engagement. */ engagementSid: string; /** - * The SID of the Flow + * The SID of the Flow. */ flowSid: string; /** - * Step SID + * The SID of the Step the context is associated with. */ stepSid: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/studio/v1/flow/execution.ts b/lib/rest/studio/v1/flow/execution.ts index 98f435348e..b15a7186b4 100644 --- a/lib/rest/studio/v1/flow/execution.ts +++ b/lib/rest/studio/v1/flow/execution.ts @@ -331,44 +331,44 @@ export class ExecutionInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Execution resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Execution resource. */ accountSid: string; /** - * The SID of the Flow + * The SID of the Flow. */ flowSid: string; /** - * The SID of the Contact + * The SID of the Contact. */ contactSid: string; /** - * The phone number, SIP address or Client identifier that triggered the Execution + * The phone number, SIP address or Client identifier that triggered the Execution. Phone numbers are in E.164 format (e.g. +16175551212). SIP addresses are formatted as `name@company.com`. Client identifiers are formatted `client:name`. */ contactChannelAddress: string; /** - * The current state of the flow + * The current state of the Flow\'s Execution. As a flow executes, we save its state in this context. We save data that your widgets can access as variables in configuration fields or in text areas as variable substitution. */ context: any; status: ExecutionStatus; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * Nested resource URLs + * The URLs of nested resources. */ links: Record; diff --git a/lib/rest/studio/v1/flow/execution/executionContext.ts b/lib/rest/studio/v1/flow/execution/executionContext.ts index 5aa734c0d5..481b063b94 100644 --- a/lib/rest/studio/v1/flow/execution/executionContext.ts +++ b/lib/rest/studio/v1/flow/execution/executionContext.ts @@ -130,23 +130,23 @@ export class ExecutionContextInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the ExecutionContext resource. */ accountSid: string; /** - * The current state of the flow + * The current state of the Flow\'s Execution. As a flow executes, we save its state in this context. We save data that your widgets can access as variables in configuration fields or in text areas as variable substitution. */ context: any; /** - * The SID of the Flow + * The SID of the Flow. */ flowSid: string; /** - * The SID of the Execution + * The SID of the context\'s Execution resource. */ executionSid: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/studio/v1/flow/execution/executionStep.ts b/lib/rest/studio/v1/flow/execution/executionStep.ts index e3cd2170fd..dd816041d6 100644 --- a/lib/rest/studio/v1/flow/execution/executionStep.ts +++ b/lib/rest/studio/v1/flow/execution/executionStep.ts @@ -213,51 +213,51 @@ export class ExecutionStepInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the ExecutionStep resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the ExecutionStep resource. */ accountSid: string; /** - * The SID of the Flow + * The SID of the Flow. */ flowSid: string; /** - * The SID of the Execution + * The SID of the Step\'s Execution resource. */ executionSid: string; /** - * The event that caused the Flow to transition to the Step + * The event that caused the Flow to transition to the Step. */ name: string; /** - * The current state of the flow + * The current state of the Flow\'s Execution. As a flow executes, we save its state in this context. We save data that your widgets can access as variables in configuration fields or in text areas as variable substitution. */ context: any; /** - * The Widget that preceded the Widget for the Step + * The Widget that preceded the Widget for the Step. */ transitionedFrom: string; /** - * The Widget that will follow the Widget for the Step + * The Widget that will follow the Widget for the Step. */ transitionedTo: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/studio/v1/flow/execution/executionStep/executionStepContext.ts b/lib/rest/studio/v1/flow/execution/executionStep/executionStepContext.ts index 8fed259a72..d9da24a9c0 100644 --- a/lib/rest/studio/v1/flow/execution/executionStep/executionStepContext.ts +++ b/lib/rest/studio/v1/flow/execution/executionStep/executionStepContext.ts @@ -146,27 +146,27 @@ export class ExecutionStepContextInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the ExecutionStepContext resource. */ accountSid: string; /** - * The current state of the flow + * The current state of the Flow\'s Execution. As a flow executes, we save its state in this context. We save data that your widgets can access as variables in configuration fields or in text areas as variable substitution. */ context: any; /** - * The SID of the Execution + * The SID of the context\'s Execution resource. */ executionSid: string; /** - * The SID of the Flow + * The SID of the Flow. */ flowSid: string; /** - * Step SID + * The SID of the Step that the context is associated with. */ stepSid: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/studio/v2/flow.ts b/lib/rest/studio/v2/flow.ts index 51dff192aa..874afef6a2 100644 --- a/lib/rest/studio/v2/flow.ts +++ b/lib/rest/studio/v2/flow.ts @@ -323,57 +323,57 @@ export class FlowInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Flow resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Flow resource. */ accountSid: string; /** - * The string that you assigned to describe the Flow + * The string that you assigned to describe the Flow. */ friendlyName: string; /** - * JSON representation of flow definition + * JSON representation of flow definition. */ definition: any; status: FlowStatus; /** - * The latest revision number of the Flow\'s definition + * The latest revision number of the Flow\'s definition. */ revision: number; /** - * Description of change made in the revision + * Description of change made in the revision. */ commitMessage: string; /** - * Boolean if the flow definition is valid + * Boolean if the flow definition is valid. */ valid: boolean; /** - * List of error in the flow definition + * List of error in the flow definition. */ errors: Array; /** - * List of warnings in the flow definition + * List of warnings in the flow definition. */ warnings: Array; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; webhookUrl: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * Nested resource URLs + * The URLs of the Flow\'s nested resources. */ links: Record; diff --git a/lib/rest/studio/v2/flow/execution.ts b/lib/rest/studio/v2/flow/execution.ts index fd719bd16a..05af6e0fe3 100644 --- a/lib/rest/studio/v2/flow/execution.ts +++ b/lib/rest/studio/v2/flow/execution.ts @@ -329,40 +329,40 @@ export class ExecutionInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Execution resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Execution resource. */ accountSid: string; /** - * The SID of the Flow + * The SID of the Flow. */ flowSid: string; /** - * The phone number, SIP address or Client identifier that triggered the Execution + * The phone number, SIP address or Client identifier that triggered the Execution. Phone numbers are in E.164 format (e.g. +16175551212). SIP addresses are formatted as `name@company.com`. Client identifiers are formatted `client:name`. */ contactChannelAddress: string; /** - * The current state of the flow + * The current state of the Flow\'s Execution. As a flow executes, we save its state in this context. We save data that your widgets can access as variables in configuration fields or in text areas as variable substitution. */ context: any; status: ExecutionStatus; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * Nested resource URLs + * The URLs of nested resources. */ links: Record; diff --git a/lib/rest/studio/v2/flow/execution/executionContext.ts b/lib/rest/studio/v2/flow/execution/executionContext.ts index a2a70a04eb..1a575f9b28 100644 --- a/lib/rest/studio/v2/flow/execution/executionContext.ts +++ b/lib/rest/studio/v2/flow/execution/executionContext.ts @@ -130,23 +130,23 @@ export class ExecutionContextInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the ExecutionContext resource. */ accountSid: string; /** - * The current state of the flow + * The current state of the Flow\'s Execution. As a flow executes, we save its state in this context. We save data that your widgets can access as variables in configuration fields or in text areas as variable substitution. */ context: any; /** - * The SID of the Flow + * The SID of the Flow. */ flowSid: string; /** - * The SID of the Execution + * The SID of the context\'s Execution resource. */ executionSid: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/studio/v2/flow/execution/executionStep.ts b/lib/rest/studio/v2/flow/execution/executionStep.ts index 322109f697..5c724d854b 100644 --- a/lib/rest/studio/v2/flow/execution/executionStep.ts +++ b/lib/rest/studio/v2/flow/execution/executionStep.ts @@ -213,51 +213,51 @@ export class ExecutionStepInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the ExecutionStep resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the ExecutionStep resource. */ accountSid: string; /** - * The SID of the Flow + * The SID of the Flow. */ flowSid: string; /** - * The SID of the Execution + * The SID of the Step\'s Execution resource. */ executionSid: string; /** - * The event that caused the Flow to transition to the Step + * The event that caused the Flow to transition to the Step. */ name: string; /** - * The current state of the flow + * The current state of the Flow\'s Execution. As a flow executes, we save its state in this context. We save data that your widgets can access as variables in configuration fields or in text areas as variable substitution. */ context: any; /** - * The Widget that preceded the Widget for the Step + * The Widget that preceded the Widget for the Step. */ transitionedFrom: string; /** - * The Widget that will follow the Widget for the Step + * The Widget that will follow the Widget for the Step. */ transitionedTo: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/studio/v2/flow/execution/executionStep/executionStepContext.ts b/lib/rest/studio/v2/flow/execution/executionStep/executionStepContext.ts index 338700d564..81d7468008 100644 --- a/lib/rest/studio/v2/flow/execution/executionStep/executionStepContext.ts +++ b/lib/rest/studio/v2/flow/execution/executionStep/executionStepContext.ts @@ -146,27 +146,27 @@ export class ExecutionStepContextInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the ExecutionStepContext resource. */ accountSid: string; /** - * The current state of the flow + * The current state of the Flow\'s Execution. As a flow executes, we save its state in this context. We save data that your widgets can access as variables in configuration fields or in text areas as variable substitution. */ context: any; /** - * The SID of the Execution + * The SID of the context\'s Execution resource. */ executionSid: string; /** - * The SID of the Flow + * The SID of the Flow. */ flowSid: string; /** - * Step SID + * The SID of the Step that the context is associated with. */ stepSid: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/studio/v2/flow/flowRevision.ts b/lib/rest/studio/v2/flow/flowRevision.ts index e1068cb97c..1619d5e81c 100644 --- a/lib/rest/studio/v2/flow/flowRevision.ts +++ b/lib/rest/studio/v2/flow/flowRevision.ts @@ -186,48 +186,48 @@ export class FlowRevisionInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Flow resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Flow resource. */ accountSid: string; /** - * The string that you assigned to describe the Flow + * The string that you assigned to describe the Flow. */ friendlyName: string; /** - * JSON representation of flow definition + * JSON representation of flow definition. */ definition: any; status: FlowRevisionStatus; /** - * The latest revision number of the Flow\'s definition + * The latest revision number of the Flow\'s definition. */ revision: number; /** - * Description of change made in the revision + * Description of change made in the revision. */ commitMessage: string; /** - * Boolean if the flow definition is valid + * Boolean if the flow definition is valid. */ valid: boolean; /** - * List of error in the flow definition + * List of error in the flow definition. */ errors: Array; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/studio/v2/flowValidate.ts b/lib/rest/studio/v2/flowValidate.ts index 26490f965b..d6a4299f63 100644 --- a/lib/rest/studio/v2/flowValidate.ts +++ b/lib/rest/studio/v2/flowValidate.ts @@ -151,7 +151,7 @@ export class FlowValidateInstance { } /** - * Boolean if the flow definition is valid + * Boolean if the flow definition is valid. */ valid: boolean; diff --git a/lib/rest/supersim/v1/esimProfile.ts b/lib/rest/supersim/v1/esimProfile.ts index 6152caf534..b4aee0da29 100644 --- a/lib/rest/supersim/v1/esimProfile.ts +++ b/lib/rest/supersim/v1/esimProfile.ts @@ -214,48 +214,48 @@ export class EsimProfileInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the eSIM Profile resource. */ sid: string; /** - * The SID of the Account to which the eSIM Profile resource belongs + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) to which the eSIM Profile resource belongs. */ accountSid: string; /** - * The ICCID associated with the Sim resource + * The [ICCID](https://en.wikipedia.org/wiki/Subscriber_identity_module#ICCID) associated with the Sim resource. */ iccid: string; /** - * The SID of the Sim resource that this eSIM Profile controls + * The SID of the [Sim](https://www.twilio.com/docs/wireless/api/sim-resource) resource that this eSIM Profile controls. */ simSid: string; status: EsimProfileStatus; /** - * Identifier of the eUICC that can claim the eSIM Profile + * Identifier of the eUICC that can claim the eSIM Profile. */ eid: string; /** - * Address of the SM-DP+ server from which the Profile will be downloaded + * Address of the SM-DP+ server from which the Profile will be downloaded. The URL will appear once the eSIM Profile reaches the status `available`. */ smdpPlusAddress: string; /** - * Code indicating the failure if the download of the SIM Profile failed and the eSIM Profile is in `failed` state + * Code indicating the failure if the download of the SIM Profile failed and the eSIM Profile is in `failed` state. */ errorCode: string; /** - * Error message describing the failure if the download of the SIM Profile failed and the eSIM Profile is in `failed` state + * Error message describing the failure if the download of the SIM Profile failed and the eSIM Profile is in `failed` state. */ errorMessage: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the eSIM Profile resource + * The absolute URL of the eSIM Profile resource. */ url: string; diff --git a/lib/rest/supersim/v1/fleet.ts b/lib/rest/supersim/v1/fleet.ts index 1f694a469c..bfe2c3adc2 100644 --- a/lib/rest/supersim/v1/fleet.ts +++ b/lib/rest/supersim/v1/fleet.ts @@ -318,60 +318,60 @@ export class FleetInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Fleet resource. */ accountSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Fleet resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Fleet resource + * The absolute URL of the Fleet resource. */ url: string; /** - * Defines whether SIMs in the Fleet are capable of using data connectivity + * Defines whether SIMs in the Fleet are capable of using 2G/3G/4G/LTE/CAT-M data connectivity. Defaults to `true`. */ dataEnabled: boolean; /** - * The total data usage (download and upload combined) in Megabytes that each Super SIM assigned to the Fleet can consume + * The total data usage (download and upload combined) in Megabytes that each Super SIM assigned to the Fleet can consume during a billing period (normally one month). Value must be between 1MB (1) and 2TB (2,000,000). Defaults to 1GB (1,000). */ dataLimit: number; dataMetering: FleetDataMetering; /** - * Defines whether SIMs in the Fleet are capable of sending and receiving machine-to-machine SMS via Commands + * Defines whether SIMs in the Fleet are capable of sending and receiving machine-to-machine SMS via Commands. Defaults to `true`. */ smsCommandsEnabled: boolean; /** - * The URL that will receive a webhook when a Super SIM in the Fleet is used to send an SMS from your device to the SMS Commands number + * The URL that will receive a webhook when a Super SIM in the Fleet is used to send an SMS from your device to the SMS Commands number. Your server should respond with an HTTP status code in the 200 range; any response body will be ignored. */ smsCommandsUrl: string; /** - * A string representing the HTTP method to use when making a request to `sms_commands_url` + * A string representing the HTTP method to use when making a request to `sms_commands_url`. Can be one of `POST` or `GET`. Defaults to `POST`. */ smsCommandsMethod: FleetSmsCommandsMethod; /** - * The SID of the Network Access Profile of the Fleet + * The SID of the Network Access Profile that controls which cellular networks the Fleet\'s SIMs can connect to. */ networkAccessProfileSid: string; /** - * The URL that will receive a webhook when a Super SIM in the Fleet is used to send an IP Command from your device + * The URL that will receive a webhook when a Super SIM in the Fleet is used to send an IP Command from your device to a special IP address. Your server should respond with an HTTP status code in the 200 range; any response body will be ignored. */ ipCommandsUrl: string; /** - * A string representing the HTTP method to use when making a request to `ip_commands_url` + * A string representing the HTTP method to use when making a request to `ip_commands_url`. Can be one of `POST` or `GET`. Defaults to `POST`. */ ipCommandsMethod: FleetIpCommandsMethod; diff --git a/lib/rest/supersim/v1/ipCommand.ts b/lib/rest/supersim/v1/ipCommand.ts index 06c0f63850..55c329b6a7 100644 --- a/lib/rest/supersim/v1/ipCommand.ts +++ b/lib/rest/supersim/v1/ipCommand.ts @@ -222,46 +222,46 @@ export class IpCommandInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the IP Command resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the IP Command resource. */ accountSid: string; /** - * The SID of the Super SIM that this IP Command was sent to or from + * The SID of the [Super SIM](https://www.twilio.com/docs/iot/supersim/api/sim-resource) that this IP Command was sent to or from. */ simSid: string; /** - * The ICCID of the Super SIM that this IP Command was sent to or from + * The [ICCID](https://en.wikipedia.org/wiki/Subscriber_identity_module#ICCID) of the [Super SIM](https://www.twilio.com/docs/iot/supersim/api/sim-resource) that this IP Command was sent to or from. */ simIccid: string; status: IpCommandStatus; direction: IpCommandDirection; /** - * The IP address of the device that the IP Command was sent to or received from + * The IP address of the device that the IP Command was sent to or received from. For an IP Command sent to a Super SIM, `device_ip` starts out as `null`, and once the IP Command is “sent”, the `device_ip` will be filled out. An IP Command sent from a Super SIM have its `device_ip` always set. */ deviceIp: string; /** - * The port that the IP Command either originated from or was sent to + * For an IP Command sent to a Super SIM, it would be the destination port of the IP message. For an IP Command sent from a Super SIM, it would be the source port of the IP message. */ devicePort: number; payloadType: IpCommandPayloadType; /** - * The payload of the IP Command sent to or from the Super SIM + * The payload that is carried in the IP/UDP message. The payload can be encoded in either text or binary format. For text payload, UTF-8 encoding must be used. For an IP Command sent to a Super SIM, the payload is appended to the IP/UDP message “as is”. The payload should not exceed 1300 bytes. For an IP Command sent from a Super SIM, the payload from the received IP/UDP message is extracted and sent in binary encoding. For an IP Command sent from a Super SIM, the payload should not exceed 1300 bytes. If it is larger than 1300 bytes, there might be fragmentation on the upstream and the message may appear truncated. */ payload: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the IP Command resource + * The absolute URL of the IP Command resource. */ url: string; diff --git a/lib/rest/supersim/v1/network.ts b/lib/rest/supersim/v1/network.ts index 7f0eb0c4ba..96867973ad 100644 --- a/lib/rest/supersim/v1/network.ts +++ b/lib/rest/supersim/v1/network.ts @@ -173,23 +173,23 @@ export class NetworkInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Network resource. */ sid: string; /** - * A human readable identifier of this resource + * A human readable identifier of this resource. */ friendlyName: string; /** - * The absolute URL of the Network resource + * The absolute URL of the Network resource. */ url: string; /** - * The ISO country code of the Network resource + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the Network resource. */ isoCountry: string; /** - * The MCC/MNCs included in the Network resource + * Array of objects identifying the [MCC-MNCs](https://en.wikipedia.org/wiki/Mobile_country_code) that are included in the Network resource. */ identifiers: Array; diff --git a/lib/rest/supersim/v1/networkAccessProfile.ts b/lib/rest/supersim/v1/networkAccessProfile.ts index 8ef8ea62e1..27b3391ffe 100644 --- a/lib/rest/supersim/v1/networkAccessProfile.ts +++ b/lib/rest/supersim/v1/networkAccessProfile.ts @@ -273,27 +273,27 @@ export class NetworkAccessProfileInstance { } /** - * The unique string that identifies the resource + * The unique string that identifies the Network Access Profile resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The SID of the Account that the Network Access Profile belongs to + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that the Network Access Profile belongs to. */ accountSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the Network Access Profile resource. */ url: string; links: Record; diff --git a/lib/rest/supersim/v1/networkAccessProfile/networkAccessProfileNetwork.ts b/lib/rest/supersim/v1/networkAccessProfile/networkAccessProfileNetwork.ts index de1bc7f61f..9d0e3e5cc0 100644 --- a/lib/rest/supersim/v1/networkAccessProfile/networkAccessProfileNetwork.ts +++ b/lib/rest/supersim/v1/networkAccessProfile/networkAccessProfileNetwork.ts @@ -222,27 +222,27 @@ export class NetworkAccessProfileNetworkInstance { } /** - * The unique string that identifies the resource + * The unique string that identifies the Network resource. */ sid: string; /** - * The unique string that identifies the Network Access Profile resource + * The unique string that identifies the Network resource\'s Network Access Profile resource. */ networkAccessProfileSid: string; /** - * A human readable identifier of this resource + * A human readable identifier of the Network this resource refers to. */ friendlyName: string; /** - * The ISO country code of the Network resource + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the Network resource. */ isoCountry: string; /** - * The MCC/MNCs included in the resource + * Array of objects identifying the [MCC-MNCs](https://en.wikipedia.org/wiki/Mobile_country_code) that are included in the Network resource. */ identifiers: Array; /** - * The absolute URL of the resource + * The absolute URL of the Network resource. */ url: string; diff --git a/lib/rest/supersim/v1/settingsUpdate.ts b/lib/rest/supersim/v1/settingsUpdate.ts index 838549fb89..90af92850a 100644 --- a/lib/rest/supersim/v1/settingsUpdate.ts +++ b/lib/rest/supersim/v1/settingsUpdate.ts @@ -280,32 +280,32 @@ export class SettingsUpdateInstance { } /** - * The unique identifier of this Settings Update + * The unique identifier of this Settings Update. */ sid: string; /** - * The ICCID associated with the SIM + * The [ICCID](https://en.wikipedia.org/wiki/SIM_card#ICCID) associated with the SIM. */ iccid: string; /** - * The SID of the Super SIM to which this Settings Update was applied + * The SID of the Super SIM to which this Settings Update was applied. */ simSid: string; status: SettingsUpdateStatus; /** - * Array containing the different Settings Packages that will be applied to the SIM after the update completes + * Array containing the different Settings Packages that will be applied to the SIM after the update completes. Each object within the array indicates the name and the version of the Settings Package that will be on the SIM if the update is successful. */ packages: Array; /** - * The time when the update successfully completed and the new settings were applied to the SIM + * The time, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format, when the update successfully completed and the new settings were applied to the SIM. */ dateCompleted: Date; /** - * The date this Settings Update was created + * The date that this Settings Update was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The date this Settings Update was last updated + * The date that this Settings Update was updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; diff --git a/lib/rest/supersim/v1/sim.ts b/lib/rest/supersim/v1/sim.ts index 4db062422b..097b25cc50 100644 --- a/lib/rest/supersim/v1/sim.ts +++ b/lib/rest/supersim/v1/sim.ts @@ -309,36 +309,36 @@ export class SimInstance { } /** - * The unique string that identifies the resource + * The unique string that identifies the Sim resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The SID of the Account that the Super SIM belongs to + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that the Super SIM belongs to. */ accountSid: string; /** - * The ICCID associated with the SIM + * The [ICCID](https://en.wikipedia.org/wiki/Subscriber_identity_module#ICCID) associated with the SIM. */ iccid: string; status: SimStatus; /** - * The unique ID of the Fleet configured for this SIM + * The unique ID of the Fleet configured for this SIM. */ fleetSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Sim Resource + * The absolute URL of the Sim Resource. */ url: string; links: Record; diff --git a/lib/rest/supersim/v1/sim/billingPeriod.ts b/lib/rest/supersim/v1/sim/billingPeriod.ts index 993c64a4d9..497059fef8 100644 --- a/lib/rest/supersim/v1/sim/billingPeriod.ts +++ b/lib/rest/supersim/v1/sim/billingPeriod.ts @@ -270,32 +270,32 @@ export class BillingPeriodInstance { } /** - * The SID of the Billing Period + * The SID of the Billing Period. */ sid: string; /** - * The SID of the Account the Super SIM belongs to + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) the Super SIM belongs to. */ accountSid: string; /** - * The SID of the Super SIM the Billing Period belongs to + * The SID of the Super SIM the Billing Period belongs to. */ simSid: string; /** - * The start time of the Billing Period + * The start time of the Billing Period specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ startTime: Date; /** - * The end time of the Billing Period + * The end time of the Billing Period specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ endTime: Date; periodType: BillingPeriodBpType; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; diff --git a/lib/rest/supersim/v1/smsCommand.ts b/lib/rest/supersim/v1/smsCommand.ts index d01ad6e3b7..3f02bc7468 100644 --- a/lib/rest/supersim/v1/smsCommand.ts +++ b/lib/rest/supersim/v1/smsCommand.ts @@ -206,33 +206,33 @@ export class SmsCommandInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the SMS Command resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the SMS Command resource. */ accountSid: string; /** - * The SID of the SIM that this SMS Command was sent to or from + * The SID of the [SIM](https://www.twilio.com/docs/iot/supersim/api/sim-resource) that this SMS Command was sent to or from. */ simSid: string; /** - * The message body of the SMS Command sent to or from the SIM + * The message body of the SMS Command sent to or from the SIM. For text mode messages, this can be up to 160 characters. */ payload: string; status: SmsCommandStatus; direction: SmsCommandDirection; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the SMS Command resource + * The absolute URL of the SMS Command resource. */ url: string; diff --git a/lib/rest/supersim/v1/usageRecord.ts b/lib/rest/supersim/v1/usageRecord.ts index 6b69f39469..459635eea0 100644 --- a/lib/rest/supersim/v1/usageRecord.ts +++ b/lib/rest/supersim/v1/usageRecord.ts @@ -319,27 +319,27 @@ export class UsageRecordInstance { } /** - * The SID of the Account that incurred the usage. + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that incurred the usage. */ accountSid: string; /** - * SID of a Sim resource to which the UsageRecord belongs. + * SID of a Sim resource to which the UsageRecord belongs. Value will only be present when either a value for the `Sim` query parameter is provided or when UsageRecords are grouped by `sim`. Otherwise, the value will be `null`. */ simSid: string; /** - * SID of the Network resource on which the usage occurred. + * SID of the Network resource the usage occurred on. Value will only be present when either a value for the `Network` query parameter is provided or when UsageRecords are grouped by `network`. Otherwise, the value will be `null`. */ networkSid: string; /** - * SID of the Fleet resource on which the usage occurred. + * SID of the Fleet resource the usage occurred on. Value will only be present when either a value for the `Fleet` query parameter is provided or when UsageRecords are grouped by `fleet`. Otherwise, the value will be `null`. */ fleetSid: string; /** - * Alpha-2 ISO Country Code of the country the usage occurred in. + * Alpha-2 ISO Country Code that the usage occurred in. Value will only be present when either a value for the `IsoCountry` query parameter is provided or when UsageRecords are grouped by `isoCountry`. Otherwise, the value will be `null`. */ isoCountry: string; /** - * The time period for which the usage is reported. + * The time period for which the usage is reported. The period is represented as a pair of `start_time` and `end_time` timestamps specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ period: any; /** @@ -355,11 +355,11 @@ export class UsageRecordInstance { */ dataTotal: number; /** - * Total amount in the `billed_unit` that was charged for the data uploaded or downloaded. + * Total amount in the `billed_unit` that was charged for the data uploaded or downloaded. Will return 0 for usage prior to February 1, 2022. Value may be 0 despite `data_total` being greater than 0 if the data usage is still being processed by Twilio\'s billing system. Refer to [Data Usage Processing](https://www.twilio.com/docs/iot/supersim/api/usage-record-resource#data-usage-processing) for more details. */ dataTotalBilled: number; /** - * The currency in which the billed amounts are measured, specified in the 3 letter ISO 4127 format (e.g. `USD`, `EUR`, `JPY`). + * The currency in which the billed amounts are measured, specified in the 3 letter ISO 4127 format (e.g. `USD`, `EUR`, `JPY`). This can be null when data_toal_billed is 0 and we do not yet have billing information for the corresponding data usage. Refer to [Data Usage Processing](https://www.twilio.com/docs/iot/supersim/api/usage-record-resource#data-usage-processing) for more details. */ billedUnit: string; diff --git a/lib/rest/sync/v1/service.ts b/lib/rest/sync/v1/service.ts index e06a5a668e..2f5b79109b 100644 --- a/lib/rest/sync/v1/service.ts +++ b/lib/rest/sync/v1/service.ts @@ -368,59 +368,59 @@ export class ServiceInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Service resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. It is a read-only property, it cannot be assigned using REST API. */ uniqueName: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Service resource + * The absolute URL of the Service resource. */ url: string; /** - * The URL we call when Sync objects are manipulated + * The URL we call when Sync objects are manipulated. */ webhookUrl: string; /** - * Whether the Service instance should call webhook_url when the REST API is used to update Sync objects + * Whether the Service instance should call `webhook_url` when the REST API is used to update Sync objects. The default is `false`. */ webhooksFromRestEnabled: boolean; /** - * Whether the service instance calls webhook_url when client endpoints connect to Sync + * Whether the service instance calls `webhook_url` when client endpoints connect to Sync. The default is `false`. */ reachabilityWebhooksEnabled: boolean; /** - * Whether token identities in the Service must be granted access to Sync objects by using the Permissions resource + * Whether token identities in the Service must be granted access to Sync objects by using the [Permissions](https://www.twilio.com/docs/sync/api/sync-permissions) resource. It is disabled (false) by default. */ aclEnabled: boolean; /** - * Whether every endpoint_disconnected event occurs after a configurable delay + * Whether every `endpoint_disconnected` event should occur after a configurable delay. The default is `false`, where the `endpoint_disconnected` event occurs immediately after disconnection. When `true`, intervening reconnections can prevent the `endpoint_disconnected` event. */ reachabilityDebouncingEnabled: boolean; /** - * The reachability event delay in milliseconds + * The reachability event delay in milliseconds if `reachability_debouncing_enabled` = `true`. Must be between 1,000 and 30,000 and defaults to 5,000. This is the number of milliseconds after the last running client disconnects, and a Sync identity is declared offline, before `webhook_url` is called, if all endpoints remain offline. A reconnection from the same identity by any endpoint during this interval prevents the reachability event from occurring. */ reachabilityDebouncingWindow: number; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/sync/v1/service/document.ts b/lib/rest/sync/v1/service/document.ts index 05028c4652..b94b5d4371 100644 --- a/lib/rest/sync/v1/service/document.ts +++ b/lib/rest/sync/v1/service/document.ts @@ -324,51 +324,51 @@ export class DocumentInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Document resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource and can be up to 320 characters long. */ uniqueName: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Document resource. */ accountSid: string; /** - * The SID of the Sync Service that the resource is associated with + * The SID of the [Sync Service](https://www.twilio.com/docs/sync/api/service) the resource is associated with. */ serviceSid: string; /** - * The absolute URL of the Document resource + * The absolute URL of the Document resource. */ url: string; /** - * The URLs of resources related to the Sync Document + * The URLs of resources related to the Sync Document. */ links: Record; /** - * The current revision of the Sync Document, represented by a string identifier + * The current revision of the Sync Document, represented as a string. The `revision` property is used with conditional updates to ensure data consistency. */ revision: string; /** - * An arbitrary, schema-less object that the Sync Document stores + * An arbitrary, schema-less object that the Sync Document stores. Can be up to 16 KiB in length. */ data: any; /** - * The ISO 8601 date and time in GMT when the Sync Document expires + * The date and time in GMT when the Sync Document expires and will be deleted, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. If the Sync Document does not expire, this value is `null`. The Document resource might not be deleted immediately after it expires. */ dateExpires: Date; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The identity of the Sync Document\'s creator + * The identity of the Sync Document\'s creator. If the Sync Document is created from the client SDK, the value matches the Access Token\'s `identity` field. If the Sync Document was created from the REST API, the value is `system`. */ createdBy: string; diff --git a/lib/rest/sync/v1/service/document/documentPermission.ts b/lib/rest/sync/v1/service/document/documentPermission.ts index b35d1a5fcf..a24f08206e 100644 --- a/lib/rest/sync/v1/service/document/documentPermission.ts +++ b/lib/rest/sync/v1/service/document/documentPermission.ts @@ -307,35 +307,35 @@ export class DocumentPermissionInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Document Permission resource. */ accountSid: string; /** - * The SID of the Sync Service that the resource is associated with + * The SID of the [Sync Service](https://www.twilio.com/docs/sync/api/service) the resource is associated with. */ serviceSid: string; /** - * The Sync Document SID + * The SID of the Sync Document to which the Document Permission applies. */ documentSid: string; /** - * The identity of the user to whom the Sync Document Permission applies + * The application-defined string that uniquely identifies the resource\'s User within the Service to an FPA token. */ identity: string; /** - * Read access + * Whether the identity can read the Sync Document. */ read: boolean; /** - * Write access + * Whether the identity can update the Sync Document. */ write: boolean; /** - * Manage access + * Whether the identity can delete the Sync Document. */ manage: boolean; /** - * The absolute URL of the Sync Document Permission resource + * The absolute URL of the Sync Document Permission resource. */ url: string; diff --git a/lib/rest/sync/v1/service/syncList.ts b/lib/rest/sync/v1/service/syncList.ts index 78c5c54259..c669ab4e4a 100644 --- a/lib/rest/sync/v1/service/syncList.ts +++ b/lib/rest/sync/v1/service/syncList.ts @@ -332,47 +332,47 @@ export class SyncListInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Sync List resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Sync List resource. */ accountSid: string; /** - * The SID of the Sync Service that the resource is associated with + * The SID of the [Sync Service](https://www.twilio.com/docs/sync/api/service) the resource is associated with. */ serviceSid: string; /** - * The absolute URL of the Sync List resource + * The absolute URL of the Sync List resource. */ url: string; /** - * The URLs of the Sync List\'s nested resources + * The URLs of the Sync List\'s nested resources. */ links: Record; /** - * The current revision of the Sync List, represented as a string + * The current revision of the Sync List, represented as a string. */ revision: string; /** - * The ISO 8601 date and time in GMT when the Sync List expires + * The date and time in GMT when the Sync List expires and will be deleted, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. If the Sync List does not expire, this value is `null`. The Sync List might not be deleted immediately after it expires. */ dateExpires: Date; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The identity of the Sync List\'s creator + * The identity of the Sync List\'s creator. If the Sync List is created from the client SDK, the value matches the Access Token\'s `identity` field. If the Sync List was created from the REST API, the value is `system`. */ createdBy: string; diff --git a/lib/rest/sync/v1/service/syncList/syncListItem.ts b/lib/rest/sync/v1/service/syncList/syncListItem.ts index e7724ef4fe..0b952ed78f 100644 --- a/lib/rest/sync/v1/service/syncList/syncListItem.ts +++ b/lib/rest/sync/v1/service/syncList/syncListItem.ts @@ -388,47 +388,47 @@ export class SyncListItemInstance { } /** - * The automatically generated index of the List Item + * The automatically generated index of the List Item. The `index` values of the List Items in a Sync List can have gaps in their sequence. */ index: number; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the List Item resource. */ accountSid: string; /** - * The SID of the Sync Service that the resource is associated with + * The SID of the [Sync Service](https://www.twilio.com/docs/sync/api/service) the resource is associated with. */ serviceSid: string; /** - * The SID of the Sync List that contains the List Item + * The SID of the Sync List that contains the List Item. */ listSid: string; /** - * The absolute URL of the List Item resource + * The absolute URL of the List Item resource. */ url: string; /** - * The current revision of the item, represented as a string + * The current revision of the item, represented as a string. */ revision: string; /** - * An arbitrary, schema-less object that the List Item stores + * An arbitrary, schema-less object that the List Item stores. Can be up to 16 KiB in length. */ data: any; /** - * The ISO 8601 date and time in GMT when the List Item expires + * The date and time in GMT when the List Item expires and will be deleted, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. If the List Item does not expire, this value is `null`. The List Item resource might not be deleted immediately after it expires. */ dateExpires: Date; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The identity of the List Item\'s creator + * The identity of the List Item\'s creator. If the item is created from the client SDK, the value matches the Access Token\'s `identity` field. If the item was created from the REST API, the value is `system`. */ createdBy: string; diff --git a/lib/rest/sync/v1/service/syncList/syncListPermission.ts b/lib/rest/sync/v1/service/syncList/syncListPermission.ts index 50623048b1..1fa81fb507 100644 --- a/lib/rest/sync/v1/service/syncList/syncListPermission.ts +++ b/lib/rest/sync/v1/service/syncList/syncListPermission.ts @@ -307,35 +307,35 @@ export class SyncListPermissionInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Sync List Permission resource. */ accountSid: string; /** - * The SID of the Sync Service that the resource is associated with + * The SID of the [Sync Service](https://www.twilio.com/docs/sync/api/service) the resource is associated with. */ serviceSid: string; /** - * The SID of the Sync List to which the Permission applies + * The SID of the Sync List to which the Permission applies. */ listSid: string; /** - * The identity of the user to whom the Sync List Permission applies + * The application-defined string that uniquely identifies the resource\'s User within the Service to an FPA token. */ identity: string; /** - * Read access + * Whether the identity can read the Sync List and its Items. */ read: boolean; /** - * Write access + * Whether the identity can create, update, and delete Items in the Sync List. */ write: boolean; /** - * Manage access + * Whether the identity can delete the Sync List. */ manage: boolean; /** - * The absolute URL of the Sync List Permission resource + * The absolute URL of the Sync List Permission resource. */ url: string; diff --git a/lib/rest/sync/v1/service/syncMap.ts b/lib/rest/sync/v1/service/syncMap.ts index ffeb07f5e3..763069019b 100644 --- a/lib/rest/sync/v1/service/syncMap.ts +++ b/lib/rest/sync/v1/service/syncMap.ts @@ -332,47 +332,47 @@ export class SyncMapInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Sync Map resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Sync Map resource. */ accountSid: string; /** - * The SID of the Sync Service that the resource is associated with + * The SID of the [Sync Service](https://www.twilio.com/docs/sync/api/service) the resource is associated with. */ serviceSid: string; /** - * The absolute URL of the Sync Map resource + * The absolute URL of the Sync Map resource. */ url: string; /** - * The URLs of the Sync Map\'s nested resources + * The URLs of the Sync Map\'s nested resources. */ links: Record; /** - * The current revision of the Sync Map, represented as a string + * The current revision of the Sync Map, represented as a string. */ revision: string; /** - * The ISO 8601 date and time in GMT when the Sync Map expires + * The date and time in GMT when the Sync Map expires and will be deleted, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. If the Sync Map does not expire, this value is `null`. The Sync Map might not be deleted immediately after it expires. */ dateExpires: Date; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The identity of the Sync Map\'s creator + * The identity of the Sync Map\'s creator. If the Sync Map is created from the client SDK, the value matches the Access Token\'s `identity` field. If the Sync Map was created from the REST API, the value is `system`. */ createdBy: string; diff --git a/lib/rest/sync/v1/service/syncMap/syncMapItem.ts b/lib/rest/sync/v1/service/syncMap/syncMapItem.ts index 2bd5617e12..455eddd7c7 100644 --- a/lib/rest/sync/v1/service/syncMap/syncMapItem.ts +++ b/lib/rest/sync/v1/service/syncMap/syncMapItem.ts @@ -390,47 +390,47 @@ export class SyncMapItemInstance { } /** - * The unique, user-defined key for the Map Item + * The unique, user-defined key for the Map Item. */ key: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Map Item resource. */ accountSid: string; /** - * The SID of the Sync Service that the resource is associated with + * The SID of the [Sync Service](https://www.twilio.com/docs/sync/api/service) the resource is associated with. */ serviceSid: string; /** - * The SID of the Sync Map that contains the Map Item + * The SID of the Sync Map that contains the Map Item. */ mapSid: string; /** - * The absolute URL of the Map Item resource + * The absolute URL of the Map Item resource. */ url: string; /** - * The current revision of the Map Item, represented as a string + * The current revision of the Map Item, represented as a string. */ revision: string; /** - * An arbitrary, schema-less object that the Map Item stores + * An arbitrary, schema-less object that the Map Item stores. Can be up to 16 KiB in length. */ data: any; /** - * The ISO 8601 date and time in GMT when the Map Item expires + * The date and time in GMT when the Map Item expires and will be deleted, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. If the Map Item does not expire, this value is `null`. The Map Item might not be deleted immediately after it expires. */ dateExpires: Date; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The identity of the Map Item\'s creator + * The identity of the Map Item\'s creator. If the Map Item is created from the client SDK, the value matches the Access Token\'s `identity` field. If the Map Item was created from the REST API, the value is `system`. */ createdBy: string; diff --git a/lib/rest/sync/v1/service/syncMap/syncMapPermission.ts b/lib/rest/sync/v1/service/syncMap/syncMapPermission.ts index 4ac229ec86..4e671a0f7f 100644 --- a/lib/rest/sync/v1/service/syncMap/syncMapPermission.ts +++ b/lib/rest/sync/v1/service/syncMap/syncMapPermission.ts @@ -305,35 +305,35 @@ export class SyncMapPermissionInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Sync Map Permission resource. */ accountSid: string; /** - * The SID of the Sync Service that the resource is associated with + * The SID of the [Sync Service](https://www.twilio.com/docs/sync/api/service) the resource is associated with. */ serviceSid: string; /** - * Sync Map SID + * The SID of the Sync Map to which the Permission applies. */ mapSid: string; /** - * The identity of the user to whom the Sync Document Permission applies + * The application-defined string that uniquely identifies the resource\'s User within the Service to an FPA token. */ identity: string; /** - * Read access + * Whether the identity can read the Sync Map and its Items. */ read: boolean; /** - * Write access + * Whether the identity can create, update, and delete Items in the Sync Map. */ write: boolean; /** - * Manage access + * Whether the identity can delete the Sync Map. */ manage: boolean; /** - * The absolute URL of the Sync Map Permission resource + * The absolute URL of the Sync Map Permission resource. */ url: string; diff --git a/lib/rest/sync/v1/service/syncStream.ts b/lib/rest/sync/v1/service/syncStream.ts index 01b3b87887..ceff0cba24 100644 --- a/lib/rest/sync/v1/service/syncStream.ts +++ b/lib/rest/sync/v1/service/syncStream.ts @@ -310,43 +310,43 @@ export class SyncStreamInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Sync Stream resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Sync Stream resource. */ accountSid: string; /** - * The SID of the Sync Service that the resource is associated with + * The SID of the [Sync Service](https://www.twilio.com/docs/sync/api/service) the resource is associated with. */ serviceSid: string; /** - * The absolute URL of the Message Stream resource + * The absolute URL of the Message Stream resource. */ url: string; /** - * The URLs of the Stream\'s nested resources + * The URLs of the Stream\'s nested resources. */ links: Record; /** - * The ISO 8601 date and time in GMT when the Message Stream expires + * The date and time in GMT when the Message Stream expires and will be deleted, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. If the Message Stream does not expire, this value is `null`. The Stream might not be deleted immediately after it expires. */ dateExpires: Date; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The Identity of the Stream\'s creator + * The identity of the Stream\'s creator. If the Stream is created from the client SDK, the value matches the Access Token\'s `identity` field. If the Stream was created from the REST API, the value is \'system\'. */ createdBy: string; diff --git a/lib/rest/sync/v1/service/syncStream/streamMessage.ts b/lib/rest/sync/v1/service/syncStream/streamMessage.ts index 28ecb42986..bcd5764cd5 100644 --- a/lib/rest/sync/v1/service/syncStream/streamMessage.ts +++ b/lib/rest/sync/v1/service/syncStream/streamMessage.ts @@ -152,11 +152,11 @@ export class StreamMessageInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Stream Message resource. */ sid: string; /** - * Stream Message body + * An arbitrary, schema-less object that contains the Stream Message body. Can be up to 4 KiB in length. */ data: any; diff --git a/lib/rest/taskrouter/v1/workspace.ts b/lib/rest/taskrouter/v1/workspace.ts index 2a267391f6..71af7f8f90 100644 --- a/lib/rest/taskrouter/v1/workspace.ts +++ b/lib/rest/taskrouter/v1/workspace.ts @@ -434,60 +434,60 @@ export class WorkspaceInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Workspace resource. */ accountSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The name of the default activity + * The name of the default activity. */ defaultActivityName: string; /** - * The SID of the Activity that will be used when new Workers are created in the Workspace + * The SID of the Activity that will be used when new Workers are created in the Workspace. */ defaultActivitySid: string; /** - * The URL we call when an event occurs + * The URL we call when an event occurs. If provided, the Workspace will publish events to this URL, for example, to collect data for reporting. See [Workspace Events](https://www.twilio.com/docs/taskrouter/api/event) for more information. This parameter supports Twilio\'s [Webhooks (HTTP callbacks) Connection Overrides](https://www.twilio.com/docs/usage/webhooks/webhooks-connection-overrides). */ eventCallbackUrl: string; /** - * The list of Workspace events for which to call event_callback_url + * The list of Workspace events for which to call `event_callback_url`. For example, if `EventsFilter=task.created, task.canceled, worker.activity.update`, then TaskRouter will call event_callback_url only when a task is created, canceled, or a Worker activity is updated. */ eventsFilter: string; /** - * The string that you assigned to describe the Workspace resource + * The string that you assigned to describe the Workspace resource. For example `Customer Support` or `2014 Election Campaign`. */ friendlyName: string; /** - * Whether multi-tasking is enabled + * Whether multi-tasking is enabled. The default is `true`, which enables multi-tasking. Multi-tasking allows Workers to handle multiple Tasks simultaneously. When enabled (`true`), each Worker can receive parallel reservations up to the per-channel maximums defined in the Workers section. In single-tasking each Worker would only receive a new reservation when the previous task is completed. Learn more at [Multitasking](https://www.twilio.com/docs/taskrouter/multitasking). */ multiTaskEnabled: boolean; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Workspace resource. */ sid: string; /** - * The name of the timeout activity + * The name of the timeout activity. */ timeoutActivityName: string; /** - * The SID of the Activity that will be assigned to a Worker when a Task reservation times out without a response + * The SID of the Activity that will be assigned to a Worker when a Task reservation times out without a response. */ timeoutActivitySid: string; prioritizeQueueOrder: WorkspaceQueueOrder; /** - * The absolute URL of the Workspace resource + * The absolute URL of the Workspace resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/taskrouter/v1/workspace/activity.ts b/lib/rest/taskrouter/v1/workspace/activity.ts index 01beac7d53..fb3c023653 100644 --- a/lib/rest/taskrouter/v1/workspace/activity.ts +++ b/lib/rest/taskrouter/v1/workspace/activity.ts @@ -305,35 +305,35 @@ export class ActivityInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Activity resource. */ accountSid: string; /** - * Whether the Worker should be eligible to receive a Task when it occupies the Activity + * Whether the Worker is eligible to receive a Task when it occupies the Activity. A value of `true`, `1`, or `yes` indicates the Activity is available. All other values indicate that it is not. The value cannot be changed after the Activity is created. */ available: boolean; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the Activity resource + * The string that you assigned to describe the Activity resource. */ friendlyName: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Activity resource. */ sid: string; /** - * The SID of the Workspace that contains the Activity + * The SID of the Workspace that contains the Activity. */ workspaceSid: string; /** - * The absolute URL of the Activity resource + * The absolute URL of the Activity resource. */ url: string; links: Record; diff --git a/lib/rest/taskrouter/v1/workspace/event.ts b/lib/rest/taskrouter/v1/workspace/event.ts index 7318a2f9a4..707f3f0189 100644 --- a/lib/rest/taskrouter/v1/workspace/event.ts +++ b/lib/rest/taskrouter/v1/workspace/event.ts @@ -260,71 +260,71 @@ export class EventInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Event resource. */ accountSid: string; /** - * The SID of the resource that triggered the event + * The SID of the resource that triggered the event. */ actorSid: string; /** - * The type of resource that triggered the event + * The type of resource that triggered the event. */ actorType: string; /** - * The absolute URL of the resource that triggered the event + * The absolute URL of the resource that triggered the event. */ actorUrl: string; /** - * A description of the event + * A description of the event. */ description: string; /** - * Data about the event + * Data about the event. For more information, see [Event types](https://www.twilio.com/docs/taskrouter/api/event#event-types). */ eventData: any; /** - * The time the event was sent + * The time the event was sent, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ eventDate: Date; /** - * The time the event was sent in milliseconds + * The time the event was sent in milliseconds. */ eventDateMs: number; /** - * The identifier for the event + * The identifier for the event. */ eventType: string; /** - * The SID of the object the event is most relevant to + * The SID of the object the event is most relevant to, such as a TaskSid, ReservationSid, or a WorkerSid. */ resourceSid: string; /** - * The type of object the event is most relevant to + * The type of object the event is most relevant to, such as a Task, Reservation, or a Worker). */ resourceType: string; /** - * The URL of the resource the event is most relevant to + * The URL of the resource the event is most relevant to. */ resourceUrl: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Event resource. */ sid: string; /** - * Where the Event originated + * Where the Event originated. */ source: string; /** - * The IP from which the Event originated + * The IP from which the Event originated. */ sourceIpAddress: string; /** - * The absolute URL of the Event resource + * The absolute URL of the Event resource. */ url: string; /** - * The SID of the Workspace that contains the Event + * The SID of the Workspace that contains the Event. */ workspaceSid: string; diff --git a/lib/rest/taskrouter/v1/workspace/task.ts b/lib/rest/taskrouter/v1/workspace/task.ts index 1d126b7323..9490f1fd1d 100644 --- a/lib/rest/taskrouter/v1/workspace/task.ts +++ b/lib/rest/taskrouter/v1/workspace/task.ts @@ -459,84 +459,84 @@ export class TaskInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Task resource. */ accountSid: string; /** - * The number of seconds since the Task was created + * The number of seconds since the Task was created. */ age: number; assignmentStatus: TaskStatus; /** - * The JSON string with custom attributes of the work + * The JSON string with custom attributes of the work. **Note** If this property has been assigned a value, it will only be displayed in FETCH action that returns a single resource. Otherwise, it will be null. */ attributes: string; /** - * An object that contains the addon data for all installed addons + * An object that contains the [addon](https://www.twilio.com/docs/taskrouter/marketplace) data for all installed addons. */ addons: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The ISO 8601 date and time in GMT when the Task entered the TaskQueue. + * The date and time in GMT when the Task entered the TaskQueue, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ taskQueueEnteredDate: Date; /** - * Retrieve the list of all Tasks in the Workspace with the specified priority + * The current priority score of the Task as assigned to a Worker by the workflow. Tasks with higher priority values will be assigned before Tasks with lower values. */ priority: number; /** - * The reason the Task was canceled or completed + * The reason the Task was canceled or completed, if applicable. */ reason: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Task resource. */ sid: string; /** - * The SID of the TaskQueue + * The SID of the TaskQueue. */ taskQueueSid: string; /** - * The friendly name of the TaskQueue + * The friendly name of the TaskQueue. */ taskQueueFriendlyName: string; /** - * The SID of the TaskChannel + * The SID of the TaskChannel. */ taskChannelSid: string; /** - * The unique name of the TaskChannel + * The unique name of the TaskChannel. */ taskChannelUniqueName: string; /** - * The amount of time in seconds that the Task can live before being assigned + * The amount of time in seconds that the Task can live before being assigned. */ timeout: number; /** - * The SID of the Workflow that is controlling the Task + * The SID of the Workflow that is controlling the Task. */ workflowSid: string; /** - * The friendly name of the Workflow that is controlling the Task + * The friendly name of the Workflow that is controlling the Task. */ workflowFriendlyName: string; /** - * The SID of the Workspace that contains the Task + * The SID of the Workspace that contains the Task. */ workspaceSid: string; /** - * The absolute URL of the Task resource + * The absolute URL of the Task resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/taskrouter/v1/workspace/task/reservation.ts b/lib/rest/taskrouter/v1/workspace/task/reservation.ts index d3b4540816..d49fd77729 100644 --- a/lib/rest/taskrouter/v1/workspace/task/reservation.ts +++ b/lib/rest/taskrouter/v1/workspace/task/reservation.ts @@ -535,32 +535,32 @@ export class ReservationInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the TaskReservation resource. */ accountSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; reservationStatus: TaskReservationStatus; /** - * The unique string that identifies the resource + * The unique string that we created to identify the TaskReservation resource. */ sid: string; /** - * The SID of the reserved Task resource + * The SID of the reserved Task resource. */ taskSid: string; /** - * The friendly_name of the Worker that is reserved + * The `friendly_name` of the Worker that is reserved. */ workerName: string; /** - * The SID of the reserved Worker resource + * The SID of the reserved Worker resource. */ workerSid: string; /** @@ -568,11 +568,11 @@ export class ReservationInstance { */ workspaceSid: string; /** - * The absolute URL of the TaskReservation reservation + * The absolute URL of the TaskReservation reservation. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/taskrouter/v1/workspace/taskChannel.ts b/lib/rest/taskrouter/v1/workspace/taskChannel.ts index ce678e3013..f942473f53 100644 --- a/lib/rest/taskrouter/v1/workspace/taskChannel.ts +++ b/lib/rest/taskrouter/v1/workspace/taskChannel.ts @@ -303,43 +303,43 @@ export class TaskChannelInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Task Channel resource. */ accountSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Task Channel resource. */ sid: string; /** - * An application-defined string that uniquely identifies the Task Channel + * An application-defined string that uniquely identifies the Task Channel, such as `voice` or `sms`. */ uniqueName: string; /** - * The SID of the Workspace that contains the Task Channel + * The SID of the Workspace that contains the Task Channel. */ workspaceSid: string; /** - * Whether the Task Channel will prioritize Workers that have been idle + * Whether the Task Channel will prioritize Workers that have been idle. When `true`, Workers that have been idle the longest are prioritized. */ channelOptimizedRouting: boolean; /** - * The absolute URL of the Task Channel resource + * The absolute URL of the Task Channel resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/taskrouter/v1/workspace/taskQueue.ts b/lib/rest/taskrouter/v1/workspace/taskQueue.ts index 32d512877f..f9a3fee597 100644 --- a/lib/rest/taskrouter/v1/workspace/taskQueue.ts +++ b/lib/rest/taskrouter/v1/workspace/taskQueue.ts @@ -404,60 +404,60 @@ export class TaskQueueInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the TaskQueue resource. */ accountSid: string; /** - * The SID of the Activity to assign Workers when a task is assigned for them + * The SID of the Activity to assign Workers when a task is assigned for them. */ assignmentActivitySid: string; /** - * The name of the Activity to assign Workers when a task is assigned for them + * The name of the Activity to assign Workers when a task is assigned for them. */ assignmentActivityName: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The maximum number of Workers to reserve + * The maximum number of Workers to reserve for the assignment of a task in the queue. Can be an integer between 1 and 50, inclusive and defaults to 1. */ maxReservedWorkers: number; /** - * The SID of the Activity to assign Workers once a task is reserved for them + * The SID of the Activity to assign Workers once a task is reserved for them. */ reservationActivitySid: string; /** - * The name of the Activity to assign Workers once a task is reserved for them + * The name of the Activity to assign Workers once a task is reserved for them. */ reservationActivityName: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the TaskQueue resource. */ sid: string; /** - * A string describing the Worker selection criteria for any Tasks that enter the TaskQueue + * A string describing the Worker selection criteria for any Tasks that enter the TaskQueue. For example `\'\"language\" == \"spanish\"\'` If no TargetWorkers parameter is provided, Tasks will wait in the TaskQueue until they are either deleted or moved to another TaskQueue. Additional examples on how to describing Worker selection criteria below. Defaults to 1==1. */ targetWorkers: string; taskOrder: TaskQueueTaskOrder; /** - * The absolute URL of the TaskQueue resource + * The absolute URL of the TaskQueue resource. */ url: string; /** - * The SID of the Workspace that contains the TaskQueue + * The SID of the Workspace that contains the TaskQueue. */ workspaceSid: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueueCumulativeStatistics.ts b/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueueCumulativeStatistics.ts index a94c061b50..dc72852862 100644 --- a/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueueCumulativeStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueueCumulativeStatistics.ts @@ -252,91 +252,91 @@ export class TaskQueueCumulativeStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the TaskQueue resource. */ accountSid: string; /** - * The average time in seconds between Task creation and acceptance + * The average time in seconds between Task creation and acceptance. */ avgTaskAcceptanceTime: number; /** - * The beginning of the interval during which these statistics were calculated + * The beginning of the interval during which these statistics were calculated, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ startTime: Date; /** - * The end of the interval during which these statistics were calculated + * The end of the interval during which these statistics were calculated, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ endTime: Date; /** - * The total number of Reservations created for Tasks in the TaskQueue + * The total number of Reservations created for Tasks in the TaskQueue. */ reservationsCreated: number; /** - * The total number of Reservations accepted for Tasks in the TaskQueue + * The total number of Reservations accepted for Tasks in the TaskQueue. */ reservationsAccepted: number; /** - * The total number of Reservations rejected for Tasks in the TaskQueue + * The total number of Reservations rejected for Tasks in the TaskQueue. */ reservationsRejected: number; /** - * The total number of Reservations that timed out for Tasks in the TaskQueue + * The total number of Reservations that timed out for Tasks in the TaskQueue. */ reservationsTimedOut: number; /** - * The total number of Reservations canceled for Tasks in the TaskQueue + * The total number of Reservations canceled for Tasks in the TaskQueue. */ reservationsCanceled: number; /** - * The total number of Reservations rescinded + * The total number of Reservations rescinded. */ reservationsRescinded: number; /** - * A list of objects that describe the Tasks canceled and reservations accepted above and below the specified thresholds + * A list of objects that describe the number of Tasks canceled and reservations accepted above and below the thresholds specified in seconds. */ splitByWaitTime: any; /** - * The SID of the TaskQueue from which these statistics were calculated + * The SID of the TaskQueue from which these statistics were calculated. */ taskQueueSid: string; /** - * The wait duration statistics for Tasks accepted while in the TaskQueue + * The wait duration statistics (`avg`, `min`, `max`, `total`) for Tasks accepted while in the TaskQueue. Calculation is based on the time when the Tasks were created. For transfers, the wait duration is counted from the moment ***the Task was created***, and not from when the transfer was initiated. */ waitDurationUntilAccepted: any; /** - * The wait duration statistics for Tasks canceled while in the TaskQueue + * The wait duration statistics (`avg`, `min`, `max`, `total`) for Tasks canceled while in the TaskQueue. */ waitDurationUntilCanceled: any; /** - * The relative wait duration statistics for Tasks accepted while in the TaskQueue + * The relative wait duration statistics (`avg`, `min`, `max`, `total`) for Tasks accepted while in the TaskQueue. Calculation is based on the time when the Tasks entered the TaskQueue. */ waitDurationInQueueUntilAccepted: any; /** - * The total number of Tasks canceled in the TaskQueue + * The total number of Tasks canceled in the TaskQueue. */ tasksCanceled: number; /** - * The total number of Tasks completed in the TaskQueue + * The total number of Tasks completed in the TaskQueue. */ tasksCompleted: number; /** - * The total number of Tasks deleted in the TaskQueue + * The total number of Tasks deleted in the TaskQueue. */ tasksDeleted: number; /** - * The total number of Tasks entered into the TaskQueue + * The total number of Tasks entered into the TaskQueue. */ tasksEntered: number; /** - * The total number of Tasks that were moved from one queue to another + * The total number of Tasks that were moved from one queue to another. */ tasksMoved: number; /** - * The SID of the Workspace that contains the TaskQueue + * The SID of the Workspace that contains the TaskQueue. */ workspaceSid: string; /** - * The absolute URL of the TaskQueue statistics resource + * The absolute URL of the TaskQueue statistics resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueueRealTimeStatistics.ts b/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueueRealTimeStatistics.ts index 89629123b7..76171754c0 100644 --- a/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueueRealTimeStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueueRealTimeStatistics.ts @@ -215,59 +215,59 @@ export class TaskQueueRealTimeStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the TaskQueue resource. */ accountSid: string; /** - * The number of current Workers by Activity + * The number of current Workers by Activity. */ activityStatistics: Array; /** - * The age of the longest waiting Task + * The age of the longest waiting Task. */ longestTaskWaitingAge: number; /** - * The SID of the longest waiting Task + * The SID of the longest waiting Task. */ longestTaskWaitingSid: string; /** - * The relative age in the TaskQueue for the longest waiting Task. + * The relative age in the TaskQueue for the longest waiting Task. Calculation is based on the time when the Task entered the TaskQueue. */ longestRelativeTaskAgeInQueue: number; /** - * The SID of the Task waiting in the TaskQueue the longest. + * The Task SID of the Task waiting in the TaskQueue the longest. Calculation is based on the time when the Task entered the TaskQueue. */ longestRelativeTaskSidInQueue: string; /** - * The SID of the TaskQueue from which these statistics were calculated + * The SID of the TaskQueue from which these statistics were calculated. */ taskQueueSid: string; /** - * The number of Tasks by priority + * The number of Tasks by priority. For example: `{\"0\": \"10\", \"99\": \"5\"}` shows 10 Tasks at priority 0 and 5 at priority 99. */ tasksByPriority: any; /** - * The number of Tasks by their current status + * The number of Tasks by their current status. For example: `{\"pending\": \"1\", \"reserved\": \"3\", \"assigned\": \"2\", \"completed\": \"5\"}`. */ tasksByStatus: any; /** - * The total number of Workers available for Tasks in the TaskQueue + * The total number of Workers available for Tasks in the TaskQueue. */ totalAvailableWorkers: number; /** - * The total number of Workers eligible for Tasks in the TaskQueue, independent of their Activity state + * The total number of Workers eligible for Tasks in the TaskQueue, independent of their Activity state. */ totalEligibleWorkers: number; /** - * The total number of Tasks + * The total number of Tasks. */ totalTasks: number; /** - * The SID of the Workspace that contains the TaskQueue + * The SID of the Workspace that contains the TaskQueue. */ workspaceSid: string; /** - * The absolute URL of the TaskQueue statistics resource + * The absolute URL of the TaskQueue statistics resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueueStatistics.ts b/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueueStatistics.ts index 8eeca4e500..7870a9ccc2 100644 --- a/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueueStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueueStatistics.ts @@ -192,27 +192,27 @@ export class TaskQueueStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the TaskQueue resource. */ accountSid: string; /** - * An object that contains the cumulative statistics for the TaskQueue + * An object that contains the cumulative statistics for the TaskQueue. */ cumulative: any; /** - * An object that contains the real-time statistics for the TaskQueue + * An object that contains the real-time statistics for the TaskQueue. */ realtime: any; /** - * The SID of the TaskQueue from which these statistics were calculated + * The SID of the TaskQueue from which these statistics were calculated. */ taskQueueSid: string; /** - * The SID of the Workspace that contains the TaskQueue + * The SID of the Workspace that contains the TaskQueue. */ workspaceSid: string; /** - * The absolute URL of the TaskQueue statistics resource + * The absolute URL of the TaskQueue statistics resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueuesStatistics.ts b/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueuesStatistics.ts index ee0dce3280..632ccb51da 100644 --- a/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueuesStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/taskQueue/taskQueuesStatistics.ts @@ -326,23 +326,23 @@ export class TaskQueuesStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the TaskQueue resource. */ accountSid: string; /** - * An object that contains the cumulative statistics for the TaskQueues + * An object that contains the cumulative statistics for the TaskQueues. */ cumulative: any; /** - * An object that contains the real-time statistics for the TaskQueues + * An object that contains the real-time statistics for the TaskQueues. */ realtime: any; /** - * The SID of the TaskQueue from which these statistics were calculated + * The SID of the TaskQueue from which these statistics were calculated. */ taskQueueSid: string; /** - * The SID of the Workspace that contains the TaskQueues + * The SID of the Workspace that contains the TaskQueues. */ workspaceSid: string; diff --git a/lib/rest/taskrouter/v1/workspace/worker.ts b/lib/rest/taskrouter/v1/workspace/worker.ts index 296625d7dc..04402465a0 100644 --- a/lib/rest/taskrouter/v1/workspace/worker.ts +++ b/lib/rest/taskrouter/v1/workspace/worker.ts @@ -456,55 +456,55 @@ export class WorkerInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Worker resource. */ accountSid: string; /** - * The friendly_name of the Worker\'s current Activity + * The `friendly_name` of the Worker\'s current Activity. */ activityName: string; /** - * The SID of the Worker\'s current Activity + * The SID of the Worker\'s current Activity. */ activitySid: string; /** - * The JSON string that describes the Worker + * The JSON string that describes the Worker. For example: `{ \"email\": \"Bob@example.com\", \"phone\": \"+5095551234\" }`. **Note** If this property has been assigned a value, it will only be displayed in FETCH actions that return a single resource. Otherwise, this property will be null, even if it has a value. This data is passed to the `assignment_callback_url` when TaskRouter assigns a Task to the Worker. */ attributes: string; /** - * Whether the Worker is available to perform tasks + * Whether the Worker is available to perform tasks. */ available: boolean; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The date and time in GMT of the last change to the Worker\'s activity + * The date and time in GMT of the last change to the Worker\'s activity specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. Used to calculate Workflow statistics. */ dateStatusChanged: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. Friendly names are case insensitive, and unique within the TaskRouter Workspace. */ friendlyName: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Worker resource. */ sid: string; /** - * The SID of the Workspace that contains the Worker + * The SID of the Workspace that contains the Worker. */ workspaceSid: string; /** - * The absolute URL of the Worker resource + * The absolute URL of the Worker resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/taskrouter/v1/workspace/worker/reservation.ts b/lib/rest/taskrouter/v1/workspace/worker/reservation.ts index 121e4725d7..171edc2c2b 100644 --- a/lib/rest/taskrouter/v1/workspace/worker/reservation.ts +++ b/lib/rest/taskrouter/v1/workspace/worker/reservation.ts @@ -519,32 +519,32 @@ export class ReservationInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the WorkerReservation resource. */ accountSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; reservationStatus: WorkerReservationStatus; /** - * The unique string that identifies the resource + * The unique string that we created to identify the WorkerReservation resource. */ sid: string; /** - * The SID of the reserved Task resource + * The SID of the reserved Task resource. */ taskSid: string; /** - * The friendly_name of the Worker that is reserved + * The `friendly_name` of the Worker that is reserved. */ workerName: string; /** - * The SID of the reserved Worker resource + * The SID of the reserved Worker resource. */ workerSid: string; /** @@ -552,11 +552,11 @@ export class ReservationInstance { */ workspaceSid: string; /** - * The absolute URL of the WorkerReservation resource + * The absolute URL of the WorkerReservation resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/taskrouter/v1/workspace/worker/workerChannel.ts b/lib/rest/taskrouter/v1/workspace/worker/workerChannel.ts index 58385ba1a5..aeca4e9f94 100644 --- a/lib/rest/taskrouter/v1/workspace/worker/workerChannel.ts +++ b/lib/rest/taskrouter/v1/workspace/worker/workerChannel.ts @@ -281,55 +281,55 @@ export class WorkerChannelInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Worker resource. */ accountSid: string; /** - * The total number of Tasks assigned to Worker for the TaskChannel type + * The total number of Tasks assigned to Worker for the TaskChannel type. */ assignedTasks: number; /** - * Whether the Worker should receive Tasks of the TaskChannel type + * Whether the Worker should receive Tasks of the TaskChannel type. */ available: boolean; /** - * The current available capacity between 0 to 100 for the TaskChannel + * The current percentage of capacity the TaskChannel has available. Can be a number between `0` and `100`. A value of `0` indicates that TaskChannel has no capacity available and a value of `100` means the Worker is available to receive any Tasks of this TaskChannel type. */ availableCapacityPercentage: number; /** - * The current configured capacity for the WorkerChannel + * The current configured capacity for the WorkerChannel. TaskRouter will not create any reservations after the assigned Tasks for the Worker reaches the value. */ configuredCapacity: number; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The unique string that identifies the resource + * The unique string that we created to identify the WorkerChannel resource. */ sid: string; /** - * The SID of the TaskChannel + * The SID of the TaskChannel. */ taskChannelSid: string; /** - * The unique name of the TaskChannel, such as \'voice\' or \'sms\' + * The unique name of the TaskChannel, such as `voice` or `sms`. */ taskChannelUniqueName: string; /** - * The SID of the Worker that contains the WorkerChannel + * The SID of the Worker that contains the WorkerChannel. */ workerSid: string; /** - * The SID of the Workspace that contains the WorkerChannel + * The SID of the Workspace that contains the WorkerChannel. */ workspaceSid: string; /** - * The absolute URL of the WorkerChannel resource + * The absolute URL of the WorkerChannel resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/worker/workerStatistics.ts b/lib/rest/taskrouter/v1/workspace/worker/workerStatistics.ts index e492305cd8..93b566bdcf 100644 --- a/lib/rest/taskrouter/v1/workspace/worker/workerStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/worker/workerStatistics.ts @@ -180,23 +180,23 @@ export class WorkerStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Worker resource. */ accountSid: string; /** - * An object that contains the cumulative statistics for the Worker + * An object that contains the cumulative statistics for the Worker. */ cumulative: any; /** - * The SID of the Worker that contains the WorkerChannel + * The SID of the Worker that contains the WorkerChannel. */ workerSid: string; /** - * The SID of the Workspace that contains the WorkerChannel + * The SID of the Workspace that contains the WorkerChannel. */ workspaceSid: string; /** - * The absolute URL of the WorkerChannel statistics resource + * The absolute URL of the WorkerChannel statistics resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/worker/workersCumulativeStatistics.ts b/lib/rest/taskrouter/v1/workspace/worker/workersCumulativeStatistics.ts index 1f390b33dd..f92358bf96 100644 --- a/lib/rest/taskrouter/v1/workspace/worker/workersCumulativeStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/worker/workersCumulativeStatistics.ts @@ -214,51 +214,51 @@ export class WorkersCumulativeStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Worker resource. */ accountSid: string; /** - * The beginning of the interval during which these statistics were calculated + * The beginning of the interval during which these statistics were calculated, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ startTime: Date; /** - * The end of the interval during which these statistics were calculated + * The end of the interval during which these statistics were calculated, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ endTime: Date; /** - * The minimum, average, maximum, and total time that Workers spent in each Activity + * The minimum, average, maximum, and total time (in seconds) that Workers spent in each Activity. */ activityDurations: Array; /** - * The total number of Reservations that were created + * The total number of Reservations that were created. */ reservationsCreated: number; /** - * The total number of Reservations that were accepted + * The total number of Reservations that were accepted. */ reservationsAccepted: number; /** - * The total number of Reservations that were rejected + * The total number of Reservations that were rejected. */ reservationsRejected: number; /** - * The total number of Reservations that were timed out + * The total number of Reservations that were timed out. */ reservationsTimedOut: number; /** - * The total number of Reservations that were canceled + * The total number of Reservations that were canceled. */ reservationsCanceled: number; /** - * The total number of Reservations that were rescinded + * The total number of Reservations that were rescinded. */ reservationsRescinded: number; /** - * The SID of the Workspace that contains the Workers + * The SID of the Workspace that contains the Workers. */ workspaceSid: string; /** - * The absolute URL of the Workers statistics resource + * The absolute URL of the Workers statistics resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/worker/workersRealTimeStatistics.ts b/lib/rest/taskrouter/v1/workspace/worker/workersRealTimeStatistics.ts index b6cc86dacd..b8dfada89b 100644 --- a/lib/rest/taskrouter/v1/workspace/worker/workersRealTimeStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/worker/workersRealTimeStatistics.ts @@ -177,23 +177,23 @@ export class WorkersRealTimeStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Worker resource. */ accountSid: string; /** - * The number of current Workers by Activity + * The number of current Workers by Activity. */ activityStatistics: Array; /** - * The total number of Workers + * The total number of Workers. */ totalWorkers: number; /** - * The SID of the Workspace that contains the Workers + * The SID of the Workspace that contains the Workers. */ workspaceSid: string; /** - * The absolute URL of the Workers statistics resource + * The absolute URL of the Workers statistics resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/worker/workersStatistics.ts b/lib/rest/taskrouter/v1/workspace/worker/workersStatistics.ts index 69c92b06ae..c9dd5827a8 100644 --- a/lib/rest/taskrouter/v1/workspace/worker/workersStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/worker/workersStatistics.ts @@ -185,23 +185,23 @@ export class WorkersStatisticsInstance { } /** - * An object that contains the real-time statistics for the Worker + * An object that contains the real-time statistics for the Worker. */ realtime: any; /** - * An object that contains the cumulative statistics for the Worker + * An object that contains the cumulative statistics for the Worker. */ cumulative: any; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Worker resource. */ accountSid: string; /** - * The SID of the Workspace that contains the Worker + * The SID of the Workspace that contains the Worker. */ workspaceSid: string; /** - * The absolute URL of the Worker statistics resource + * The absolute URL of the Worker statistics resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/workflow.ts b/lib/rest/taskrouter/v1/workspace/workflow.ts index a586bcacd5..a9eba1608e 100644 --- a/lib/rest/taskrouter/v1/workspace/workflow.ts +++ b/lib/rest/taskrouter/v1/workspace/workflow.ts @@ -381,55 +381,55 @@ export class WorkflowInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Workflow resource. */ accountSid: string; /** - * The URL that we call when a task managed by the Workflow is assigned to a Worker + * The URL that we call when a task managed by the Workflow is assigned to a Worker. See Assignment Callback URL for more information. */ assignmentCallbackUrl: string; /** - * A JSON string that contains the Workflow\'s configuration + * A JSON string that contains the Workflow\'s configuration. See [Configuring Workflows](https://www.twilio.com/docs/taskrouter/workflow-configuration) for more information. */ configuration: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The MIME type of the document + * The MIME type of the document. */ documentContentType: string; /** - * The URL that we call when a call to the `assignment_callback_url` fails + * The URL that we call when a call to the `assignment_callback_url` fails. */ fallbackAssignmentCallbackUrl: string; /** - * The string that you assigned to describe the Workflow resource + * The string that you assigned to describe the Workflow resource. For example, `Customer Support` or `2014 Election Campaign`. */ friendlyName: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Workflow resource. */ sid: string; /** - * How long TaskRouter will wait for a confirmation response from your application after it assigns a Task to a Worker + * How long TaskRouter will wait for a confirmation response from your application after it assigns a Task to a Worker. Can be up to `86,400` (24 hours) and the default is `120`. */ taskReservationTimeout: number; /** - * The SID of the Workspace that contains the Workflow + * The SID of the Workspace that contains the Workflow. */ workspaceSid: string; /** - * The absolute URL of the Workflow resource + * The absolute URL of the Workflow resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/taskrouter/v1/workspace/workflow/workflowCumulativeStatistics.ts b/lib/rest/taskrouter/v1/workspace/workflow/workflowCumulativeStatistics.ts index 0eeddbcd4d..37a96dec2c 100644 --- a/lib/rest/taskrouter/v1/workspace/workflow/workflowCumulativeStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/workflow/workflowCumulativeStatistics.ts @@ -253,83 +253,83 @@ export class WorkflowCumulativeStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Workflow resource. */ accountSid: string; /** - * The average time in seconds between Task creation and acceptance + * The average time in seconds between Task creation and acceptance. */ avgTaskAcceptanceTime: number; /** - * The beginning of the interval during which these statistics were calculated + * The beginning of the interval during which these statistics were calculated, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ startTime: Date; /** - * The end of the interval during which these statistics were calculated + * The end of the interval during which these statistics were calculated, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ endTime: Date; /** - * The total number of Reservations that were created for Workers + * The total number of Reservations that were created for Workers. */ reservationsCreated: number; /** - * The total number of Reservations accepted by Workers + * The total number of Reservations accepted by Workers. */ reservationsAccepted: number; /** - * The total number of Reservations that were rejected + * The total number of Reservations that were rejected. */ reservationsRejected: number; /** - * The total number of Reservations that were timed out + * The total number of Reservations that were timed out. */ reservationsTimedOut: number; /** - * The total number of Reservations that were canceled + * The total number of Reservations that were canceled. */ reservationsCanceled: number; /** - * The total number of Reservations that were rescinded + * The total number of Reservations that were rescinded. */ reservationsRescinded: number; /** - * A list of objects that describe the Tasks canceled and reservations accepted above and below the specified thresholds + * A list of objects that describe the number of Tasks canceled and reservations accepted above and below the thresholds specified in seconds. */ splitByWaitTime: any; /** - * The wait duration statistics for Tasks that were accepted + * The wait duration statistics (`avg`, `min`, `max`, `total`) for Tasks that were accepted. */ waitDurationUntilAccepted: any; /** - * The wait duration statistics for Tasks that were canceled + * The wait duration statistics (`avg`, `min`, `max`, `total`) for Tasks that were canceled. */ waitDurationUntilCanceled: any; /** - * The total number of Tasks that were canceled + * The total number of Tasks that were canceled. */ tasksCanceled: number; /** - * The total number of Tasks that were completed + * The total number of Tasks that were completed. */ tasksCompleted: number; /** - * The total number of Tasks that entered the Workflow + * The total number of Tasks that entered the Workflow. */ tasksEntered: number; /** - * The total number of Tasks that were deleted + * The total number of Tasks that were deleted. */ tasksDeleted: number; /** - * The total number of Tasks that were moved from one queue to another + * The total number of Tasks that were moved from one queue to another. */ tasksMoved: number; /** - * The total number of Tasks that were timed out of their Workflows + * The total number of Tasks that were timed out of their Workflows (and deleted). */ tasksTimedOutInWorkflow: number; /** - * Returns the list of Tasks that are being controlled by the Workflow with the specified Sid value + * Returns the list of Tasks that are being controlled by the Workflow with the specified Sid value. */ workflowSid: string; /** @@ -337,7 +337,7 @@ export class WorkflowCumulativeStatisticsInstance { */ workspaceSid: string; /** - * The absolute URL of the Workflow statistics resource + * The absolute URL of the Workflow statistics resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/workflow/workflowRealTimeStatistics.ts b/lib/rest/taskrouter/v1/workspace/workflow/workflowRealTimeStatistics.ts index 38e5d0d18b..085d79b9cb 100644 --- a/lib/rest/taskrouter/v1/workspace/workflow/workflowRealTimeStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/workflow/workflowRealTimeStatistics.ts @@ -198,31 +198,31 @@ export class WorkflowRealTimeStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Workflow resource. */ accountSid: string; /** - * The age of the longest waiting Task + * The age of the longest waiting Task. */ longestTaskWaitingAge: number; /** - * The SID of the longest waiting Task + * The SID of the longest waiting Task. */ longestTaskWaitingSid: string; /** - * The number of Tasks by priority + * The number of Tasks by priority. For example: `{\"0\": \"10\", \"99\": \"5\"}` shows 10 Tasks at priority 0 and 5 at priority 99. */ tasksByPriority: any; /** - * The number of Tasks by their current status + * The number of Tasks by their current status. For example: `{\"pending\": \"1\", \"reserved\": \"3\", \"assigned\": \"2\", \"completed\": \"5\"}`. */ tasksByStatus: any; /** - * The total number of Tasks + * The total number of Tasks. */ totalTasks: number; /** - * Returns the list of Tasks that are being controlled by the Workflow with the specified SID value + * Returns the list of Tasks that are being controlled by the Workflow with the specified SID value. */ workflowSid: string; /** @@ -230,7 +230,7 @@ export class WorkflowRealTimeStatisticsInstance { */ workspaceSid: string; /** - * The absolute URL of the Workflow statistics resource + * The absolute URL of the Workflow statistics resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/workflow/workflowStatistics.ts b/lib/rest/taskrouter/v1/workspace/workflow/workflowStatistics.ts index 8007ca653f..45fb1c29ec 100644 --- a/lib/rest/taskrouter/v1/workspace/workflow/workflowStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/workflow/workflowStatistics.ts @@ -192,27 +192,27 @@ export class WorkflowStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Workflow resource. */ accountSid: string; /** - * An object that contains the cumulative statistics for the Workflow + * An object that contains the cumulative statistics for the Workflow. */ cumulative: any; /** - * An object that contains the real-time statistics for the Workflow + * An object that contains the real-time statistics for the Workflow. */ realtime: any; /** - * Returns the list of Tasks that are being controlled by the Workflow with the specified SID value + * Returns the list of Tasks that are being controlled by the Workflow with the specified SID value. */ workflowSid: string; /** - * The SID of the Workspace that contains the Workflow + * The SID of the Workspace that contains the Workflow. */ workspaceSid: string; /** - * The absolute URL of the Workflow statistics resource + * The absolute URL of the Workflow statistics resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/workspaceCumulativeStatistics.ts b/lib/rest/taskrouter/v1/workspace/workspaceCumulativeStatistics.ts index 188a71daca..ddf8ba7299 100644 --- a/lib/rest/taskrouter/v1/workspace/workspaceCumulativeStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/workspaceCumulativeStatistics.ts @@ -240,87 +240,87 @@ export class WorkspaceCumulativeStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Workspace resource. */ accountSid: string; /** - * The average time in seconds between Task creation and acceptance + * The average time in seconds between Task creation and acceptance. */ avgTaskAcceptanceTime: number; /** - * The beginning of the interval during which these statistics were calculated + * The beginning of the interval during which these statistics were calculated, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ startTime: Date; /** - * The end of the interval during which these statistics were calculated + * The end of the interval during which these statistics were calculated, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ endTime: Date; /** - * The total number of Reservations that were created for Workers + * The total number of Reservations that were created for Workers. */ reservationsCreated: number; /** - * The total number of Reservations accepted by Workers + * The total number of Reservations accepted by Workers. */ reservationsAccepted: number; /** - * The total number of Reservations that were rejected + * The total number of Reservations that were rejected. */ reservationsRejected: number; /** - * The total number of Reservations that were timed out + * The total number of Reservations that were timed out. */ reservationsTimedOut: number; /** - * The total number of Reservations that were canceled + * The total number of Reservations that were canceled. */ reservationsCanceled: number; /** - * The total number of Reservations that were rescinded + * The total number of Reservations that were rescinded. */ reservationsRescinded: number; /** - * A list of objects that describe the Tasks canceled and reservations accepted above and below the specified thresholds + * A list of objects that describe the number of Tasks canceled and reservations accepted above and below the thresholds specified in seconds. */ splitByWaitTime: any; /** - * The wait duration statistics for Tasks that were accepted + * The wait duration statistics (`avg`, `min`, `max`, `total`) for Tasks that were accepted. */ waitDurationUntilAccepted: any; /** - * The wait duration statistics for Tasks that were canceled + * The wait duration statistics (`avg`, `min`, `max`, `total`) for Tasks that were canceled. */ waitDurationUntilCanceled: any; /** - * The total number of Tasks that were canceled + * The total number of Tasks that were canceled. */ tasksCanceled: number; /** - * The total number of Tasks that were completed + * The total number of Tasks that were completed. */ tasksCompleted: number; /** - * The total number of Tasks created + * The total number of Tasks created. */ tasksCreated: number; /** - * The total number of Tasks that were deleted + * The total number of Tasks that were deleted. */ tasksDeleted: number; /** - * The total number of Tasks that were moved from one queue to another + * The total number of Tasks that were moved from one queue to another. */ tasksMoved: number; /** - * The total number of Tasks that were timed out of their Workflows + * The total number of Tasks that were timed out of their Workflows (and deleted). */ tasksTimedOutInWorkflow: number; /** - * The SID of the Workspace + * The SID of the Workspace. */ workspaceSid: string; /** - * The absolute URL of the Workspace statistics resource + * The absolute URL of the Workspace statistics resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/workspaceRealTimeStatistics.ts b/lib/rest/taskrouter/v1/workspace/workspaceRealTimeStatistics.ts index bf959db7f4..0a0140dfd9 100644 --- a/lib/rest/taskrouter/v1/workspace/workspaceRealTimeStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/workspaceRealTimeStatistics.ts @@ -189,43 +189,43 @@ export class WorkspaceRealTimeStatisticsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Workspace resource. */ accountSid: string; /** - * The number of current Workers by Activity + * The number of current Workers by Activity. */ activityStatistics: Array; /** - * The age of the longest waiting Task + * The age of the longest waiting Task. */ longestTaskWaitingAge: number; /** - * The SID of the longest waiting Task + * The SID of the longest waiting Task. */ longestTaskWaitingSid: string; /** - * The number of Tasks by priority + * The number of Tasks by priority. For example: `{\"0\": \"10\", \"99\": \"5\"}` shows 10 Tasks at priority 0 and 5 at priority 99. */ tasksByPriority: any; /** - * The number of Tasks by their current status + * The number of Tasks by their current status. For example: `{\"pending\": \"1\", \"reserved\": \"3\", \"assigned\": \"2\", \"completed\": \"5\"}`. */ tasksByStatus: any; /** - * The total number of Tasks + * The total number of Tasks. */ totalTasks: number; /** - * The total number of Workers in the Workspace + * The total number of Workers in the Workspace. */ totalWorkers: number; /** - * The SID of the Workspace + * The SID of the Workspace. */ workspaceSid: string; /** - * The absolute URL of the Workspace statistics resource + * The absolute URL of the Workspace statistics resource. */ url: string; diff --git a/lib/rest/taskrouter/v1/workspace/workspaceStatistics.ts b/lib/rest/taskrouter/v1/workspace/workspaceStatistics.ts index 5f6a63e8e6..4f294ce5fe 100644 --- a/lib/rest/taskrouter/v1/workspace/workspaceStatistics.ts +++ b/lib/rest/taskrouter/v1/workspace/workspaceStatistics.ts @@ -179,23 +179,23 @@ export class WorkspaceStatisticsInstance { } /** - * n object that contains the real-time statistics for the Workspace + * An object that contains the real-time statistics for the Workspace. */ realtime: any; /** - * An object that contains the cumulative statistics for the Workspace + * An object that contains the cumulative statistics for the Workspace. */ cumulative: any; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Workspace resource. */ accountSid: string; /** - * The SID of the Workspace + * The SID of the Workspace. */ workspaceSid: string; /** - * The absolute URL of the Workspace statistics resource + * The absolute URL of the Workspace statistics resource. */ url: string; diff --git a/lib/rest/trunking/v1/trunk.ts b/lib/rest/trunking/v1/trunk.ts index 851d882053..839d49c3c2 100644 --- a/lib/rest/trunking/v1/trunk.ts +++ b/lib/rest/trunking/v1/trunk.ts @@ -393,65 +393,65 @@ export class TrunkInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Trunk resource. */ accountSid: string; /** - * The unique address you reserve on Twilio to which you route your SIP traffic + * The unique address you reserve on Twilio to which you route your SIP traffic. Domain names can contain letters, digits, and `-` and must end with `pstn.twilio.com`. See [Termination Settings](https://www.twilio.com/docs/sip-trunking#termination) for more information. */ domainName: string; /** - * The HTTP method we use to call the disaster_recovery_url + * The HTTP method we use to call the `disaster_recovery_url`. Can be: `GET` or `POST`. */ disasterRecoveryMethod: TrunkDisasterRecoveryMethod; /** - * The HTTP URL that we call if an error occurs while sending SIP traffic towards your configured Origination URL + * The URL we call using the `disaster_recovery_method` if an error occurs while sending SIP traffic towards the configured Origination URL. We retrieve TwiML from this URL and execute the instructions like any other normal TwiML call. See [Disaster Recovery](https://www.twilio.com/docs/sip-trunking#disaster-recovery) for more information. */ disasterRecoveryUrl: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * Whether Secure Trunking is enabled for the trunk + * Whether Secure Trunking is enabled for the trunk. If enabled, all calls going through the trunk will be secure using SRTP for media and TLS for signaling. If disabled, then RTP will be used for media. See [Secure Trunking](https://www.twilio.com/docs/sip-trunking#securetrunking) for more information. */ secure: boolean; /** - * The recording settings for the trunk + * The recording settings for the trunk. Can be: `do-not-record`, `record-from-ringing`, `record-from-answer`. If set to `record-from-ringing` or `record-from-answer`, all calls going through the trunk will be recorded. The only way to change recording parameters is on a sub-resource of a Trunk after it has been created. e.g.`/Trunks/[Trunk_SID]/Recording -XPOST -d\'Mode=record-from-answer\'`. See [Recording](https://www.twilio.com/docs/sip-trunking#recording) for more information. */ recording: any; transferMode: TrunkTransferSetting; transferCallerId: TrunkTransferCallerId; /** - * Whether Caller ID Name (CNAM) lookup is enabled for the trunk + * Whether Caller ID Name (CNAM) lookup is enabled for the trunk. If enabled, all inbound calls to the SIP Trunk from the United States and Canada automatically perform a CNAM Lookup and display Caller ID data on your phone. See [CNAM Lookups](https://www.twilio.com/docs/sip-trunking#CNAM) for more information. */ cnamLookupEnabled: boolean; /** - * The types of authentication mapped to the domain + * The types of authentication mapped to the domain. Can be: `IP_ACL` and `CREDENTIAL_LIST`. If both are mapped, the values are returned in a comma delimited list. If empty, the domain will not receive any traffic. */ authType: string; /** - * Reserved + * Reserved. */ authTypeSet: Array; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Trunk resource. */ sid: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/trunking/v1/trunk/credentialList.ts b/lib/rest/trunking/v1/trunk/credentialList.ts index 8c1a35b0b9..57f1bd7604 100644 --- a/lib/rest/trunking/v1/trunk/credentialList.ts +++ b/lib/rest/trunking/v1/trunk/credentialList.ts @@ -212,31 +212,31 @@ export class CredentialListInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the CredentialList resource. */ accountSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the CredentialList resource. */ sid: string; /** - * The SID of the Trunk the credential list in associated with + * The SID of the Trunk the credential list in associated with. */ trunkSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/trunking/v1/trunk/ipAccessControlList.ts b/lib/rest/trunking/v1/trunk/ipAccessControlList.ts index e2575d002a..708c8a2dbe 100644 --- a/lib/rest/trunking/v1/trunk/ipAccessControlList.ts +++ b/lib/rest/trunking/v1/trunk/ipAccessControlList.ts @@ -214,31 +214,31 @@ export class IpAccessControlListInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the IpAccessControlList resource. */ accountSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the IpAccessControlList resource. */ sid: string; /** - * The SID of the Trunk the resource is associated with + * The SID of the Trunk the resource is associated with. */ trunkSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/trunking/v1/trunk/originationUrl.ts b/lib/rest/trunking/v1/trunk/originationUrl.ts index 6ecc8ef4bc..0e71891836 100644 --- a/lib/rest/trunking/v1/trunk/originationUrl.ts +++ b/lib/rest/trunking/v1/trunk/originationUrl.ts @@ -319,47 +319,47 @@ export class OriginationUrlInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the OriginationUrl resource. */ accountSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the OriginationUrl resource. */ sid: string; /** - * The SID of the Trunk that owns the Origination URL + * The SID of the Trunk that owns the Origination URL. */ trunkSid: string; /** - * The value that determines the relative load the URI should receive compared to others with the same priority + * The value that determines the relative share of the load the URI should receive compared to other URIs with the same priority. Can be an integer from 1 to 65535, inclusive, and the default is 10. URLs with higher values receive more load than those with lower ones with the same priority. */ weight: number; /** - * Whether the URL is enabled + * Whether the URL is enabled. The default is `true`. */ enabled: boolean; /** - * The SIP address you want Twilio to route your Origination calls to + * The SIP address you want Twilio to route your Origination calls to. This must be a `sip:` schema. */ sipUrl: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The relative importance of the URI + * The relative importance of the URI. Can be an integer from 0 to 65535, inclusive, and the default is 10. The lowest number represents the most important URI. */ priority: number; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/trunking/v1/trunk/phoneNumber.ts b/lib/rest/trunking/v1/trunk/phoneNumber.ts index b5335caf8a..58dcace244 100644 --- a/lib/rest/trunking/v1/trunk/phoneNumber.ts +++ b/lib/rest/trunking/v1/trunk/phoneNumber.ts @@ -285,104 +285,104 @@ export class PhoneNumberInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the PhoneNumber resource. */ accountSid: string; addressRequirements: PhoneNumberAddressRequirement; /** - * The API version used to start a new TwiML session + * The API version used to start a new TwiML session. */ apiVersion: string; /** - * Whether the phone number is new to the Twilio platform + * Whether the phone number is new to the Twilio platform. Can be: `true` or `false`. */ beta: boolean; /** - * Indicate if a phone can receive calls or messages + * The set of Boolean properties that indicate whether a phone number can receive calls or messages. Capabilities are `Voice`, `SMS`, and `MMS` and each capability can be: `true` or `false`. */ capabilities: Record; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; /** - * The phone number in E.164 format + * The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number. */ phoneNumber: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the PhoneNumber resource. */ sid: string; /** - * The SID of the application that handles SMS messages sent to the phone number + * The SID of the application that handles SMS messages sent to the phone number. If an `sms_application_sid` is present, we ignore all `sms_*_url` values and use those of the application. */ smsApplicationSid: string; /** - * The HTTP method used with sms_fallback_url + * The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`. */ smsFallbackMethod: PhoneNumberSmsFallbackMethod; /** - * The URL that we call when an error occurs while retrieving or executing the TwiML + * The URL that we call using the `sms_fallback_method` when an error occurs while retrieving or executing the TwiML from `sms_url`. */ smsFallbackUrl: string; /** - * The HTTP method to use with sms_url + * The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`. */ smsMethod: PhoneNumberSmsMethod; /** - * The URL we call when the phone number receives an incoming SMS message + * The URL we call using the `sms_method` when the phone number receives an incoming SMS message. */ smsUrl: string; /** - * The URL to send status information to your application + * The URL we call using the `status_callback_method` to send status information to your application. */ statusCallback: string; /** - * The HTTP method we use to call status_callback + * The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`. */ statusCallbackMethod: PhoneNumberStatusCallbackMethod; /** - * The SID of the Trunk that handles calls to the phone number + * The SID of the Trunk that handles calls to the phone number. If a `trunk_sid` is present, we ignore all of the voice URLs and voice applications and use those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa. */ trunkSid: string; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The SID of the application that handles calls to the phone number + * The SID of the application that handles calls to the phone number. If a `voice_application_sid` is present, we ignore all of the voice URLs and use those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa. */ voiceApplicationSid: string; /** - * Whether to lookup the caller\'s name + * Whether we look up the caller\'s caller-ID name from the CNAM database ($0.01 per look up). Can be: `true` or `false`. */ voiceCallerIdLookup: boolean; /** - * The HTTP method that we use to call voice_fallback_url + * The HTTP method that we use to call `voice_fallback_url`. Can be: `GET` or `POST`. */ voiceFallbackMethod: PhoneNumberVoiceFallbackMethod; /** - * The URL we call when an error occurs in TwiML + * The URL that we call using the `voice_fallback_method` when an error occurs retrieving or executing the TwiML requested by `url`. */ voiceFallbackUrl: string; /** - * The HTTP method used with the voice_url + * The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`. */ voiceMethod: PhoneNumberVoiceMethod; /** - * The URL we call when the phone number receives a call + * The URL we call using the `voice_method` when the phone number receives a call. The `voice_url` is not be used if a `voice_application_sid` or a `trunk_sid` is set. */ voiceUrl: string; diff --git a/lib/rest/trusthub/v1/customerProfiles.ts b/lib/rest/trusthub/v1/customerProfiles.ts index 1d90828380..6036ba031e 100644 --- a/lib/rest/trusthub/v1/customerProfiles.ts +++ b/lib/rest/trusthub/v1/customerProfiles.ts @@ -374,28 +374,28 @@ export class CustomerProfilesInstance { } /** - * The unique string that identifies the resource. + * The unique string that we created to identify the Customer-Profile resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Customer-Profile resource. */ accountSid: string; /** - * The unique string of a policy. + * The unique string of a policy that is associated to the Customer-Profile resource. */ policySid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; status: CustomerProfileStatus; /** - * The ISO 8601 date and time in GMT when the resource will be valid until. + * The date and time in GMT in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format when the resource will be valid until. */ validUntil: Date; /** - * The email address + * The email address that will receive updates when the Customer-Profile resource changes status. */ email: string; /** @@ -403,19 +403,19 @@ export class CustomerProfilesInstance { */ statusCallback: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Customer-Profile resource + * The absolute URL of the Customer-Profile resource. */ url: string; /** - * The URLs of the Assigned Items of the Customer-Profile resource + * The URLs of the Assigned Items of the Customer-Profile resource. */ links: Record; diff --git a/lib/rest/trusthub/v1/customerProfiles/customerProfilesChannelEndpointAssignment.ts b/lib/rest/trusthub/v1/customerProfiles/customerProfilesChannelEndpointAssignment.ts index 18ac236a64..febbcb3fd4 100644 --- a/lib/rest/trusthub/v1/customerProfiles/customerProfilesChannelEndpointAssignment.ts +++ b/lib/rest/trusthub/v1/customerProfiles/customerProfilesChannelEndpointAssignment.ts @@ -235,31 +235,31 @@ export class CustomerProfilesChannelEndpointAssignmentInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Item Assignment resource. */ sid: string; /** - * The unique string that identifies the CustomerProfile resource. + * The unique string that we created to identify the CustomerProfile resource. */ customerProfileSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Item Assignment resource. */ accountSid: string; /** - * The type of channel endpoint + * The type of channel endpoint. eg: phone-number */ channelEndpointType: string; /** - * The sid of an channel endpoint + * The SID of an channel endpoint */ channelEndpointSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The absolute URL of the Identity resource + * The absolute URL of the Identity resource. */ url: string; diff --git a/lib/rest/trusthub/v1/customerProfiles/customerProfilesEntityAssignments.ts b/lib/rest/trusthub/v1/customerProfiles/customerProfilesEntityAssignments.ts index 3891c07720..22663eeed0 100644 --- a/lib/rest/trusthub/v1/customerProfiles/customerProfilesEntityAssignments.ts +++ b/lib/rest/trusthub/v1/customerProfiles/customerProfilesEntityAssignments.ts @@ -219,27 +219,27 @@ export class CustomerProfilesEntityAssignmentsInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Item Assignment resource. */ sid: string; /** - * The unique string that identifies the CustomerProfile resource. + * The unique string that we created to identify the CustomerProfile resource. */ customerProfileSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Item Assignment resource. */ accountSid: string; /** - * The sid of an object bag + * The SID of an object bag that holds information of the different items. */ objectSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The absolute URL of the Identity resource + * The absolute URL of the Identity resource. */ url: string; diff --git a/lib/rest/trusthub/v1/customerProfiles/customerProfilesEvaluations.ts b/lib/rest/trusthub/v1/customerProfiles/customerProfilesEvaluations.ts index 0a6e59f2dd..2e59613451 100644 --- a/lib/rest/trusthub/v1/customerProfiles/customerProfilesEvaluations.ts +++ b/lib/rest/trusthub/v1/customerProfiles/customerProfilesEvaluations.ts @@ -196,24 +196,24 @@ export class CustomerProfilesEvaluationsInstance { } /** - * The unique string that identifies the Evaluation resource + * The unique string that identifies the Evaluation resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the customer_profile resource. */ accountSid: string; /** - * The unique string of a policy + * The unique string of a policy that is associated to the customer_profile resource. */ policySid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the customer_profile resource. */ customerProfileSid: string; status: CustomerProfileEvaluationStatus; /** - * The results of the Evaluation resource + * The results of the Evaluation which includes the valid and invalid attributes. */ results: Array; dateCreated: Date; diff --git a/lib/rest/trusthub/v1/endUser.ts b/lib/rest/trusthub/v1/endUser.ts index d7d7cae4ca..fcd67edb6a 100644 --- a/lib/rest/trusthub/v1/endUser.ts +++ b/lib/rest/trusthub/v1/endUser.ts @@ -277,35 +277,35 @@ export class EndUserInstance { } /** - * The unique string that identifies the resource + * The unique string created by Twilio to identify the End User resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the End User resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The type of end user of the Bundle resource + * The type of end user of the Bundle resource - can be `individual` or `business`. */ type: string; /** - * The set of parameters that compose the End Users resource + * The set of parameters that are the attributes of the End Users resource which are listed in the End User Types. */ attributes: any; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the End User resource + * The absolute URL of the End User resource. */ url: string; diff --git a/lib/rest/trusthub/v1/endUserType.ts b/lib/rest/trusthub/v1/endUserType.ts index 66a27c2d01..22242de166 100644 --- a/lib/rest/trusthub/v1/endUserType.ts +++ b/lib/rest/trusthub/v1/endUserType.ts @@ -163,23 +163,23 @@ export class EndUserTypeInstance { } /** - * The unique string that identifies the End-User Type resource + * The unique string that identifies the End-User Type resource. */ sid: string; /** - * A human-readable description of the End-User Type resource + * A human-readable description that is assigned to describe the End-User Type resource. Examples can include first name, last name, email, business name, etc */ friendlyName: string; /** - * A machine-readable description of the End-User Type resource + * A machine-readable description of the End-User Type resource. Examples can include first_name, last_name, email, business_name, etc. */ machineName: string; /** - * The required information for creating an End-User. + * The required information for creating an End-User. The required fields will change as regulatory needs change and will differ for businesses and individuals. */ fields: Array; /** - * The absolute URL of the End-User Type resource + * The absolute URL of the End-User Type resource. */ url: string; diff --git a/lib/rest/trusthub/v1/policies.ts b/lib/rest/trusthub/v1/policies.ts index 74d152204a..3b629fa240 100644 --- a/lib/rest/trusthub/v1/policies.ts +++ b/lib/rest/trusthub/v1/policies.ts @@ -153,19 +153,19 @@ export class PoliciesInstance { } /** - * The unique string that identifies the Policy resource + * The unique string that identifies the Policy resource. */ sid: string; /** - * A human-readable description of the Policy resource + * A human-readable description that is assigned to describe the Policy resource. Examples can include Primary Customer profile policy */ friendlyName: string; /** - * The sid of a Policy object that dictates requirements + * The SID of an object that holds the policy information */ requirements: any; /** - * The absolute URL of the Policy resource + * The absolute URL of the Policy resource. */ url: string; diff --git a/lib/rest/trusthub/v1/supportingDocument.ts b/lib/rest/trusthub/v1/supportingDocument.ts index b0937c88be..23904846b0 100644 --- a/lib/rest/trusthub/v1/supportingDocument.ts +++ b/lib/rest/trusthub/v1/supportingDocument.ts @@ -306,40 +306,40 @@ export class SupportingDocumentInstance { } /** - * The unique string that identifies the resource + * The unique string created by Twilio to identify the Supporting Document resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Document resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The image type of the file + * The image type uploaded in the Supporting Document container. */ mimeType: string; status: SupportingDocumentStatus; /** - * The type of the Supporting Document + * The type of the Supporting Document. */ type: string; /** - * The set of parameters that compose the Supporting Documents resource + * The set of parameters that are the attributes of the Supporting Documents resource which are listed in the Supporting Document Types. */ attributes: any; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Supporting Document resource + * The absolute URL of the Supporting Document resource. */ url: string; diff --git a/lib/rest/trusthub/v1/supportingDocumentType.ts b/lib/rest/trusthub/v1/supportingDocumentType.ts index a80754de98..f6273a12ce 100644 --- a/lib/rest/trusthub/v1/supportingDocumentType.ts +++ b/lib/rest/trusthub/v1/supportingDocumentType.ts @@ -174,23 +174,23 @@ export class SupportingDocumentTypeInstance { } /** - * The unique string that identifies the Supporting Document Type resource + * The unique string that identifies the Supporting Document Type resource. */ sid: string; /** - * A human-readable description of the Supporting Document Type resource + * A human-readable description of the Supporting Document Type resource. */ friendlyName: string; /** - * The machine-readable description of the Supporting Document Type resource + * The machine-readable description of the Supporting Document Type resource. */ machineName: string; /** - * The required information for creating a Supporting Document + * The required information for creating a Supporting Document. The required fields will change as regulatory needs change and will differ for businesses and individuals. */ fields: Array; /** - * The absolute URL of the Supporting Document Type resource + * The absolute URL of the Supporting Document Type resource. */ url: string; diff --git a/lib/rest/trusthub/v1/trustProducts.ts b/lib/rest/trusthub/v1/trustProducts.ts index ff32b6aac9..55767019d3 100644 --- a/lib/rest/trusthub/v1/trustProducts.ts +++ b/lib/rest/trusthub/v1/trustProducts.ts @@ -368,28 +368,28 @@ export class TrustProductsInstance { } /** - * The unique string that identifies the resource. + * The unique string that we created to identify the Customer-Profile resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Customer-Profile resource. */ accountSid: string; /** - * The unique string of a policy. + * The unique string of a policy that is associated to the Customer-Profile resource. */ policySid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; status: TrustProductStatus; /** - * The ISO 8601 date and time in GMT when the resource will be valid until. + * The date and time in GMT in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format when the resource will be valid until. */ validUntil: Date; /** - * The email address + * The email address that will receive updates when the Customer-Profile resource changes status. */ email: string; /** @@ -397,19 +397,19 @@ export class TrustProductsInstance { */ statusCallback: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Customer-Profile resource + * The absolute URL of the Customer-Profile resource. */ url: string; /** - * The URLs of the Assigned Items of the Customer-Profile resource + * The URLs of the Assigned Items of the Customer-Profile resource. */ links: Record; diff --git a/lib/rest/trusthub/v1/trustProducts/trustProductsChannelEndpointAssignment.ts b/lib/rest/trusthub/v1/trustProducts/trustProductsChannelEndpointAssignment.ts index 049288830e..62e042c16f 100644 --- a/lib/rest/trusthub/v1/trustProducts/trustProductsChannelEndpointAssignment.ts +++ b/lib/rest/trusthub/v1/trustProducts/trustProductsChannelEndpointAssignment.ts @@ -235,31 +235,31 @@ export class TrustProductsChannelEndpointAssignmentInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Item Assignment resource. */ sid: string; /** - * The unique string that identifies the CustomerProfile resource. + * The unique string that we created to identify the CustomerProfile resource. */ trustProductSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Item Assignment resource. */ accountSid: string; /** - * The type of channel endpoint + * The type of channel endpoint. eg: phone-number */ channelEndpointType: string; /** - * The sid of an channel endpoint + * The SID of an channel endpoint */ channelEndpointSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The absolute URL of the Identity resource + * The absolute URL of the Identity resource. */ url: string; diff --git a/lib/rest/trusthub/v1/trustProducts/trustProductsEntityAssignments.ts b/lib/rest/trusthub/v1/trustProducts/trustProductsEntityAssignments.ts index 9776edcb77..ae6860fc92 100644 --- a/lib/rest/trusthub/v1/trustProducts/trustProductsEntityAssignments.ts +++ b/lib/rest/trusthub/v1/trustProducts/trustProductsEntityAssignments.ts @@ -218,27 +218,27 @@ export class TrustProductsEntityAssignmentsInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Item Assignment resource. */ sid: string; /** - * The unique string that identifies the TrustProduct resource. + * The unique string that we created to identify the TrustProduct resource. */ trustProductSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Item Assignment resource. */ accountSid: string; /** - * The sid of an object bag + * The SID of an object bag that holds information of the different items. */ objectSid: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The absolute URL of the Identity resource + * The absolute URL of the Identity resource. */ url: string; diff --git a/lib/rest/trusthub/v1/trustProducts/trustProductsEvaluations.ts b/lib/rest/trusthub/v1/trustProducts/trustProductsEvaluations.ts index 0f8dc88de7..d05f8ea99b 100644 --- a/lib/rest/trusthub/v1/trustProducts/trustProductsEvaluations.ts +++ b/lib/rest/trusthub/v1/trustProducts/trustProductsEvaluations.ts @@ -196,24 +196,24 @@ export class TrustProductsEvaluationsInstance { } /** - * The unique string that identifies the Evaluation resource + * The unique string that identifies the Evaluation resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the trust_product resource. */ accountSid: string; /** - * The unique string of a policy + * The unique string of a policy that is associated to the trust_product resource. */ policySid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the trust_product resource. */ trustProductSid: string; status: TrustProductEvaluationStatus; /** - * The results of the Evaluation resource + * The results of the Evaluation which includes the valid and invalid attributes. */ results: Array; dateCreated: Date; diff --git a/lib/rest/verify/v2/form.ts b/lib/rest/verify/v2/form.ts index 48f860b7ed..f194cf7fec 100644 --- a/lib/rest/verify/v2/form.ts +++ b/lib/rest/verify/v2/form.ts @@ -120,11 +120,11 @@ export class FormInstance { formType: FormFormTypes; /** - * Object that contains the available forms for this type. + * Object that contains the available forms for this type. This available forms are given in the standard [JSON Schema](https://json-schema.org/) format */ forms: any; /** - * Additional information for the available forms for this type. + * Additional information for the available forms for this type. E.g. The separator string used for `binding` in a Factor push. */ formMeta: any; /** diff --git a/lib/rest/verify/v2/safelist.ts b/lib/rest/verify/v2/safelist.ts index 317ebf73c0..92cd8ac997 100644 --- a/lib/rest/verify/v2/safelist.ts +++ b/lib/rest/verify/v2/safelist.ts @@ -155,7 +155,7 @@ export class SafelistInstance { } /** - * The unique string that identifies the resource. + * The unique string that we created to identify the SafeList resource. */ sid: string; /** diff --git a/lib/rest/verify/v2/service.ts b/lib/rest/verify/v2/service.ts index d7758579d6..75cc5f41c9 100644 --- a/lib/rest/verify/v2/service.ts +++ b/lib/rest/verify/v2/service.ts @@ -456,72 +456,72 @@ export class ServiceInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Service resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource. */ accountSid: string; /** - * The string that you assigned to describe the verification service + * The string that you assigned to describe the verification service. **This value should not contain PII.** */ friendlyName: string; /** - * The length of the verification code + * The length of the verification code to generate. */ codeLength: number; /** - * Whether to perform a lookup with each verification + * Whether to perform a lookup with each verification started and return info about the phone number. */ lookupEnabled: boolean; /** - * Whether to pass PSD2 transaction parameters when starting a verification + * Whether to pass PSD2 transaction parameters when starting a verification. */ psd2Enabled: boolean; /** - * Whether to skip sending SMS verifications to landlines + * Whether to skip sending SMS verifications to landlines. Requires `lookup_enabled`. */ skipSmsToLandlines: boolean; /** - * Whether to ask the user to press a number before delivering the verify code in a phone call + * Whether to ask the user to press a number before delivering the verify code in a phone call. */ dtmfInputRequired: boolean; /** - * The name of an alternative text-to-speech service to use in phone calls + * The name of an alternative text-to-speech service to use in phone calls. Applies only to TTS languages. */ ttsName: string; /** - * Whether to add a security warning at the end of an SMS. + * Whether to add a security warning at the end of an SMS verification body. Disabled by default and applies only to SMS. Example SMS body: `Your AppName verification code is: 1234. Don’t share this code with anyone; our employees will never ask for the code` */ doNotShareWarningEnabled: boolean; /** - * Whether to allow sending verifications with a custom code. + * Whether to allow sending verifications with a custom code instead of a randomly generated one. Not available for all customers. */ customCodeEnabled: boolean; /** - * The service level configuration of factor push type. + * Configurations for the Push factors (channel) created under this Service. */ push: any; /** - * The service level configuration of factor TOTP type. + * Configurations for the TOTP factors (channel) created under this Service. */ totp: any; defaultTemplateSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/verify/v2/service/accessToken.ts b/lib/rest/verify/v2/service/accessToken.ts index 16fd7cc3ef..d1431d8a12 100644 --- a/lib/rest/verify/v2/service/accessToken.ts +++ b/lib/rest/verify/v2/service/accessToken.ts @@ -156,28 +156,28 @@ export class AccessTokenInstance { } /** - * A string that uniquely identifies this Access Token. + * A 34 character string that uniquely identifies this Access Token. */ sid: string; /** - * Account Sid. + * The unique SID identifier of the Account. */ accountSid: string; /** - * Verify Service Sid. + * The unique SID identifier of the Verify Service. */ serviceSid: string; /** - * Unique external identifier of the Entity + * The unique external identifier for the Entity of the Service. */ entityIdentity: string; factorType: AccessTokenFactorTypes; /** - * A human readable description of this factor. + * A human readable description of this factor, up to 64 characters. For a push factor, this can be the device\'s name. */ factorFriendlyName: string; /** - * Generated access token. + * The access token generated for enrollment, this is an encrypted json web token. */ token: string; /** @@ -185,11 +185,11 @@ export class AccessTokenInstance { */ url: string; /** - * How long, in seconds, the access token is valid. + * How long, in seconds, the access token is valid. Max: 5 minutes */ ttl: number; /** - * The date this access token was created + * The date that this access token was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; diff --git a/lib/rest/verify/v2/service/entity.ts b/lib/rest/verify/v2/service/entity.ts index 04146ed1dd..680144b757 100644 --- a/lib/rest/verify/v2/service/entity.ts +++ b/lib/rest/verify/v2/service/entity.ts @@ -255,27 +255,27 @@ export class EntityInstance { } /** - * A string that uniquely identifies this Entity. + * A 34 character string that uniquely identifies this Entity. */ sid: string; /** - * Unique external identifier of the Entity + * The unique external identifier for the Entity of the Service. This identifier should be immutable, not PII, length between 8 and 64 characters, and generated by your external system, such as your user\'s UUID, GUID, or SID. It can only contain dash (-) separated alphanumeric characters. */ identity: string; /** - * Account Sid. + * The unique SID identifier of the Account. */ accountSid: string; /** - * Service Sid. + * The unique SID identifier of the Service. */ serviceSid: string; /** - * The date this Entity was created + * The date that this Entity was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The date this Entity was updated + * The date that this Entity was updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** @@ -283,7 +283,7 @@ export class EntityInstance { */ url: string; /** - * Nested resource URLs. + * Contains a dictionary of URL links to nested resources of this Entity. */ links: Record; diff --git a/lib/rest/verify/v2/service/entity/challenge.ts b/lib/rest/verify/v2/service/entity/challenge.ts index ffb25006e8..a17f7af9ab 100644 --- a/lib/rest/verify/v2/service/entity/challenge.ts +++ b/lib/rest/verify/v2/service/entity/challenge.ts @@ -351,57 +351,57 @@ export class ChallengeInstance { } /** - * A string that uniquely identifies this Challenge. + * A 34 character string that uniquely identifies this Challenge. */ sid: string; /** - * Account Sid. + * The unique SID identifier of the Account. */ accountSid: string; /** - * Service Sid. + * The unique SID identifier of the Service. */ serviceSid: string; /** - * Entity Sid. + * The unique SID identifier of the Entity. */ entitySid: string; /** - * Unique external identifier of the Entity + * Customer unique identity for the Entity owner of the Challenge. This identifier should be immutable, not PII, length between 8 and 64 characters, and generated by your external system, such as your user\'s UUID, GUID, or SID. It can only contain dash (-) separated alphanumeric characters. */ identity: string; /** - * Factor Sid. + * The unique SID identifier of the Factor. */ factorSid: string; /** - * The date this Challenge was created + * The date that this Challenge was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The date this Challenge was updated + * The date that this Challenge was updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The date this Challenge was responded + * The date that this Challenge was responded, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateResponded: Date; /** - * The date-time when this Challenge expires + * The date-time when this Challenge expires, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. The default value is five (5) minutes after Challenge creation. The max value is sixty (60) minutes after creation. */ expirationDate: Date; status: ChallengeChallengeStatuses; respondedReason: ChallengeChallengeReasons; /** - * Details about the Challenge. + * Details provided to give context about the Challenge. Intended to be shown to the end user. */ details: any; /** - * Hidden details about the Challenge + * Details provided to give context about the Challenge. Intended to be hidden from the end user. It must be a stringified JSON with only strings values eg. `{\"ip\": \"172.168.1.234\"}` */ hiddenDetails: any; /** - * Metadata of the challenge. + * Custom metadata associated with the challenge. This is added by the Device/SDK directly to allow for the inclusion of device information. It must be a stringified JSON with only strings values eg. `{\"os\": \"Android\"}`. Can be up to 1024 characters in length. */ metadata: any; factorType: ChallengeFactorTypes; @@ -410,7 +410,7 @@ export class ChallengeInstance { */ url: string; /** - * Nested resource URLs. + * Contains a dictionary of URL links to nested resources of this Challenge. */ links: Record; diff --git a/lib/rest/verify/v2/service/entity/challenge/notification.ts b/lib/rest/verify/v2/service/entity/challenge/notification.ts index 573eccabff..ec6a8534a4 100644 --- a/lib/rest/verify/v2/service/entity/challenge/notification.ts +++ b/lib/rest/verify/v2/service/entity/challenge/notification.ts @@ -185,39 +185,39 @@ export class NotificationInstance { } /** - * A string that uniquely identifies this Notification. + * A 34 character string that uniquely identifies this Notification. */ sid: string; /** - * Account Sid. + * The unique SID identifier of the Account. */ accountSid: string; /** - * Service Sid. + * The unique SID identifier of the Service. */ serviceSid: string; /** - * Entity Sid. + * The unique SID identifier of the Entity. */ entitySid: string; /** - * Unique external identifier of the Entity + * Customer unique identity for the Entity owner of the Challenge. This identifier should be immutable, not PII, length between 8 and 64 characters, and generated by your external system, such as your user\'s UUID, GUID, or SID. It can only contain dash (-) separated alphanumeric characters. */ identity: string; /** - * Challenge Sid. + * The unique SID identifier of the Challenge. */ challengeSid: string; /** - * The priority of the notification. + * The priority of the notification. For `push` Challenges it\'s always `high` which sends the notification immediately, and can wake up a sleeping device. */ priority: string; /** - * How long, in seconds, the notification is valid. + * How long, in seconds, the notification is valid. Max: 5 minutes */ ttl: number; /** - * The date this Notification was created + * The date that this Notification was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; diff --git a/lib/rest/verify/v2/service/entity/factor.ts b/lib/rest/verify/v2/service/entity/factor.ts index 39a15c37e0..a98bb73667 100644 --- a/lib/rest/verify/v2/service/entity/factor.ts +++ b/lib/rest/verify/v2/service/entity/factor.ts @@ -343,45 +343,45 @@ export class FactorInstance { } /** - * A string that uniquely identifies this Factor. + * A 34 character string that uniquely identifies this Factor. */ sid: string; /** - * Account Sid. + * The unique SID identifier of the Account. */ accountSid: string; /** - * Service Sid. + * The unique SID identifier of the Service. */ serviceSid: string; /** - * Entity Sid. + * The unique SID identifier of the Entity. */ entitySid: string; /** - * Unique external identifier of the Entity + * Customer unique identity for the Entity owner of the Factor. This identifier should be immutable, not PII, length between 8 and 64 characters, and generated by your external system, such as your user\'s UUID, GUID, or SID. It can only contain dash (-) separated alphanumeric characters. */ identity: string; /** - * The date this Factor was created + * The date that this Factor was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The date this Factor was updated + * The date that this Factor was updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * A human readable description of this resource. + * A human readable description of this resource, up to 64 characters. For a push factor, this can be the device\'s name. */ friendlyName: string; status: FactorFactorStatuses; factorType: FactorFactorTypes; /** - * Configurations for a `factor_type`. + * An object that contains configurations specific to a `factor_type`. */ config: any; /** - * Metadata of the factor. + * Custom metadata associated with the factor. This is added by the Device/SDK directly to allow for the inclusion of device information. It must be a stringified JSON with only strings values eg. `{\"os\": \"Android\"}`. Can be up to 1024 characters in length. */ metadata: any; /** diff --git a/lib/rest/verify/v2/service/entity/newFactor.ts b/lib/rest/verify/v2/service/entity/newFactor.ts index 275835d83f..80c99d7584 100644 --- a/lib/rest/verify/v2/service/entity/newFactor.ts +++ b/lib/rest/verify/v2/service/entity/newFactor.ts @@ -244,49 +244,49 @@ export class NewFactorInstance { } /** - * A string that uniquely identifies this Factor. + * A 34 character string that uniquely identifies this Factor. */ sid: string; /** - * Account Sid. + * The unique SID identifier of the Account. */ accountSid: string; /** - * Service Sid. + * The unique SID identifier of the Service. */ serviceSid: string; /** - * Entity Sid. + * The unique SID identifier of the Entity. */ entitySid: string; /** - * Unique external identifier of the Entity + * Customer unique identity for the Entity owner of the Factor. This identifier should be immutable, not PII, length between 8 and 64 characters, and generated by your external system, such as your user\'s UUID, GUID, or SID. It can only contain dash (-) separated alphanumeric characters. */ identity: string; /** - * Binding of the factor + * Contains the `factor_type` specific secret and metadata. For push, this is `binding.public_key` and `binding.alg`. For totp, this is `binding.secret` and `binding.uri`. The `binding.uri` property is generated following the [google authenticator key URI format](https://github.com/google/google-authenticator/wiki/Key-Uri-Format), and `Factor.friendly_name` is used for the “accountname” value and `Service.friendly_name` or `Service.totp.issuer` is used for the `issuer` value. The Binding property is ONLY returned upon Factor creation. */ binding: any; /** - * The date this Factor was created + * The date that this Factor was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The date this Factor was updated + * The date that this Factor was updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * A human readable description of this resource. + * The friendly name of this Factor. This can be any string up to 64 characters, meant for humans to distinguish between Factors. For `factor_type` `push`, this could be a device name. For `factor_type` `totp`, this value is used as the “account name” in constructing the `binding.uri` property. At the same time, we recommend avoiding providing PII. */ friendlyName: string; status: NewFactorFactorStatuses; factorType: NewFactorFactorTypes; /** - * Configurations for a `factor_type`. + * An object that contains configurations specific to a `factor_type`. */ config: any; /** - * Metadata of the factor. + * Custom metadata associated with the factor. This is added by the Device/SDK directly to allow for the inclusion of device information. It must be a stringified JSON with only strings values eg. `{\"os\": \"Android\"}`. Can be up to 1024 characters in length. */ metadata: any; /** diff --git a/lib/rest/verify/v2/service/messagingConfiguration.ts b/lib/rest/verify/v2/service/messagingConfiguration.ts index 7df58a0da8..98536eb8e5 100644 --- a/lib/rest/verify/v2/service/messagingConfiguration.ts +++ b/lib/rest/verify/v2/service/messagingConfiguration.ts @@ -299,27 +299,27 @@ export class MessagingConfigurationInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource. */ accountSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/verify/api/service) that the resource is associated with. */ serviceSid: string; /** - * The ISO-3166-1 country code of the country or `all`. + * The [ISO-3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the country this configuration will be applied to. If this is a global configuration, Country will take the value `all`. */ country: string; /** - * The SID of the Messaging Service used for this configuration. + * The SID of the [Messaging Service](https://www.twilio.com/docs/sms/services/api) to be used to send SMS to the country of this configuration. */ messagingServiceSid: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** diff --git a/lib/rest/verify/v2/service/rateLimit.ts b/lib/rest/verify/v2/service/rateLimit.ts index 620cfcaead..aabe9f75af 100644 --- a/lib/rest/verify/v2/service/rateLimit.ts +++ b/lib/rest/verify/v2/service/rateLimit.ts @@ -309,19 +309,19 @@ export class RateLimitInstance { } /** - * A string that uniquely identifies this Rate Limit. + * A 34 character string that uniquely identifies this Rate Limit. */ sid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/verify/api/service) the resource is associated with. */ serviceSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Rate Limit resource. */ accountSid: string; /** - * A unique, developer assigned name of this Rate Limit. + * Provides a unique and addressable name to be assigned to this Rate Limit, assigned by the developer, to be optionally used in addition to SID. **This value should not contain PII.** */ uniqueName: string; /** @@ -329,11 +329,11 @@ export class RateLimitInstance { */ description: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** @@ -341,7 +341,7 @@ export class RateLimitInstance { */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/verify/v2/service/rateLimit/bucket.ts b/lib/rest/verify/v2/service/rateLimit/bucket.ts index b986ffd5a4..75c82e9471 100644 --- a/lib/rest/verify/v2/service/rateLimit/bucket.ts +++ b/lib/rest/verify/v2/service/rateLimit/bucket.ts @@ -308,23 +308,23 @@ export class BucketInstance { } /** - * A string that uniquely identifies this Bucket. + * A 34 character string that uniquely identifies this Bucket. */ sid: string; /** - * Rate Limit Sid. + * The Twilio-provided string that uniquely identifies the Rate Limit resource. */ rateLimitSid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/verify/api/service) the resource is associated with. */ serviceSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Rate Limit resource. */ accountSid: string; /** - * Max number of requests. + * Maximum number of requests permitted in during the interval. */ max: number; /** @@ -332,11 +332,11 @@ export class BucketInstance { */ interval: number; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** diff --git a/lib/rest/verify/v2/service/verification.ts b/lib/rest/verify/v2/service/verification.ts index 32d46716f3..a548c2571d 100644 --- a/lib/rest/verify/v2/service/verification.ts +++ b/lib/rest/verify/v2/service/verification.ts @@ -254,60 +254,60 @@ export class VerificationInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Verification resource. */ sid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/verify/api/service) the resource is associated with. */ serviceSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Verification resource. */ accountSid: string; /** - * The phone number or email being verified + * The phone number or [email](https://www.twilio.com/docs/verify/email) being verified. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164). */ to: string; channel: VerificationChannel; /** - * The status of the verification resource + * The status of the verification. One of: `pending`, `approved`, or `canceled` */ status: string; /** - * Whether the verification was successful + * Use \"status\" instead. Legacy property indicating whether the verification was successful. */ valid: boolean; /** - * Information about the phone number being verified + * Information about the phone number being verified. */ lookup: any; /** - * The amount of the associated PSD2 compliant transaction. + * The amount of the associated PSD2 compliant transaction. Requires the PSD2 Service flag enabled. */ amount: string; /** - * The payee of the associated PSD2 compliant transaction + * The payee of the associated PSD2 compliant transaction. Requires the PSD2 Service flag enabled. */ payee: string; /** - * An array of verification attempt objects. + * An array of verification attempt objects containing the channel attempted and the channel-specific transaction SID. */ sendCodeAttempts: Array; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The set of fields used for a silent network auth (`sna`) verification + * The set of fields used for a silent network auth (`sna`) verification. Contains a single field with the URL to be invoked to verify the phone number. */ sna: any; /** - * The absolute URL of the Verification resource + * The absolute URL of the Verification resource. */ url: string; diff --git a/lib/rest/verify/v2/service/verificationCheck.ts b/lib/rest/verify/v2/service/verificationCheck.ts index 6072a5ef25..08c5a1a0c1 100644 --- a/lib/rest/verify/v2/service/verificationCheck.ts +++ b/lib/rest/verify/v2/service/verificationCheck.ts @@ -190,48 +190,48 @@ export class VerificationCheckInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the VerificationCheck resource. */ sid: string; /** - * The SID of the Service that the resource is associated with + * The SID of the [Service](https://www.twilio.com/docs/verify/api/service) the resource is associated with. */ serviceSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the VerificationCheck resource. */ accountSid: string; /** - * The phone number or email being verified + * The phone number or [email](https://www.twilio.com/docs/verify/email) being verified. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164). */ to: string; channel: VerificationCheckChannel; /** - * The status of the verification resource + * The status of the verification. Can be: `pending`, `approved`, or `canceled`. */ status: string; /** - * Whether the verification was successful + * Use \"status\" instead. Legacy property indicating whether the verification was successful. */ valid: boolean; /** - * The amount of the associated PSD2 compliant transaction. + * The amount of the associated PSD2 compliant transaction. Requires the PSD2 Service flag enabled. */ amount: string; /** - * The payee of the associated PSD2 compliant transaction + * The payee of the associated PSD2 compliant transaction. Requires the PSD2 Service flag enabled. */ payee: string; /** - * The ISO 8601 date and time in GMT when the Verification Check resource was created + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the Verification Check resource was created. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the Verification Check resource was last updated + * The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the Verification Check resource was last updated. */ dateUpdated: Date; /** - * List of error codes as a result of attempting a verification using the `sna` channel. + * List of error codes as a result of attempting a verification using the `sna` channel. The error codes are chronologically ordered, from the first attempt to the latest attempt. This will be an empty list if no errors occured or `null` if the last channel used wasn\'t `sna`. */ snaAttemptsErrorCodes: Array; diff --git a/lib/rest/verify/v2/service/webhook.ts b/lib/rest/verify/v2/service/webhook.ts index 7cf01dd97c..93edab3922 100644 --- a/lib/rest/verify/v2/service/webhook.ts +++ b/lib/rest/verify/v2/service/webhook.ts @@ -328,23 +328,23 @@ export class WebhookInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Webhook resource. */ sid: string; /** - * Service Sid. + * The unique SID identifier of the Service. */ serviceSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource. */ accountSid: string; /** - * The string that you assigned to describe the webhook + * The string that you assigned to describe the webhook. **This value should not contain PII.** */ friendlyName: string; /** - * The array of events that this Webhook is subscribed to. + * The array of events that this Webhook is subscribed to. Possible event types: `*, factor.deleted, factor.created, factor.verified, challenge.approved, challenge.denied` */ eventTypes: Array; status: WebhookStatus; @@ -355,15 +355,15 @@ export class WebhookInstance { webhookUrl: string; webhookMethod: WebhookMethods; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The absolute URL of the Webhook resource + * The absolute URL of the Webhook resource. */ url: string; diff --git a/lib/rest/verify/v2/template.ts b/lib/rest/verify/v2/template.ts index d774637b17..6b00b025b5 100644 --- a/lib/rest/verify/v2/template.ts +++ b/lib/rest/verify/v2/template.ts @@ -251,23 +251,23 @@ export class TemplateInstance { } /** - * A string that uniquely identifies this Template + * A 34 character string that uniquely identifies a Verification Template. */ sid: string; /** - * Account Sid + * The unique SID identifier of the Account. */ accountSid: string; /** - * A string to describe the verification template + * A descriptive string that you create to describe a Template. */ friendlyName: string; /** - * A list of channels that support the Template + * A list of channels that support the Template. Can include: sms, voice */ channels: Array; /** - * Object with the template translations. + * An object that contains the different translations of the template. Every translation is identified by the language short name and contains its respective information as the approval status, text and created/modified date. */ translations: any; diff --git a/lib/rest/verify/v2/verificationAttempt.ts b/lib/rest/verify/v2/verificationAttempt.ts index 3922f73eab..cc3c860b42 100644 --- a/lib/rest/verify/v2/verificationAttempt.ts +++ b/lib/rest/verify/v2/verificationAttempt.ts @@ -232,33 +232,33 @@ export class VerificationAttemptInstance { } /** - * The SID that uniquely identifies the verification attempt. + * The SID that uniquely identifies the verification attempt resource. */ sid: string; /** - * The SID of the Account that created the verification. + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Verification resource. */ accountSid: string; /** - * The SID of the verify service that generated this attempt. + * The SID of the [Service](https://www.twilio.com/docs/verify/api/service) used to generate the attempt. */ serviceSid: string; /** - * The SID of the verification that generated this attempt. + * The SID of the [Verification](https://www.twilio.com/docs/verify/api/verification) that generated the attempt. */ verificationSid: string; /** - * The date this Attempt was created + * The date that this Attempt was created, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The date this Attempt was updated + * The date that this Attempt was updated, given in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; conversionStatus: VerificationAttemptConversionStatus; channel: VerificationAttemptChannels; /** - * An object containing the charge for this verification attempt. + * An object containing the charge for this verification attempt related to the channel costs and the currency used. The costs related to the succeeded verifications are not included. May not be immediately available. More information on pricing is available [here](https://www.twilio.com/verify/pricing). */ price: any; /** diff --git a/lib/rest/verify/v2/verificationAttemptsSummary.ts b/lib/rest/verify/v2/verificationAttemptsSummary.ts index 45c56ef5ab..15ac8954ed 100644 --- a/lib/rest/verify/v2/verificationAttemptsSummary.ts +++ b/lib/rest/verify/v2/verificationAttemptsSummary.ts @@ -194,19 +194,19 @@ export class VerificationAttemptsSummaryInstance { } /** - * Total of attempts made. + * Total of attempts made according to the provided filters */ totalAttempts: number; /** - * Total of attempts confirmed by the end user. + * Total of attempts made that were confirmed by the end user, according to the provided filters. */ totalConverted: number; /** - * Total of attempts made that were not confirmed by the end user. + * Total of attempts made that were not confirmed by the end user, according to the provided filters. */ totalUnconverted: number; /** - * Percentage of the confirmed messages over the total. + * Percentage of the confirmed messages over the total, defined by (total_converted/total_attempts)*100. */ conversionRatePercentage: number; url: string; diff --git a/lib/rest/video/v1/composition.ts b/lib/rest/video/v1/composition.ts index e194508831..bc82a1b28a 100644 --- a/lib/rest/video/v1/composition.ts +++ b/lib/rest/video/v1/composition.ts @@ -287,81 +287,81 @@ export class CompositionInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Composition resource. */ accountSid: string; status: CompositionStatus; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * Date when the media processing task finished + * The date and time in GMT when the composition\'s media processing task finished, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCompleted: Date; /** - * The ISO 8601 date and time in GMT when the composition generated media was deleted + * The date and time in GMT when the composition generated media was deleted, specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateDeleted: Date; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Composition resource. */ sid: string; /** - * The SID of the Group Room that generated the audio and video tracks used in the composition + * The SID of the Group Room that generated the audio and video tracks used in the composition. All media sources included in a composition must belong to the same Group Room. */ roomSid: string; /** - * The array of track names to include in the composition + * The array of track names to include in the composition. The composition includes all audio sources specified in `audio_sources` except those specified in `audio_sources_excluded`. The track names in this property can include an asterisk as a wild card character, which matches zero or more characters in a track name. For example, `student*` includes tracks named `student` as well as `studentTeam`. */ audioSources: Array; /** - * The array of track names to exclude from the composition + * The array of track names to exclude from the composition. The composition includes all audio sources specified in `audio_sources` except for those specified in `audio_sources_excluded`. The track names in this property can include an asterisk as a wild card character, which matches zero or more characters in a track name. For example, `student*` excludes `student` as well as `studentTeam`. This parameter can also be empty. */ audioSourcesExcluded: Array; /** - * An object that describes the video layout of the composition + * An object that describes the video layout of the composition in terms of regions. See [Specifying Video Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info. */ videoLayout: any; /** - * The dimensions of the video image in pixels expressed as columns (width) and rows (height) + * The dimensions of the video image in pixels expressed as columns (width) and rows (height). The string\'s format is `{width}x{height}`, such as `640x480`. */ resolution: string; /** - * Whether to remove intervals with no media + * Whether to remove intervals with no media, as specified in the POST request that created the composition. Compositions with `trim` enabled are shorter when the Room is created and no Participant joins for a while as well as if all the Participants leave the room and join later, because those gaps will be removed. See [Specifying Video Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info. */ trim: boolean; format: CompositionFormat; /** - * The average bit rate of the composition\'s media + * The average bit rate of the composition\'s media. */ bitrate: number; /** - * The size of the composed media file in bytes + * The size of the composed media file in bytes. */ size: number; /** - * The duration of the composition\'s media file in seconds + * The duration of the composition\'s media file in seconds. */ duration: number; /** - * The URL of the media file associated with the composition when stored externally + * The URL of the media file associated with the composition when stored externally. See [External S3 Compositions](/docs/video/api/external-s3-compositions) for more details. */ mediaExternalLocation: string; /** - * The URL called to send status information on every composition event. + * The URL called using the `status_callback_method` to send status information on every composition event. */ statusCallback: string; /** - * The HTTP method used to call `status_callback` + * The HTTP method used to call `status_callback`. Can be: `POST` or `GET`, defaults to `POST`. */ statusCallbackMethod: CompositionStatusCallbackMethod; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URL of the media file associated with the composition + * The URL of the media file associated with the composition. */ links: Record; diff --git a/lib/rest/video/v1/compositionHook.ts b/lib/rest/video/v1/compositionHook.ts index 90312b3549..992b04887b 100644 --- a/lib/rest/video/v1/compositionHook.ts +++ b/lib/rest/video/v1/compositionHook.ts @@ -382,60 +382,60 @@ export class CompositionHookInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the CompositionHook resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. Can be up to 100 characters long and must be unique within the account. */ friendlyName: string; /** - * Whether the CompositionHook is active + * Whether the CompositionHook is active. When `true`, the CompositionHook is triggered for every completed Group Room on the account. When `false`, the CompositionHook is never triggered. */ enabled: boolean; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The unique string that identifies the resource + * The unique string that we created to identify the CompositionHook resource. */ sid: string; /** - * The array of track names to include in the compositions created by the composition hook + * The array of track names to include in the compositions created by the composition hook. A composition triggered by the composition hook includes all audio sources specified in `audio_sources` except those specified in `audio_sources_excluded`. The track names in this property can include an asterisk as a wild card character, which matches zero or more characters in a track name. For example, `student*` includes tracks named `student` as well as `studentTeam`. Please, be aware that either video_layout or audio_sources have to be provided to get a valid creation request */ audioSources: Array; /** - * The array of track names to exclude from the compositions created by the composition hook + * The array of track names to exclude from the compositions created by the composition hook. A composition triggered by the composition hook includes all audio sources specified in `audio_sources` except for those specified in `audio_sources_excluded`. The track names in this property can include an asterisk as a wild card character, which matches zero or more characters in a track name. For example, `student*` excludes `student` as well as `studentTeam`. This parameter can also be empty. */ audioSourcesExcluded: Array; /** - * A JSON object that describes the video layout of the Composition + * A JSON object that describes the video layout of the composition in terms of regions as specified in the HTTP POST request that created the CompositionHook resource. See [POST Parameters](https://www.twilio.com/docs/video/api/compositions-resource#http-post-parameters) for more information. Please, be aware that either video_layout or audio_sources have to be provided to get a valid creation request */ videoLayout: any; /** - * The dimensions of the video image in pixels expressed as columns (width) and rows (height) + * The dimensions of the video image in pixels expressed as columns (width) and rows (height). The string\'s format is `{width}x{height}`, such as `640x480`. */ resolution: string; /** - * Whether intervals with no media are clipped + * Whether intervals with no media are clipped, as specified in the POST request that created the CompositionHook resource. Compositions with `trim` enabled are shorter when the Room is created and no Participant joins for a while as well as if all the Participants leave the room and join later, because those gaps will be removed. See [Specifying Video Layouts](https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts) for more info. */ trim: boolean; format: CompositionHookFormat; /** - * The URL to send status information to your application + * The URL we call using the `status_callback_method` to send status information to your application. */ statusCallback: string; /** - * The HTTP method we should use to call status_callback + * The HTTP method we should use to call `status_callback`. Can be `POST` or `GET` and defaults to `POST`. */ statusCallbackMethod: CompositionHookStatusCallbackMethod; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/video/v1/compositionSettings.ts b/lib/rest/video/v1/compositionSettings.ts index 13fdb6fd75..891a22630a 100644 --- a/lib/rest/video/v1/compositionSettings.ts +++ b/lib/rest/video/v1/compositionSettings.ts @@ -198,35 +198,35 @@ export class CompositionSettingsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the CompositionSettings resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource and that will be shown in the console */ friendlyName: string; /** - * The SID of the stored Credential resource + * The SID of the stored Credential resource. */ awsCredentialsSid: string; /** - * The URL of the AWS S3 bucket where the compositions are stored + * The URL of the AWS S3 bucket where the compositions are stored. We only support DNS-compliant URLs like `https://documentation-example-twilio-bucket/compositions`, where `compositions` is the path in which you want the compositions to be stored. This URL accepts only URI-valid characters, as described in the RFC 3986. */ awsS3Url: string; /** - * Whether all compositions are written to the aws_s3_url + * Whether all compositions are written to the `aws_s3_url`. When `false`, all compositions are stored in our cloud. */ awsStorageEnabled: boolean; /** - * The SID of the Public Key resource used for encryption + * The SID of the Public Key resource used for encryption. */ encryptionKeySid: string; /** - * Whether all compositions are stored in an encrypted form + * Whether all compositions are stored in an encrypted form. The default is `false`. */ encryptionEnabled: boolean; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/video/v1/recording.ts b/lib/rest/video/v1/recording.ts index bf6248b843..22dc378733 100644 --- a/lib/rest/video/v1/recording.ts +++ b/lib/rest/video/v1/recording.ts @@ -265,63 +265,63 @@ export class RecordingInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Recording resource. */ accountSid: string; status: RecordingStatus; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Recording resource. */ sid: string; /** - * The SID of the recording source + * The SID of the recording source. For a Room Recording, this value is a `track_sid`. */ sourceSid: string; /** - * The size of the recorded track, in bytes + * The size of the recorded track, in bytes. */ size: number; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; type: RecordingType; /** - * The duration of the recording in seconds + * The duration of the recording in seconds rounded to the nearest second. Sub-second tracks have a `Duration` property of 1 second */ duration: number; containerFormat: RecordingFormat; codec: RecordingCodec; /** - * A list of SIDs related to the recording + * A list of SIDs related to the recording. Includes the `room_sid` and `participant_sid`. */ groupingSids: any; /** - * The name that was given to the source track of the recording + * The name that was given to the source track of the recording. If no name is given, the `source_sid` is used. */ trackName: string; /** - * The number of milliseconds between a point in time that is common to all rooms in a group and when the source room of the recording started + * The time in milliseconds elapsed between an arbitrary point in time, common to all group rooms, and the moment when the source room of this track started. This information provides a synchronization mechanism for recordings belonging to the same room. */ offset: number; /** - * The URL of the media file associated with the recording when stored externally + * The URL of the media file associated with the recording when stored externally. See [External S3 Recordings](/docs/video/api/external-s3-recordings) for more details. */ mediaExternalLocation: string; /** - * The URL called to send status information on every recording event. + * The URL called using the `status_callback_method` to send status information on every recording event. */ statusCallback: string; /** - * The HTTP method used to call `status_callback` + * The HTTP method used to call `status_callback`. Can be: `POST` or `GET`, defaults to `POST`. */ statusCallbackMethod: RecordingStatusCallbackMethod; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/video/v1/recordingSettings.ts b/lib/rest/video/v1/recordingSettings.ts index dde063bd94..549e6abd2f 100644 --- a/lib/rest/video/v1/recordingSettings.ts +++ b/lib/rest/video/v1/recordingSettings.ts @@ -196,35 +196,35 @@ export class RecordingSettingsInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the RecordingSettings resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource and show the user in the console */ friendlyName: string; /** - * The SID of the stored Credential resource + * The SID of the stored Credential resource. */ awsCredentialsSid: string; /** - * The URL of the AWS S3 bucket where the recordings are stored + * The URL of the AWS S3 bucket where the recordings are stored. We only support DNS-compliant URLs like `https://documentation-example-twilio-bucket/recordings`, where `recordings` is the path in which you want the recordings to be stored. This URL accepts only URI-valid characters, as described in the RFC 3986. */ awsS3Url: string; /** - * Whether all recordings are written to the aws_s3_url + * Whether all recordings are written to the `aws_s3_url`. When `false`, all recordings are stored in our cloud. */ awsStorageEnabled: boolean; /** - * The SID of the Public Key resource used for encryption + * The SID of the Public Key resource used for encryption. */ encryptionKeySid: string; /** - * Whether all recordings are stored in an encrypted form + * Whether all recordings are stored in an encrypted form. The default is `false`. */ encryptionEnabled: boolean; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/video/v1/room.ts b/lib/rest/video/v1/room.ts index c585267d55..e53774767b 100644 --- a/lib/rest/video/v1/room.ts +++ b/lib/rest/video/v1/room.ts @@ -363,81 +363,81 @@ export class RoomInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Room resource. */ sid: string; status: RoomRoomStatus; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Room resource. */ accountSid: string; /** - * Enable Twilio\'s Network Traversal TURN service + * Deprecated, now always considered to be true. */ enableTurn: boolean; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used as a `room_sid` in place of the resource\'s `sid` in the URL to address the resource, assuming it does not contain any [reserved characters](https://tools.ietf.org/html/rfc3986#section-2.2) that would need to be URL encoded. This value is unique for `in-progress` rooms. SDK clients can use this name to connect to the room. REST API clients can use this name in place of the Room SID to interact with the room as long as the room is `in-progress`. */ uniqueName: string; /** - * The URL to send status information to your application + * The URL we call using the `status_callback_method` to send status information to your application on every room event. See [Status Callbacks](https://www.twilio.com/docs/video/api/status-callbacks) for more info. */ statusCallback: string; /** - * The HTTP method we use to call status_callback + * The HTTP method we use to call `status_callback`. Can be `POST` or `GET` and defaults to `POST`. */ statusCallbackMethod: RoomStatusCallbackMethod; /** - * The UTC end time of the room in UTC ISO 8601 format + * The UTC end time of the room in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format. */ endTime: Date; /** - * The duration of the room in seconds + * The duration of the room in seconds. */ duration: number; type: RoomRoomType; /** - * The maximum number of concurrent Participants allowed in the room + * The maximum number of concurrent Participants allowed in the room. */ maxParticipants: number; /** - * The maximum number of seconds a Participant can be connected to the room + * The maximum number of seconds a Participant can be connected to the room. The maximum possible value is 86400 seconds (24 hours). The default is 14400 seconds (4 hours). */ maxParticipantDuration: number; /** - * The maximum number of published tracks allowed in the room at the same time + * The maximum number of published audio, video, and data tracks all participants combined are allowed to publish in the room at the same time. Check [Programmable Video Limits](https://www.twilio.com/docs/video/programmable-video-limits) for more details. If it is set to 0 it means unconstrained. */ maxConcurrentPublishedTracks: number; /** - * Whether to start recording when Participants connect + * Whether to start recording when Participants connect. ***This feature is not available in `peer-to-peer` rooms.*** */ recordParticipantsOnConnect: boolean; /** - * An array of the video codecs that are supported when publishing a track in the room + * An array of the video codecs that are supported when publishing a track in the room. Can be: `VP8` and `H264`. ***This feature is not available in `peer-to-peer` rooms*** */ videoCodecs: Array; /** - * The region for the media server in Group Rooms + * The region for the media server in Group Rooms. Can be: one of the [available Media Regions](https://www.twilio.com/docs/video/ip-address-whitelisting#media-servers). ***This feature is not available in `peer-to-peer` rooms.*** */ mediaRegion: string; /** - * Indicates whether the room will only contain audio track participants for group rooms. + * When set to true, indicates that the participants in the room will only publish audio. No video tracks will be allowed. Group rooms only. */ audioOnly: boolean; /** - * The time a room will remain active after last participant leaves. + * Specifies how long (in minutes) a room will remain active after last participant leaves. Can be configured when creating a room via REST API. For Ad-Hoc rooms this value cannot be changed. */ emptyRoomTimeout: number; /** - * The time a room will remain active when no one joins. + * Specifies how long (in minutes) a room will remain active if no one joins. Can be configured when creating a room via REST API. For Ad-Hoc rooms this value cannot be changed. */ unusedRoomTimeout: number; /** @@ -445,11 +445,11 @@ export class RoomInstance { */ largeRoom: boolean; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/video/v1/room/participant.ts b/lib/rest/video/v1/room/participant.ts index 9302803da6..2333713948 100644 --- a/lib/rest/video/v1/room/participant.ts +++ b/lib/rest/video/v1/room/participant.ts @@ -344,48 +344,48 @@ export class ParticipantInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the RoomParticipant resource. */ sid: string; /** - * The SID of the participant\'s room + * The SID of the participant\'s room. */ roomSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the RoomParticipant resource. */ accountSid: string; status: RoomParticipantStatus; /** - * The string that identifies the resource\'s User + * The application-defined string that uniquely identifies the resource\'s User within a Room. If a client joins with an existing Identity, the existing client is disconnected. See [access tokens](https://www.twilio.com/docs/video/tutorials/user-identity-access-tokens) and [limits](https://www.twilio.com/docs/video/programmable-video-limits) for more info. */ identity: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The time of participant connected to the room in ISO 8601 format + * The time of participant connected to the room in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format. */ startTime: Date; /** - * The time when the participant disconnected from the room in ISO 8601 format + * The time when the participant disconnected from the room in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format. */ endTime: Date; /** - * Duration of time in seconds the participant was connected + * The duration in seconds that the participant was `connected`. Populated only after the participant is `disconnected`. */ duration: number; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/video/v1/room/participant/anonymize.ts b/lib/rest/video/v1/room/participant/anonymize.ts index 8a8bd5e766..e6e47c8283 100644 --- a/lib/rest/video/v1/room/participant/anonymize.ts +++ b/lib/rest/video/v1/room/participant/anonymize.ts @@ -144,44 +144,44 @@ export class AnonymizeInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the RoomParticipant resource. */ sid: string; /** - * The SID of the participant\'s room + * The SID of the participant\'s room. */ roomSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the RoomParticipant resource. */ accountSid: string; status: RoomParticipantAnonymizeStatus; /** - * The SID of the participant + * The SID of the participant. */ identity: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * The time of participant connected to the room in ISO 8601 format + * The time of participant connected to the room in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format. */ startTime: Date; /** - * The time when the participant disconnected from the room in ISO 8601 format + * The time when the participant disconnected from the room in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format. */ endTime: Date; /** - * Duration of time in seconds the participant was connected + * The duration in seconds that the participant was `connected`. Populated only after the participant is `disconnected`. */ duration: number; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/video/v1/room/participant/publishedTrack.ts b/lib/rest/video/v1/room/participant/publishedTrack.ts index 73fdf687c7..6f8327d8e2 100644 --- a/lib/rest/video/v1/room/participant/publishedTrack.ts +++ b/lib/rest/video/v1/room/participant/publishedTrack.ts @@ -195,36 +195,36 @@ export class PublishedTrackInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the RoomParticipantPublishedTrack resource. */ sid: string; /** - * The SID of the Participant resource with the published track + * The SID of the Participant resource with the published track. */ participantSid: string; /** - * The SID of the Room resource where the track is published + * The SID of the Room resource where the track is published. */ roomSid: string; /** - * The track name + * The track name. Must be no more than 128 characters, and be unique among the participant\'s published tracks. */ name: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * Whether the track is enabled + * Whether the track is enabled. */ enabled: boolean; kind: RoomParticipantPublishedTrackKind; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/video/v1/room/participant/subscribeRules.ts b/lib/rest/video/v1/room/participant/subscribeRules.ts index 77893c3834..8f21cc0dff 100644 --- a/lib/rest/video/v1/room/participant/subscribeRules.ts +++ b/lib/rest/video/v1/room/participant/subscribeRules.ts @@ -216,7 +216,7 @@ export class SubscribeRulesInstance { } /** - * The SID of the Participant resource for the Subscribe Rules + * The SID of the Participant resource for the Subscribe Rules. */ participantSid: string; /** @@ -224,15 +224,15 @@ export class SubscribeRulesInstance { */ roomSid: string; /** - * A collection of Subscribe Rules that describe how to include or exclude matching tracks + * A collection of Subscribe Rules that describe how to include or exclude matching tracks. See the [Specifying Subscribe Rules](https://www.twilio.com/docs/video/api/track-subscriptions#specifying-sr) section for further information. */ rules: Array; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; diff --git a/lib/rest/video/v1/room/participant/subscribedTrack.ts b/lib/rest/video/v1/room/participant/subscribedTrack.ts index 02a3fb1116..02aa43abd2 100644 --- a/lib/rest/video/v1/room/participant/subscribedTrack.ts +++ b/lib/rest/video/v1/room/participant/subscribedTrack.ts @@ -197,40 +197,40 @@ export class SubscribedTrackInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the RoomParticipantSubscribedTrack resource. */ sid: string; /** - * The SID of the participant that subscribes to the track + * The SID of the participant that subscribes to the track. */ participantSid: string; /** - * The SID of the participant that publishes the track + * The SID of the participant that publishes the track. */ publisherSid: string; /** - * The SID of the room where the track is published + * The SID of the room where the track is published. */ roomSid: string; /** - * The track name + * The track name. Must have no more than 128 characters and be unique among the participant\'s published tracks. */ name: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; /** - * Whether the track is enabled + * Whether the track is enabled. */ enabled: boolean; kind: RoomParticipantSubscribedTrackKind; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/video/v1/room/recordingRules.ts b/lib/rest/video/v1/room/recordingRules.ts index e35e2c6d65..635032ca01 100644 --- a/lib/rest/video/v1/room/recordingRules.ts +++ b/lib/rest/video/v1/room/recordingRules.ts @@ -208,15 +208,15 @@ export class RecordingRulesInstance { */ roomSid: string; /** - * A collection of recording Rules that describe how to include or exclude matching tracks for recording + * A collection of Recording Rules that describe how to include or exclude matching tracks for recording */ rules: Array; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateUpdated: Date; diff --git a/lib/rest/video/v1/room/roomRecording.ts b/lib/rest/video/v1/room/roomRecording.ts index c27ea3b7ff..27b662e198 100644 --- a/lib/rest/video/v1/room/roomRecording.ts +++ b/lib/rest/video/v1/room/roomRecording.ts @@ -254,59 +254,59 @@ export class RoomRecordingInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the RoomRecording resource. */ accountSid: string; status: RoomRecordingStatus; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. */ dateCreated: Date; /** - * The unique string that identifies the resource + * The unique string that we created to identify the RoomRecording resource. */ sid: string; /** - * The SID of the recording source + * The SID of the recording source. For a Room Recording, this value is a `track_sid`. */ sourceSid: string; /** - * The size of the recorded track in bytes + * The size of the recorded track in bytes. */ size: number; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; type: RoomRecordingType; /** - * The duration of the recording in seconds + * The duration of the recording rounded to the nearest second. Sub-second duration tracks have a `duration` of 1 second */ duration: number; containerFormat: RoomRecordingFormat; codec: RoomRecordingCodec; /** - * A list of SIDs related to the Recording + * A list of SIDs related to the Recording. Includes the `room_sid` and `participant_sid`. */ groupingSids: any; /** - * The name that was given to the source track of the recording + * The name that was given to the source track of the recording. If no name is given, the `source_sid` is used. */ trackName: string; /** - * The number of milliseconds between a point in time that is common to all rooms in a group and when the source room of the recording started + * The time in milliseconds elapsed between an arbitrary point in time, common to all group rooms, and the moment when the source room of this track started. This information provides a synchronization mechanism for recordings belonging to the same room. */ offset: number; /** - * The URL of the media file associated with the recording when stored externally + * The URL of the media file associated with the recording when stored externally. See [External S3 Recordings](/docs/video/api/external-s3-recordings) for more details. */ mediaExternalLocation: string; /** - * The SID of the Room resource the recording is associated with + * The SID of the Room resource the recording is associated with. */ roomSid: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/voice/v1/byocTrunk.ts b/lib/rest/voice/v1/byocTrunk.ts index 159db7f869..77e305c2ca 100644 --- a/lib/rest/voice/v1/byocTrunk.ts +++ b/lib/rest/voice/v1/byocTrunk.ts @@ -362,63 +362,63 @@ export class ByocTrunkInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the BYOC Trunk resource. */ accountSid: string; /** - * The unique string that identifies the resource + * The unique string that that we created to identify the BYOC Trunk resource. */ sid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The URL we call when receiving a call + * The URL we call using the `voice_method` when the BYOC Trunk receives a call. */ voiceUrl: string; /** - * The HTTP method to use with voice_url + * The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`. */ voiceMethod: ByocTrunkVoiceMethod; /** - * The URL we call when an error occurs while executing TwiML + * The URL that we call when an error occurs while retrieving or executing the TwiML requested from `voice_url`. */ voiceFallbackUrl: string; /** - * The HTTP method used with voice_fallback_url + * The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`. */ voiceFallbackMethod: ByocTrunkVoiceFallbackMethod; /** - * The URL that we call with status updates + * The URL that we call to pass status parameters (such as call ended) to your application. */ statusCallbackUrl: string; /** - * The HTTP method we use to call status_callback_url + * The HTTP method we use to call `status_callback_url`. Either `GET` or `POST`. */ statusCallbackMethod: ByocTrunkStatusCallbackMethod; /** - * Whether Caller ID Name (CNAM) lookup is enabled for the trunk + * Whether Caller ID Name (CNAM) lookup is enabled for the trunk. If enabled, all inbound calls to the BYOC Trunk from the United States and Canada automatically perform a CNAM Lookup and display Caller ID data on your phone. See [CNAM Lookups](https://www.twilio.com/docs/sip-trunking#CNAM) for more information. */ cnamLookupEnabled: boolean; /** - * Origination Connection Policy (to your Carrier) + * The SID of the Connection Policy that Twilio will use when routing traffic to your communications infrastructure. */ connectionPolicySid: string; /** - * The SID of the SIP Domain that should be used in the `From` header of originating calls + * The SID of the SIP Domain that should be used in the `From` header of originating calls sent to your SIP infrastructure. If your SIP infrastructure allows users to \"call back\" an incoming call, configure this with a [SIP Domain](https://www.twilio.com/docs/voice/api/sending-sip) to ensure proper routing. If not configured, the from domain will default to \"sip.twilio.com\". */ fromDomainSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/voice/v1/connectionPolicy.ts b/lib/rest/voice/v1/connectionPolicy.ts index 63e8b1d566..a1282aab3b 100644 --- a/lib/rest/voice/v1/connectionPolicy.ts +++ b/lib/rest/voice/v1/connectionPolicy.ts @@ -294,31 +294,31 @@ export class ConnectionPolicyInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Connection Policy resource. */ accountSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Connection Policy resource. */ sid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URLs of related resources + * The URLs of related resources. */ links: Record; diff --git a/lib/rest/voice/v1/connectionPolicy/connectionPolicyTarget.ts b/lib/rest/voice/v1/connectionPolicy/connectionPolicyTarget.ts index 156d4a8d76..aff8e31c9b 100644 --- a/lib/rest/voice/v1/connectionPolicy/connectionPolicyTarget.ts +++ b/lib/rest/voice/v1/connectionPolicy/connectionPolicyTarget.ts @@ -340,47 +340,47 @@ export class ConnectionPolicyTargetInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Target resource. */ accountSid: string; /** - * The SID of the Connection Policy that owns the Target + * The SID of the Connection Policy that owns the Target. */ connectionPolicySid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the Target resource. */ sid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * The SIP address you want Twilio to route your calls to + * The SIP address you want Twilio to route your calls to. This must be a `sip:` schema. `sips` is NOT supported. */ target: string; /** - * The relative importance of the target + * The relative importance of the target. Can be an integer from 0 to 65535, inclusive, and the default is 10. The lowest number represents the most important target. */ priority: number; /** - * The value that determines the relative load the Target should receive compared to others with the same priority + * The value that determines the relative share of the load the Target should receive compared to other Targets with the same priority. Can be an integer from 1 to 65535, inclusive, and the default is 10. Targets with higher values receive more load than those with lower ones with the same priority. */ weight: number; /** - * Whether the target is enabled + * Whether the target is enabled. The default is `true`. */ enabled: boolean; /** - * The RFC 2822 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT when the resource was last updated + * The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/voice/v1/dialingPermissions/bulkCountryUpdate.ts b/lib/rest/voice/v1/dialingPermissions/bulkCountryUpdate.ts index ae53e208aa..d5083bae73 100644 --- a/lib/rest/voice/v1/dialingPermissions/bulkCountryUpdate.ts +++ b/lib/rest/voice/v1/dialingPermissions/bulkCountryUpdate.ts @@ -137,7 +137,7 @@ export class BulkCountryUpdateInstance { */ updateCount: number; /** - * A URL encoded JSON array of update objects + * A bulk update request to change voice dialing country permissions stored as a URL-encoded, JSON array of update objects. For example : `[ { \"iso_code\": \"GB\", \"low_risk_numbers_enabled\": \"true\", \"high_risk_special_numbers_enabled\":\"true\", \"high_risk_tollfraud_numbers_enabled\": \"false\" } ]` */ updateRequest: string; diff --git a/lib/rest/voice/v1/dialingPermissions/country.ts b/lib/rest/voice/v1/dialingPermissions/country.ts index d0e45968a4..7fdbb12ecd 100644 --- a/lib/rest/voice/v1/dialingPermissions/country.ts +++ b/lib/rest/voice/v1/dialingPermissions/country.ts @@ -221,39 +221,39 @@ export class CountryInstance { } /** - * The ISO country code + * The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). */ isoCode: string; /** - * The name of the country + * The name of the country. */ name: string; /** - * The name of the continent in which the country is located + * The name of the continent in which the country is located. */ continent: string; /** - * The E.164 assigned country codes(s) + * The E.164 assigned [country codes(s)](https://www.itu.int/itudoc/itu-t/ob-lists/icc/e164_763.html) */ countryCodes: Array; /** - * Whether dialing to low-risk numbers is enabled + * Whether dialing to low-risk numbers is enabled. */ lowRiskNumbersEnabled: boolean; /** - * Whether dialing to high-risk special services numbers is enabled + * Whether dialing to high-risk special services numbers is enabled. These prefixes include number ranges allocated by the country and include premium numbers, special services, shared cost, and others */ highRiskSpecialNumbersEnabled: boolean; /** - * Whether dialing to high-risk toll fraud numbers is enabled, else `false` + * Whether dialing to high-risk [toll fraud](https://www.twilio.com/learn/voice-and-video/toll-fraud) numbers is enabled. These prefixes include narrow number ranges that have a high-risk of international revenue sharing fraud (IRSF) attacks, also known as [toll fraud](https://www.twilio.com/learn/voice-and-video/toll-fraud). These prefixes are collected from anti-fraud databases and verified by analyzing calls on our network. These prefixes are not available for download and are updated frequently */ highRiskTollfraudNumbersEnabled: boolean; /** - * The absolute URL of this resource + * The absolute URL of this resource. */ url: string; /** - * A list of URLs related to this resource + * A list of URLs related to this resource. */ links: Record; diff --git a/lib/rest/voice/v1/dialingPermissions/country/highriskSpecialPrefix.ts b/lib/rest/voice/v1/dialingPermissions/country/highriskSpecialPrefix.ts index 011e5c740c..dd968b7cb4 100644 --- a/lib/rest/voice/v1/dialingPermissions/country/highriskSpecialPrefix.ts +++ b/lib/rest/voice/v1/dialingPermissions/country/highriskSpecialPrefix.ts @@ -271,7 +271,7 @@ export class HighriskSpecialPrefixInstance { } /** - * A prefix that includes the E.164 assigned country code + * A prefix is a contiguous number range for a block of E.164 numbers that includes the E.164 assigned country code. For example, a North American Numbering Plan prefix like `+1510720` written like `+1(510) 720` matches all numbers inclusive from `+1(510) 720-0000` to `+1(510) 720-9999`. */ prefix: string; diff --git a/lib/rest/voice/v1/dialingPermissions/settings.ts b/lib/rest/voice/v1/dialingPermissions/settings.ts index d0af43d4db..eb2345632d 100644 --- a/lib/rest/voice/v1/dialingPermissions/settings.ts +++ b/lib/rest/voice/v1/dialingPermissions/settings.ts @@ -177,11 +177,11 @@ export class SettingsInstance { } /** - * `true` if the sub-account will inherit voice dialing permissions from the Master Project; otherwise `false` + * `true` if the sub-account will inherit voice dialing permissions from the Master Project; otherwise `false`. */ dialingPermissionsInheritance: boolean; /** - * The absolute URL of this resource + * The absolute URL of this resource. */ url: string; diff --git a/lib/rest/voice/v1/ipRecord.ts b/lib/rest/voice/v1/ipRecord.ts index 5730fd75b1..f75039424d 100644 --- a/lib/rest/voice/v1/ipRecord.ts +++ b/lib/rest/voice/v1/ipRecord.ts @@ -273,15 +273,15 @@ export class IpRecordInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the IP Record resource. */ accountSid: string; /** - * The unique string that identifies the resource + * The unique string that we created to identify the IP Record resource. */ sid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** @@ -293,15 +293,15 @@ export class IpRecordInstance { */ cidrPrefixLength: number; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/voice/v1/sourceIpMapping.ts b/lib/rest/voice/v1/sourceIpMapping.ts index 56b08cb6f0..b903b404d6 100644 --- a/lib/rest/voice/v1/sourceIpMapping.ts +++ b/lib/rest/voice/v1/sourceIpMapping.ts @@ -273,27 +273,27 @@ export class SourceIpMappingInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the IP Record resource. */ sid: string; /** - * The unique string that identifies an IP Record + * The Twilio-provided string that uniquely identifies the IP Record resource to map from. */ ipRecordSid: string; /** - * The unique string that identifies a SIP Domain + * The SID of the SIP Domain that the IP Record is mapped to. */ sipDomainSid: string; /** - * The RFC 2822 date and time in GMT that the resource was created + * The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateCreated: Date; /** - * The RFC 2822 date and time in GMT that the resource was last updated + * The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/wireless/v1/command.ts b/lib/rest/wireless/v1/command.ts index d44efe5b44..2419fbdcb5 100644 --- a/lib/rest/wireless/v1/command.ts +++ b/lib/rest/wireless/v1/command.ts @@ -248,39 +248,39 @@ export class CommandInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the Command resource. */ sid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Command resource. */ accountSid: string; /** - * The SID of the Sim resource that the Command was sent to or from + * The SID of the [Sim resource](https://www.twilio.com/docs/wireless/api/sim-resource) that the Command was sent to or from. */ simSid: string; /** - * The message being sent to or from the SIM + * The message being sent to or from the SIM. For text mode messages, this can be up to 160 characters. For binary mode messages, this is a series of up to 140 bytes of data encoded using base64. */ command: string; commandMode: CommandCommandMode; transport: CommandTransport; /** - * Whether to request a delivery receipt + * Whether to request a delivery receipt. */ deliveryReceiptRequested: boolean; status: CommandStatus; direction: CommandDirection; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the resource was last updated format + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/wireless/v1/ratePlan.ts b/lib/rest/wireless/v1/ratePlan.ts index 85c0293107..95c5a3f097 100644 --- a/lib/rest/wireless/v1/ratePlan.ts +++ b/lib/rest/wireless/v1/ratePlan.ts @@ -313,67 +313,67 @@ export class RatePlanInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the RatePlan resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the RatePlan resource. */ accountSid: string; /** - * The string that you assigned to describe the resource + * The string that you assigned to describe the resource. */ friendlyName: string; /** - * Whether SIMs can use GPRS/3G/4G/LTE data connectivity + * Whether SIMs can use GPRS/3G/4G/LTE data connectivity. */ dataEnabled: boolean; /** - * The model used to meter data usage + * The model used to meter data usage. Can be: `payg` and `quota-1`, `quota-10`, and `quota-50`. Learn more about the available [data metering models](https://www.twilio.com/docs/wireless/api/rateplan-resource#payg-vs-quota-data-plans). */ dataMetering: string; /** - * The total data usage in Megabytes that the Network allows during one month on the home network + * The total data usage (download and upload combined) in Megabytes that the Network allows during one month on the home network (T-Mobile USA). The metering period begins the day of activation and ends on the same day in the following month. Can be up to 2TB. */ dataLimit: number; /** - * Whether SIMs can make, send, and receive SMS using Commands + * Whether SIMs can make, send, and receive SMS using [Commands](https://www.twilio.com/docs/wireless/api/command-resource). */ messagingEnabled: boolean; /** - * Deprecated. Whether SIMs can make and receive voice calls + * Deprecated. Whether SIMs can make and receive voice calls. */ voiceEnabled: boolean; /** - * Whether SIMs can roam on networks other than the home network in the United States + * Whether SIMs can roam on networks other than the home network (T-Mobile USA) in the United States. See [national roaming](https://www.twilio.com/docs/wireless/api/rateplan-resource#national-roaming). */ nationalRoamingEnabled: boolean; /** - * The total data usage in Megabytes that the Network allows during one month on non-home networks in the United States + * The total data usage (download and upload combined) in Megabytes that the Network allows during one month on non-home networks in the United States. The metering period begins the day of activation and ends on the same day in the following month. Can be up to 2TB. */ nationalRoamingDataLimit: number; /** - * The services that SIMs capable of using GPRS/3G/4G/LTE data connectivity can use outside of the United States + * The list of services that SIMs capable of using GPRS/3G/4G/LTE data connectivity can use outside of the United States. Can contain: `data` and `messaging`. */ internationalRoaming: Array; /** - * The total data usage (download and upload combined) in Megabytes that the Network allows during one month when roaming outside the United States + * The total data usage (download and upload combined) in Megabytes that the Network allows during one month when roaming outside the United States. Can be up to 2TB. */ internationalRoamingDataLimit: number; /** - * The date when the resource was created, given as GMT in ISO 8601 format + * The date and time in GMT when the resource was created specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. */ dateCreated: Date; /** - * The date when the resource was last updated, given as GMT in ISO 8601 format + * The date and time in GMT when the resource was last updated specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; diff --git a/lib/rest/wireless/v1/sim.ts b/lib/rest/wireless/v1/sim.ts index 2807d5ff47..8bd8d2066f 100644 --- a/lib/rest/wireless/v1/sim.ts +++ b/lib/rest/wireless/v1/sim.ts @@ -451,93 +451,93 @@ export class SimInstance { } /** - * The unique string that identifies the Sim resource + * The unique string that we created to identify the Sim resource. */ sid: string; /** - * An application-defined string that uniquely identifies the resource + * An application-defined string that uniquely identifies the resource. It can be used in place of the resource\'s `sid` in the URL to address the resource. */ uniqueName: string; /** - * The SID of the Account to which the Sim resource belongs + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) to which the Sim resource belongs. */ accountSid: string; /** - * The SID of the RatePlan resource to which the Sim resource is assigned. + * The SID of the [RatePlan resource](https://www.twilio.com/docs/wireless/api/rateplan-resource) to which the Sim resource is assigned. */ ratePlanSid: string; /** - * The string that you assigned to describe the Sim resource + * The string that you assigned to describe the Sim resource. */ friendlyName: string; /** - * The ICCID associated with the SIM + * The [ICCID](https://en.wikipedia.org/wiki/SIM_card#ICCID) associated with the SIM. */ iccid: string; /** - * Deprecated + * Deprecated. */ eId: string; status: SimStatus; resetStatus: SimResetStatus; /** - * The URL we call when the SIM originates a machine-to-machine Command + * The URL we call using the `commands_callback_method` when the SIM originates a machine-to-machine [Command](https://www.twilio.com/docs/wireless/api/command-resource). Your server should respond with an HTTP status code in the 200 range; any response body will be ignored. */ commandsCallbackUrl: string; /** - * The HTTP method we use to call commands_callback_url + * The HTTP method we use to call `commands_callback_url`. Can be: `POST` or `GET`. Default is `POST`. */ commandsCallbackMethod: SimCommandsCallbackMethod; /** - * Deprecated + * Deprecated. */ smsFallbackMethod: SimSmsFallbackMethod; /** - * Deprecated + * Deprecated. */ smsFallbackUrl: string; /** - * Deprecated + * Deprecated. */ smsMethod: SimSmsMethod; /** - * Deprecated + * Deprecated. */ smsUrl: string; /** - * Deprecated. The HTTP method we use to call voice_fallback_url + * Deprecated. The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`. Default is `POST`. */ voiceFallbackMethod: SimVoiceFallbackMethod; /** - * Deprecated. The URL we call when an error occurs while retrieving or executing the TwiML requested from voice_url + * Deprecated. The URL we call using the `voice_fallback_method` when an error occurs while retrieving or executing the TwiML requested from `voice_url`. */ voiceFallbackUrl: string; /** - * Deprecated. The HTTP method we use to call voice_url + * Deprecated. The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`. Default is `POST`. */ voiceMethod: SimVoiceMethod; /** - * Deprecated. The URL we call when the SIM-connected device makes a voice call + * Deprecated. The URL we call using the `voice_method` when the SIM-connected device makes a voice call. */ voiceUrl: string; /** - * The ISO 8601 date and time in GMT when the resource was created + * The date and time in GMT when the resource was created specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. */ dateCreated: Date; /** - * The ISO 8601 date and time in GMT when the Sim resource was last updated + * The date and time in GMT when the Sim resource was last updated specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. */ dateUpdated: Date; /** - * The absolute URL of the resource + * The absolute URL of the resource. */ url: string; /** - * The URLs of related subresources + * The URLs of related subresources. */ links: Record; /** - * Deprecated + * Deprecated. */ ipAddress: string; diff --git a/lib/rest/wireless/v1/sim/dataSession.ts b/lib/rest/wireless/v1/sim/dataSession.ts index a8a27626c1..505c8369b0 100644 --- a/lib/rest/wireless/v1/sim/dataSession.ts +++ b/lib/rest/wireless/v1/sim/dataSession.ts @@ -278,67 +278,67 @@ export class DataSessionInstance { } /** - * The unique string that identifies the resource + * The unique string that we created to identify the DataSession resource. */ sid: string; /** - * The SID of the Sim resource that the Data Session is for + * The SID of the [Sim resource](https://www.twilio.com/docs/wireless/api/sim-resource) that the Data Session is for. */ simSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the DataSession resource. */ accountSid: string; /** - * The generation of wireless technology that the device was using + * The generation of wireless technology that the device was using. */ radioLink: string; /** - * The \'mobile country code\' is the unique ID of the home country where the Data Session took place + * The \'mobile country code\' is the unique ID of the home country where the Data Session took place. See: [MCC/MNC lookup](http://mcc-mnc.com/). */ operatorMcc: string; /** - * The \'mobile network code\' is the unique ID specific to the mobile operator network where the Data Session took place + * The \'mobile network code\' is the unique ID specific to the mobile operator network where the Data Session took place. */ operatorMnc: string; /** - * The three letter country code representing where the device\'s Data Session took place + * The three letter country code representing where the device\'s Data Session took place. This is determined by looking up the `operator_mcc`. */ operatorCountry: string; /** - * The friendly name of the mobile operator network that the SIM-connected device is attached to + * The friendly name of the mobile operator network that the [SIM](https://www.twilio.com/docs/wireless/api/sim-resource)-connected device is attached to. This is determined by looking up the `operator_mnc`. */ operatorName: string; /** - * The unique ID of the cellular tower that the device was attached to at the moment when the Data Session was last updated + * The unique ID of the cellular tower that the device was attached to at the moment when the Data Session was last updated. */ cellId: string; /** - * An object with the estimated location where the device\'s Data Session took place + * An object that describes the estimated location in latitude and longitude where the device\'s Data Session took place. The location is derived from the `cell_id` when the Data Session was last updated. See [Cell Location Estimate Object](https://www.twilio.com/docs/wireless/api/datasession-resource#cell-location-estimate-object). */ cellLocationEstimate: any; /** - * The number of packets uploaded by the device between the start time and when the Data Session was last updated + * The number of packets uploaded by the device between the `start` time and when the Data Session was last updated. */ packetsUploaded: number; /** - * The number of packets downloaded by the device between the start time and when the Data Session was last updated + * The number of packets downloaded by the device between the `start` time and when the Data Session was last updated. */ packetsDownloaded: number; /** - * The date that the resource was last updated, given as GMT in ISO 8601 format + * The date that the resource was last updated, given as GMT in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. */ lastUpdated: Date; /** - * The date that the Data Session started, given as GMT in ISO 8601 format + * The date that the Data Session started, given as GMT in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. */ start: Date; /** - * The date that the record ended, given as GMT in ISO 8601 format + * The date that the record ended, given as GMT in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. */ end: Date; /** - * The unique ID of the device using the SIM to connect + * The \'international mobile equipment identity\' is the unique ID of the device using the SIM to connect. An IMEI is a 15-digit string: 14 digits for the device identifier plus a check digit calculated using the Luhn formula. */ imei: string; diff --git a/lib/rest/wireless/v1/sim/usageRecord.ts b/lib/rest/wireless/v1/sim/usageRecord.ts index 740c16f3a2..737cdf0372 100644 --- a/lib/rest/wireless/v1/sim/usageRecord.ts +++ b/lib/rest/wireless/v1/sim/usageRecord.ts @@ -282,23 +282,23 @@ export class UsageRecordInstance { } /** - * The SID of the Sim resource that this Usage Record is for + * The SID of the [Sim resource](https://www.twilio.com/docs/wireless/api/sim-resource) that this Usage Record is for. */ simSid: string; /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the UsageRecord resource. */ accountSid: string; /** - * The time period for which the usage is reported + * The time period for which the usage is reported. Contains `start` and `end` datetime values given as GMT in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. */ period: any; /** - * An object that describes the SIM\'s usage of Commands during the specified period + * An object that describes the SIM\'s usage of Commands during the specified period. See [Commands Usage Object](https://www.twilio.com/docs/wireless/api/sim-usagerecord-resource#commands-usage-object). */ commands: any; /** - * An object that describes the SIM\'s data usage during the specified period + * An object that describes the SIM\'s data usage during the specified period. See [Data Usage Object](https://www.twilio.com/docs/wireless/api/sim-usagerecord-resource#data-usage-object). */ data: any; diff --git a/lib/rest/wireless/v1/usageRecord.ts b/lib/rest/wireless/v1/usageRecord.ts index 953f551a5a..828cd582fa 100644 --- a/lib/rest/wireless/v1/usageRecord.ts +++ b/lib/rest/wireless/v1/usageRecord.ts @@ -267,19 +267,19 @@ export class UsageRecordInstance { } /** - * The SID of the Account that created the resource + * The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the AccountUsageRecord resource. */ accountSid: string; /** - * The time period for which usage is reported + * The time period for which usage is reported. Contains `start` and `end` properties that describe the period using GMT date-time values specified in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. */ period: any; /** - * An object that describes the aggregated Commands usage for all SIMs during the specified period + * An object that describes the aggregated Commands usage for all SIMs during the specified period. See [Commands Usage Object](https://www.twilio.com/docs/wireless/api/account-usagerecord-resource#commands-usage-object). */ commands: any; /** - * An object that describes the aggregated Data usage for all SIMs over the period + * An object that describes the aggregated Data usage for all SIMs over the period. See [Data Usage Object](https://www.twilio.com/docs/wireless/api/account-usagerecord-resource#data-usage-object). */ data: any;