@rc-ex/core 1.3.15 → 1.4.1

package/src/definitions/GetTokenRequest.ts

@@ -1,23 +1,22 @@
+/**
+ * Token endpoint request parameters used in the "Guest" authorization flow
+ * with the `guest` grant type
+ *
+ */
 interface GetTokenRequest {
   /**
-   * For `password` grant type only. User login name: email or phone number in E.164 format
+   * Client assertion type for the `client_secret_jwt` or `private_key_jwt` client authentication types,
+   *  as defined by [RFC-7523](https://datatracker.ietf.org/doc/html/rfc7523#section-2.2).
+   *  This parameter is mandatory if the client authentication is required and a client decided to use one of these authentication types
    */
-  username?: string;
+  client_assertion_type?: 'urn:ietf:params:oauth:client-assertion-type:jwt-bearer';
 
   /**
-   * For `password` grant type only. User's password
-   * Format: password
-   */
-  password?: string;
-
-  /**
-   * For `password` grant type only. Optional. Extension short number. If company number
-   *  is specified as a username, and extension is not specified, the
-   *  server will attempt to authenticate client as main company administrator
-   *
-   *  DEPRECATED: use extension number embedded into username string like `+16501234567*101`
+   * Client assertion (JWT) for the `client_secret_jwt` or `private_key_jwt` client authentication types,
+   *  as defined by [RFC-7523](https://datatracker.ietf.org/doc/html/rfc7523#section-2.2).
+   *  This parameter is mandatory if the client authentication is required and a client decided to use one of these authentication types
    */
-  extension?: string;
+  client_assertion?: string;
 
   /**
    * Grant type
@@ -38,17 +37,25 @@ interface GetTokenRequest {
     | 'ivr_pin';
 
   /**
-   * For `authorization_code` grant type only. User's authorization code
+   * The list of application permissions (OAuth scopes) requested.
+   *  By default, it includes all permissions configured on
+   *  the client application registration
    */
-  code?: string;
+  scope?: string;
 
   /**
-   * For `authorization_code` grant type only. This is a callback URI which determines where the response
-   *  is sent. The value of this parameter must exactly match one of
-   *  the URIs you have provided for your app upon registration
-   * Format: uri
+   * The registered identifier of a client application.
+   *  Used to identify a client ONLY if the client authentication is not required and
+   *  corresponding credentials are not provided with this request
+   * Example: AZwEVwGEcfGet2PCouA7K6
    */
-  redirect_uri?: string;
+  client_id?: string;
+
+  /**
+   * The unique identifier of a client application instance. If not
+   *  specified, the derived or auto-generated value will be used
+   */
+  endpoint_id?: string;
 
   /**
    * Access token lifetime in seconds
@@ -68,72 +75,112 @@ interface GetTokenRequest {
   refresh_token_ttl?: number;
 
   /**
-   * List of application permissions to be used with access token.
-   *  By default, the scope includes all permissions configured during
-   *  the application registration phase
+   * For `otp` grant type only.
+   *  One-time password code
+   * Required
    */
-  scope?: string;
+  code?: string;
 
   /**
-   * For `refresh_token` grant type only. Previously issued refresh token.
+   * For `authorization_code` grant type only. This is a callback URI which determines where the response
+   *  is sent. The value of this parameter must exactly match one of
+   *  the URIs you have provided for your app upon registration
+   * Format: uri
    */
-  refresh_token?: string;
+  redirect_uri?: string;
 
   /**
-   * The unique identifier of a client application instance. If not
-   *  specified, the derived or auto generated value will be used
+   * For `authorization_code` grant type only.
+   *  The code verifier as defined by  the PKCE specification -
+   *  [RFC-7636 "Proof Key for Code Exchange by OAuth Public Clients"](https://datatracker.ietf.org/doc/html/rfc7636)
    */
-  endpoint_id?: string;
+  code_verifier?: string;
 
   /**
+   * For `password` grant type only. User login name: email or phone number in E.164 format
+   * Required
    */
-  pin?: string;
+  username?: string;
 
   /**
-   * OAuth client identifier (if not specified via `Authorization` header)
+   * For `password` grant type only. User's password
+   * Required
+   * Format: password
    */
-  client_id?: string;
+  password?: string;
 
   /**
+   * For `password` grant type only. Optional. Extension short number. If a company number
+   *  is specified as a username, and extension is not specified, the
+   *  server will attempt to authenticate client as main company administrator
+   *
+   *  DEPRECATED: use extension number embedded into username string like `+16501234567*101`
    */
-  account_id?: string;
+  extension?: string;
 
   /**
+   * IVR pin for pin-based authentication.
+   *
+   *  DEPRECATED: use a dedicated `ivr_pin` grant type instead
    */
-  partner_account_id?: string;
+  pin?: string;
 
   /**
-   * Client assertion type
+   * For `urn:ietf:params:oauth:grant-type:jwt-bearer` or `partner_jwt` grant types only.
+   *  Authorization grant assertion (JWT)
+   *  as defined by [RFC-7523](https://datatracker.ietf.org/doc/html/rfc7523#section-2.1).
+   * Required
    */
-  client_assertion_type?: string;
+  assertion?: string;
 
   /**
-   * Client assertion
+   * For `refresh_token` grant type only. Previously issued refresh token.
+   * Required
    */
-  client_assertion?: string;
+  refresh_token?: string;
 
   /**
-   * For `jwt_bearer` grant type only. Assertion
+   * For `ivr_pin` grant type only. User's IVR pin.
+   * Required
    */
-  assertion?: string;
+  ivr_pin?: string;
 
   /**
+   * For `urn:ietf:params:oauth:grant-type:device_code` grant type only.
+   *  The device verification code as defined by [RFC-8628](https://datatracker.ietf.org/doc/html/rfc8628#section-3.4)
+   * Required
+   */
+  device_code?: string;
+
+  /**
+   * RingCentral Brand identifier.
+   * Required
    */
   brand_id?: string;
 
   /**
-   * PKCE code verifier
+   * RingCentral internal account ID
+   * Required
    */
-  code_verifier?: string;
+  account_id?: string;
 
   /**
+   * The ID of the account on RingCentral partner's side
+   * Required
    */
-  device_code?: string;
+  partner_account_id?: string;
+
+  /**
+   * Resource type for the guest access.
+   * Required
+   */
+  resource_type?: string;
 
   /**
-   * For `ivr_pin` grant type only. IVR pin.
+   * Resource URL for the guest access.
+   * Required
    */
-  ivr_pin?: string;
+  resource?: string;
 }
 
 export default GetTokenRequest;

package/src/definitions/GuestTokenRequest.ts

@@ -0,0 +1,31 @@
+/**
+ * Token endpoint request parameters used in the "Guest" authorization flow
+ * with the `guest` grant type
+ *
+ */
+interface GuestTokenRequest {
+  /**
+   * Grant type
+   * Required
+   */
+  grant_type?: 'guest';
+
+  /**
+   * RingCentral Brand identifier.
+   */
+  brand_id?: string;
+
+  /**
+   * Resource type for the guest access.
+   * Required
+   */
+  resource_type?: string;
+
+  /**
+   * Resource URL for the guest access.
+   * Required
+   */
+  resource?: string;
+}
+
+export default GuestTokenRequest;

package/src/definitions/IdentityExtraValues.ts

@@ -1,5 +1,5 @@
 /**
- * Additional data to store along the identity.
+ * Additional data to store along with identity
  */
 // eslint-disable-next-line @typescript-eslint/no-empty-interface
 interface IdentityExtraValues {}

package/src/definitions/IdentityModel.ts

@@ -9,7 +9,7 @@ interface IdentityModel {
   id?: string;
 
   /**
-   * Identity's avatar Uri.
+   * Identity's avatar URI
    * Format: uri
    * Example: https://example.com/assets/avatar/default-79fd530c58c2a6b83a11fcc0e842ed7023ceb69292cfeb857bc2af2c624b90fd.png
    */
@@ -30,7 +30,7 @@ interface IdentityModel {
   creationTime?: string;
 
   /**
-   * Display name of the identity.
+   * Display name of identity
    * Example: John Doe
    */
   displayName?: string;
@@ -65,14 +65,19 @@ interface IdentityModel {
   homePhone?: string;
 
   /**
-   * The identity group id references the identity group that contains
-   *  all information (phone, notes, etc.). Many identities may belong to
-   *  this group. If the identity group id is null, it means that identity
-   *  does not have a group and any extra information.
+   * Identity group identifier which references the identity group that contains
+   *  all information (phone, notes, etc). Multiple identities may belong to
+   *  a single group. If the parameter value is null, it means that identity
+   *  does not belong to a group or have extra information
    * Example: 54085e5b7aa58d8b5d00006c
    */
   identityGroupId?: string;
 
+  /**
+   * Either Agent or Customer
+   */
+  identityType?: 'Agent' | 'Customer';
+
   /**
    * LastName.
    * Example: Doe
@@ -86,13 +91,13 @@ interface IdentityModel {
   mobilePhone?: string;
 
   /**
-   * Screen name of the identity.
+   * Screen name of identity
    * Example: John D.
    */
   screenName?: string;
 
   /**
-   * Type of the identity.
+   * Type of identity
    * Required
    */
   type?:
@@ -100,7 +105,6 @@ interface IdentityModel {
     | 'Email'
     | 'EngageMessaging'
     | 'Facebook'
-    | 'GoogleBusinessMessages'
     | 'GoogleMyBusiness'
     | 'Instagram'
     | 'Linkedin'
@@ -118,160 +122,124 @@ interface IdentityModel {
   lastModifiedTime?: string;
 
   /**
-   * List of the associated user identifiers who can use the identity.
+   * List of the associated user identifiers who can use the identity
    */
   userIds?: string[];
 
   /**
-   * UUID of the identity.
+   * UUID of identity
    * Example: 9680ab94-3b78-495c-bb2c-a969954d8260
    */
   uuid?: string;
 
   /**
-   * Device info of the identity.
-   *
-   *  Applicable to RingCX Digital Messaging channels only.
+   * Device info of the identity. Applicable to RingCX Digital Messaging channels only
    * Example: iPhone (iPhone); iOS 15.0.2
    */
   mobileDeviceInfo?: string;
 
   /**
-   * Facebook biography of the identity.
-   *
-   *  Applicable to Facebook and Messenger channels only.
+   * Facebook biography of the identity. Applicable to Facebook and Messenger channels only
    * Example: Painter living in Paris
    */
   fbBio?: string;
 
   /**
-   * Facebook category of the identity.
-   *
-   *  Applicable to Facebook and Messenger channels only.
+   * Facebook category of the identity. Applicable to Facebook and Messenger channels only
    * Example: Computers/Internet
    */
   fbCategory?: string;
 
   /**
-   * Facebook locale of the identity.
-   *
-   *  Applicable to Facebook and Messenger channels only.
+   * Facebook locale of the identity. Applicable to Facebook and Messenger channels only
    * Example: fr_FR
    */
   fbLocale?: string;
 
   /**
-   * Instagram followers count of the identity.
-   *
-   *  Applicable to Instagram and InstagramMessaging channels only.
+   * Instagram followers count of the identity. Applicable to Instagram and InstagramMessaging channels only
    * Format: int32
    * Example: 10
    */
   igFollowersCount?: number;
 
   /**
-   * Twitter description of the identity.
-   *
-   *  Applicable to Twitter channels only.
+   * Twitter description of the identity. Applicable to Twitter channels only
    * Example: Software Engineer
    */
   twDescription?: string;
 
   /**
-   * Twitter followers count of the identity.
-   *
-   *  Applicable to Twitter channels only.
+   * Twitter followers count of the identity. Applicable to Twitter channels only
    * Format: int32
    * Example: 10
    */
   twFollowersCount?: number;
 
   /**
-   * Count of Twitter accounts followed by the identity.
-   *
-   *  Applicable to Twitter channels only.
+   * Count of Twitter accounts followed by the identity. Applicable to Twitter channels only
    * Format: int32
    * Example: 500
    */
   twFollowingCount?: number;
 
   /**
-   * Count of tweets of the identity.
-   *
-   *  Applicable to Twitter channels only.
+   * Count of tweets of the identity. Applicable to Twitter channels only
    * Format: int32
    * Example: 42
    */
   twStatusesCount?: number;
 
   /**
-   * Twitter location of the identity.
-   *
-   *  Applicable to Twitter channels only.
+   * Twitter location of the identity. Applicable to Twitter channels only
    * Example: Paris
    */
   twLocation?: string;
 
   /**
-   * Viber API version of the identity.
-   *
-   *  Applicable to Viber channels only.
+   * Viber API version of the identity. Applicable to Viber channels only
    * Example: 10
    */
   apiVersion?: string;
 
   /**
-   * Viber country of the identity.
-   *
-   *  Applicable to Viber channels only.
+   * Viber country of the identity. Applicable to Viber channels only
    * Example: FR
    */
   country?: string;
 
   /**
-   * Viber device type of the identity.
-   *
-   *  Applicable to Viber channels only.
+   * Viber device type of the identity. Applicable to Viber channels only
    * Example: SM-G970U1
    */
   deviceType?: string;
 
   /**
-   * Viber language of the identity.
-   *
-   *  Applicable to Viber channels only.
+   * Viber language of the identity. Applicable to Viber channels only
    * Example: fr-FR
    */
   language?: string;
 
   /**
-   * Viber mobile country code of the identity.
-   *
-   *  Applicable to Viber channels only.
+   * Viber mobile country code of the identity. Applicable to Viber channels only
    * Example: 1
    */
   mcc?: string;
 
   /**
-   * Viber mobile network code of the identity.
-   *
-   *  Applicable to Viber channels only.
+   * Viber mobile network code of the identity. Applicable to Viber channels only
    * Example: 220
    */
   mnc?: string;
 
   /**
-   * Viber primary device OS of the identity.
-   *
-   *  Applicable to Viber channels only.
+   * Viber primary device OS of the identity. Applicable to Viber channels only
    * Example: Android 11
    */
   primaryDeviceOs?: string;
 
   /**
-   * Viber application version of the identity.
-   *
-   *  Applicable to Viber channels only.
+   * Viber application version of the identity. Applicable to Viber channels only
    * Example: 19.5.0
    */
   viberVersion?: string;

package/src/definitions/IvrPinTokenRequest.ts

@@ -0,0 +1,19 @@
+/**
+ * Token endpoint request parameters used in the "IVR Pin" authorization flow with the `ivr_pin` grant type
+ *
+ */
+interface IvrPinTokenRequest {
+  /**
+   * Grant type
+   * Required
+   */
+  grant_type?: 'ivr_pin';
+
+  /**
+   * For `ivr_pin` grant type only. User's IVR pin.
+   * Required
+   */
+  ivr_pin?: string;
+}
+
+export default IvrPinTokenRequest;

package/src/definitions/JobStatusResponse.ts

@@ -1,3 +1,5 @@
+import type JobStatusResponseResponse from './JobStatusResponseResponse';
+
 interface JobStatusResponse {
   /**
    */
@@ -17,6 +19,14 @@ interface JobStatusResponse {
    * Format: date-time
    */
   expirationTime?: string;
+
+  /**
+   */
+  status?: 'Success' | 'Fail';
+
+  /**
+   */
+  response?: JobStatusResponseResponse;
 }
 
 export default JobStatusResponse;

package/src/definitions/JobStatusResponseResponse.ts

@@ -0,0 +1,48 @@
+import type UtteranceObject from './UtteranceObject';
+import type WordSegment from './WordSegment';
+import type UtteranceInsightsObject from './UtteranceInsightsObject';
+import type SpeakerInsightsObject from './SpeakerInsightsObject';
+import type ConversationalInsightsUnit from './ConversationalInsightsUnit';
+
+interface JobStatusResponseResponse {
+  /**
+   * The number of speakers detected. Field is set only when enableSpeakerDiarization is true.
+   * Format: int32
+   * Example: 2
+   */
+  speakerCount?: number;
+
+  /**
+   * Speaker wise utterances. Field is set only when enableSpeakerDiarization is true.
+   */
+  utterances?: UtteranceObject[];
+
+  /**
+   */
+  words?: WordSegment[];
+
+  /**
+   * Overall transcription confidence.
+   * Format: float
+   */
+  confidence?: number;
+
+  /**
+   * The entire transcript with/without punctuations according to the input.
+   */
+  transcript?: string;
+
+  /**
+   */
+  utteranceInsights?: UtteranceInsightsObject[];
+
+  /**
+   */
+  speakerInsights?: SpeakerInsightsObject;
+
+  /**
+   */
+  conversationalInsights?: ConversationalInsightsUnit[];
+}
+
+export default JobStatusResponseResponse;

package/src/definitions/JwtTokenRequest.ts

@@ -0,0 +1,22 @@
+/**
+ * Token endpoint request parameters used in the "Personal JWT", "JWT Bearer" and "Partner JWT" authorization flows
+ * with the `urn:ietf:params:oauth:grant-type:jwt-bearer` and `partner_jwt` grant types
+ *
+ */
+interface JwtTokenRequest {
+  /**
+   * Grant type
+   * Required
+   */
+  grant_type?: 'urn:ietf:params:oauth:grant-type:jwt-bearer' | 'partner_jwt';
+
+  /**
+   * For `urn:ietf:params:oauth:grant-type:jwt-bearer` or `partner_jwt` grant types only.
+   *  Authorization grant assertion (JWT)
+   *  as defined by [RFC-7523](https://datatracker.ietf.org/doc/html/rfc7523#section-2.1).
+   * Required
+   */
+  assertion?: string;
+}
+
+export default JwtTokenRequest;

package/src/definitions/LanguageInfo.ts

@@ -31,7 +31,8 @@ interface LanguageInfo {
   localeCode?: string;
 
   /**
-   * Country code according to the ISO standard, see [ISO 3166](https://www.iso.org/iso-3166-country-codes.html)
+   * Two-letter country code in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format
+   * Example: US
    */
   isoCode?: string;
 

package/src/definitions/ListAccountPhoneNumbersParameters.ts

@@ -49,9 +49,11 @@ interface ListAccountPhoneNumbersParameters {
     | 'ExternalNumberProviderTollFree';
 
   /**
-   * Status of a phone number
+   * Status of a phone number. If the value is `Normal`, the phone
+   *  number is ready to be used. Otherwise, it is an external number not yet
+   *  ported to RingCentral
    */
-  status?: 'Normal' | 'Pending' | 'PortedIn' | 'Temporary';
+  status?: 'Normal' | 'Pending' | 'PortedIn' | 'Temporary' | 'Unknown';
 }
 
 export default ListAccountPhoneNumbersParameters;

package/src/definitions/ListAccountPhoneNumbersV2Parameters.ts

@@ -51,7 +51,9 @@ interface ListAccountPhoneNumbersV2Parameters {
   )[];
 
   /**
-   * Status of a phone number. If the value is 'Normal', the phone number is ready to be used. Otherwise, it is an external number not yet ported to RingCentral
+   * Status of a phone number. If the value is `Normal`, the phone
+   *  number is ready to be used. Otherwise, it is an external number not yet
+   *  ported to RingCentral
    */
   status?: 'Normal' | 'Pending' | 'PortedIn' | 'Temporary' | 'Unknown';
 

package/src/definitions/ListCallMonitoringGroupsParameters.ts

@@ -22,6 +22,11 @@ interface ListCallMonitoringGroupsParameters {
    *  group within the result
    */
   memberExtensionId?: string;
+
+  /**
+   * Internal identifier of a site
+   */
+  siteId?: string;
 }
 
 export default ListCallMonitoringGroupsParameters;

package/src/definitions/ListCompanyMessageTemplatesParameters.ts

@@ -0,0 +1,12 @@
+/**
+ * Query parameters for operation listCompanyMessageTemplates
+ */
+interface ListCompanyMessageTemplatesParameters {
+  /**
+   * Site ID(s) to filter company message templates, associated with particular sites
+   *  By default the value is all - templates with all sites will be returned
+   */
+  siteIds?: string[];
+}
+
+export default ListCompanyMessageTemplatesParameters;

package/src/definitions/ListDirectoryEntriesParameters.ts

@@ -2,6 +2,12 @@
  * Query parameters for operation listDirectoryEntries
  */
 interface ListDirectoryEntriesParameters {
+  /**
+   * Flag to enable cross-site limitation checking
+   * Example: true
+   */
+  accessibleSitesOnly?: boolean;
+
   /**
    * If `true` then contacts of all accounts in federation are returned. If `false` then only contacts of the current account are returned, and account section is eliminated in this case
    * Default: true