@rc-ex/core 1.3.7 → 1.3.8

package/src/definitions/TMTeamInfo.ts

@@ -5,7 +5,7 @@ interface TMTeamInfo {
   id?: string;
 
   /**
-   * Type of a chat
+   * Type of chat
    */
   type?: 'Team';
 

package/src/definitions/TelephonySessionsEventBody.ts

@@ -27,7 +27,7 @@ interface TelephonySessionsEventBody {
   serverId?: string;
 
   /**
-   * The call start datetime in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format including timezone, for example *2016-03-10T18:07:52.534Z*
+   * The call start date/time in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format including timezone, for example *2016-03-10T18:07:52.534Z*
    * Format: date-time
    */
   eventTime?: string;

package/src/definitions/TemporaryNumberInfo.ts

@@ -1,5 +1,6 @@
 /**
  * Temporary phone number, if any. Returned for phone numbers in `Pending` porting status only
+ *
  */
 interface TemporaryNumberInfo {
   /**
@@ -8,7 +9,8 @@ interface TemporaryNumberInfo {
   id?: string;
 
   /**
-   * Temporary phone number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) (with '+' sign) format
+   * Temporary phone number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I)
+   *  (with '+' sign) format
    */
   phoneNumber?: string;
 }

package/src/definitions/TranscribedObject.ts

@@ -1,3 +1,4 @@
+import type UtteranceObject from './UtteranceObject';
 import type WordSegment from './WordSegment';
 
 interface TranscribedObject {
@@ -8,6 +9,11 @@ interface TranscribedObject {
    */
   speakerCount?: number;
 
+  /**
+   * Speaker wise utterances. Field is set only when enableSpeakerDiarization is true.
+   */
+  utterances?: UtteranceObject[];
+
   /**
    * Required
    */

package/src/definitions/UpdateAnsweringRuleRequest.ts

@@ -20,7 +20,7 @@ interface UpdateAnsweringRuleRequest {
   forwarding?: ForwardingInfoCreateRuleRequest;
 
   /**
-   * Specifies if the rule is active or inactive. The default value is 'True'
+   * Specifies if the rule is active or inactive. The default value is `true`
    */
   enabled?: boolean;
 

package/src/definitions/UpdateContactParameters.ts

@@ -3,8 +3,8 @@
  */
 interface UpdateContactParameters {
   /**
-   * Country code value complying with the [ISO 3166-1 alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2)
-   *  format. The default value is home country of the current extension
+   * Country code value complying with the [ISO 3166-1 alpha-2](https://ru.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
+   *  The default value is home country of the current extension
    */
   dialingPlan?: string;
 }

package/src/definitions/UpdateNetworkRequest.ts

@@ -1,7 +1,6 @@
 import type AutomaticLocationUpdatesSiteInfo from './AutomaticLocationUpdatesSiteInfo';
 import type PublicIpRangeInfo from './PublicIpRangeInfo';
 import type PrivateIpRangeInfoRequest from './PrivateIpRangeInfoRequest';
-import type ERLLocationInfo from './ERLLocationInfo';
 
 interface UpdateNetworkRequest {
   /**
@@ -28,10 +27,6 @@ interface UpdateNetworkRequest {
    * Required
    */
   privateIpRanges?: PrivateIpRangeInfoRequest[];
-
-  /**
-   */
-  emergencyLocation?: ERLLocationInfo;
 }
 
 export default UpdateNetworkRequest;

package/src/definitions/UpdateSubscriptionRequest.ts

@@ -16,6 +16,7 @@ interface UpdateSubscriptionRequest {
    *  | `WebSocket`         | n/a (the parameter is ignored) |
    * Minimum: 1
    * Format: int32
+   * Example: 1200
    */
   expiresIn?: number;
 }

package/src/definitions/UpdateSwitchInfo.ts

@@ -1,5 +1,5 @@
 import type SwitchSiteInfo from './SwitchSiteInfo';
-import type EmergencyAddressInfoDefault from './EmergencyAddressInfoDefault';
+import type EmergencyAddressInfo from './EmergencyAddressInfo';
 
 interface UpdateSwitchInfo {
   /**
@@ -30,7 +30,7 @@ interface UpdateSwitchInfo {
 
   /**
    */
-  emergencyAddress?: EmergencyAddressInfoDefault;
+  emergencyAddress?: EmergencyAddressInfo;
 }
 
 export default UpdateSwitchInfo;

package/src/definitions/UpdateWirelessPoint.ts

@@ -1,5 +1,5 @@
 import type EmergencyAddressAutoUpdateSiteInfo from './EmergencyAddressAutoUpdateSiteInfo';
-import type EmergencyAddressInfoDefault from './EmergencyAddressInfoDefault';
+import type EmergencyAddressInfo from './EmergencyAddressInfo';
 
 interface UpdateWirelessPoint {
   /**
@@ -25,7 +25,7 @@ interface UpdateWirelessPoint {
 
   /**
    */
-  emergencyAddress?: EmergencyAddressInfoDefault;
+  emergencyAddress?: EmergencyAddressInfo;
 }
 
 export default UpdateWirelessPoint;

package/src/definitions/UserPhoneNumberExtensionInfo.ts

@@ -28,7 +28,7 @@ interface UserPhoneNumberExtensionInfo {
    *  created by partner. The RingCentral supports the mapping of accounts and
    *  stores the corresponding account ID/extension ID for each partner ID of
    *  a client application. In request URIs partner IDs are accepted instead
-   *  of regular RingCentral native IDs as path parameters using pid = XXX clause.
+   *  of regular RingCentral native IDs as path parameters using `pid=XXX` clause.
    *  Though in response URIs contain the corresponding account IDs and extension
    *  IDs. In all request and response bodies these values are reflected via
    *  partnerId attributes of account and extension

package/src/definitions/UserPhoneNumberInfo.ts

@@ -28,7 +28,7 @@ interface UserPhoneNumberInfo {
   extension?: UserPhoneNumberExtensionInfo;
 
   /**
-   * Custom user name of a phone number, if any
+   * Custom user-defined name of a phone number, if any
    */
   label?: string;
 
@@ -38,7 +38,8 @@ interface UserPhoneNumberInfo {
   location?: string;
 
   /**
-   * Payment type. 'External' is returned for forwarded numbers which are not terminated in the RingCentral phone system
+   * Payment type. 'External' is returned for forwarded numbers
+   *  which are not terminated in the RingCentral phone system
    */
   paymentType?: 'External' | 'TollFree' | 'Local' | 'BusinessMobileNumberProvider' | 'ExternalNumberProvider';
 
@@ -48,12 +49,14 @@ interface UserPhoneNumberInfo {
   phoneNumber?: string;
 
   /**
-   * Specifies if a phone number is primary, i.e. displayed as 'main number' and called by default
+   * Indicates if a phone number is primary, i.e. displayed as 'main number' and called by default
    */
   primary?: boolean;
 
   /**
-   * 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';
 
@@ -63,12 +66,12 @@ interface UserPhoneNumberInfo {
   type?: 'VoiceFax' | 'FaxOnly' | 'VoiceOnly';
 
   /**
-   * Extension sub-type, if applicable. For any unsupported sub-types the 'Unknown' value will be returned
+   * Extension subtype, if applicable. For any unsupported subtypes the 'Unknown' value will be returned
    */
   subType?: 'VideoPro' | 'VideoProPlus' | 'DigitalSignage' | 'Unknown';
 
   /**
-   * Usage type of a phone number. Numbers of 'NumberPool' type will not be returned for phone number list requests
+   * Usage type of phone number. Numbers of 'NumberPool' type will not be returned for phone number list requests
    */
   usageType?:
     | 'MainCompanyNumber'

package/src/definitions/UtteranceObject.ts

@@ -0,0 +1,40 @@
+import type WordTimingsUnit from './WordTimingsUnit';
+
+interface UtteranceObject {
+  /**
+   * Required
+   * Format: float
+   * Example: 0.3
+   */
+  start?: number;
+
+  /**
+   * Required
+   * Format: float
+   * Example: 5.1
+   */
+  end?: number;
+
+  /**
+   * Required
+   * Example: Hello! This is John.
+   */
+  text?: string;
+
+  /**
+   * Format: float
+   * Example: 0.97
+   */
+  confidence?: number;
+
+  /**
+   * Example: JohnDoe
+   */
+  speakerId?: string;
+
+  /**
+   */
+  wordTimings?: WordTimingsUnit[];
+}
+
+export default UtteranceObject;

package/src/definitions/VoicemailInfo.ts

@@ -5,7 +5,7 @@ import type RecipientInfo from './RecipientInfo';
  */
 interface VoicemailInfo {
   /**
-   * If 'True' then voicemails are allowed to be received
+   * If `true` then voicemails are allowed to be received
    */
   enabled?: boolean;
 

package/src/definitions/VoicemailMessageEvent.ts

@@ -12,7 +12,7 @@ interface VoicemailMessageEvent {
   event?: string;
 
   /**
-   * Datetime of sending a notification in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format including timezone, for example *2016-03-10T18:07:52.534Z*
+   * Date/time of sending a notification in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format including timezone, for example *2016-03-10T18:07:52.534Z*
    */
   timestamp?: string;
 

package/src/definitions/VoicemailMessageEventBody.ts

@@ -21,19 +21,19 @@ interface VoicemailMessageEventBody {
   from?: SenderInfo;
 
   /**
-   * Type of a message
+   * Type of message
    */
   type?: 'Voicemail';
 
   /**
-   * Message creation datetime in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
+   * Message creation date/time in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
    *  format including timezone, for example *2019-03-10T18:07:52.534Z*
    * Format: date-time
    */
   creationTime?: string;
 
   /**
-   * Datetime when a message was modified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
+   * Date/time when a message was modified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
    *  format including timezone, for example *2019-03-10T18:07:52.534Z*
    * Format: date-time
    */

package/src/definitions/WcsSessionBaseModel.ts

@@ -25,7 +25,6 @@ interface WcsSessionBaseModel {
 
   /**
    * Localized time zone description.
-   * Required
    * Example: Eastern Time (America/New_York)
    */
   localizedTimeZoneDescription?: string;

package/src/definitions/WcsSessionResource.ts

@@ -45,7 +45,6 @@ interface WcsSessionResource {
 
   /**
    * Localized time zone description.
-   * Required
    * Example: Eastern Time (America/New_York)
    */
   localizedTimeZoneDescription?: string;

package/src/definitions/WcsSessionWithLocaleCodeModel.ts

@@ -25,7 +25,6 @@ interface WcsSessionWithLocaleCodeModel {
 
   /**
    * Localized time zone description.
-   * Required
    * Example: Eastern Time (America/New_York)
    */
   localizedTimeZoneDescription?: string;

package/src/definitions/WirelessPointInfo.ts

@@ -1,5 +1,5 @@
 import type EmergencyAddressAutoUpdateSiteInfo from './EmergencyAddressAutoUpdateSiteInfo';
-import type WirelessPointInfoEmergencyAddress from './WirelessPointInfoEmergencyAddress';
+import type EmergencyAddressInfo from './EmergencyAddressInfo';
 import type ERLLocationInfo from './ERLLocationInfo';
 
 interface WirelessPointInfo {
@@ -31,13 +31,9 @@ interface WirelessPointInfo {
   site?: EmergencyAddressAutoUpdateSiteInfo;
 
   /**
-   * Emergency address information (or information assigned to the
-   *  switch or wireless point - in case of using them). Only one of a pair
-   *  `emergencyAddress` or `emergencyLocationId` should be specified,
-   *  otherwise an error is returned
    * Required
    */
-  emergencyAddress?: WirelessPointInfoEmergencyAddress;
+  emergencyAddress?: EmergencyAddressInfo;
 
   /**
    */

package/src/paths/Ai/Text/V1/Async/Summarize/index.ts

@@ -15,7 +15,7 @@ class Index {
     return `${this._parent.path()}/summarize`;
   }
   /**
-   * Returns Conversational Summarization to webhook uri.
+   * Returns Conversational Summarization to webhook uri for segmented transcript of audios with start,end,speakerId, text(alphanumeric and punctuations).
    * HTTP Method: post
    * Endpoint: /ai/text/v1/async/summarize
    * Rate Limit Group: Heavy

package/src/paths/Restapi/Account/BusinessAddress/index.ts

@@ -29,7 +29,7 @@ class Index {
 
   /**
    * Updates the business address of a company that account is linked
-   * to. Batch request is supported.
+   * to.
    *
    * HTTP Method: put
    * Endpoint: /restapi/{apiVersion}/account/{accountId}/business-address

package/src/paths/Restapi/Account/EmergencyLocations/index.ts

@@ -1,6 +1,6 @@
 import type DeleteEmergencyLocationParameters from '../../../../definitions/DeleteEmergencyLocationParameters';
 import type ReadEmergencyLocationParameters from '../../../../definitions/ReadEmergencyLocationParameters';
-import type EmergencyLocationResource from '../../../../definitions/EmergencyLocationResource';
+import type CommonEmergencyLocationResource from '../../../../definitions/CommonEmergencyLocationResource';
 import type EmergencyLocationInfoRequest from '../../../../definitions/EmergencyLocationInfoRequest';
 import type EmergencyLocationsResource from '../../../../definitions/EmergencyLocationsResource';
 import type ListEmergencyLocationsParameters from '../../../../definitions/ListEmergencyLocationsParameters';
@@ -49,8 +49,8 @@ class Index {
   public async post(
     emergencyLocationInfoRequest: EmergencyLocationInfoRequest,
     restRequestConfig?: RestRequestConfig,
-  ): Promise<EmergencyLocationResource> {
-    const r = await this.rc.post<EmergencyLocationResource>(
+  ): Promise<CommonEmergencyLocationResource> {
+    const r = await this.rc.post<CommonEmergencyLocationResource>(
       this.path(false),
       emergencyLocationInfoRequest,
       undefined,
@@ -70,11 +70,11 @@ class Index {
   public async get(
     queryParams?: ReadEmergencyLocationParameters,
     restRequestConfig?: RestRequestConfig,
-  ): Promise<EmergencyLocationResource> {
+  ): Promise<CommonEmergencyLocationResource> {
     if (this.locationId === null) {
       throw new Error('locationId must be specified.');
     }
-    const r = await this.rc.get<EmergencyLocationResource>(this.path(), queryParams, restRequestConfig);
+    const r = await this.rc.get<CommonEmergencyLocationResource>(this.path(), queryParams, restRequestConfig);
     return r.data;
   }
 
@@ -89,11 +89,11 @@ class Index {
   public async put(
     emergencyLocationInfoRequest: EmergencyLocationInfoRequest,
     restRequestConfig?: RestRequestConfig,
-  ): Promise<EmergencyLocationResource> {
+  ): Promise<CommonEmergencyLocationResource> {
     if (this.locationId === null) {
       throw new Error('locationId must be specified.');
     }
-    const r = await this.rc.put<EmergencyLocationResource>(
+    const r = await this.rc.put<CommonEmergencyLocationResource>(
       this.path(),
       emergencyLocationInfoRequest,
       undefined,

package/src/paths/Restapi/Account/Extension/AddressBook/Contact/index.ts

@@ -61,7 +61,8 @@ class Index {
   }
 
   /**
-   * Returns the user personal contact(s). Batch request syntax is supported.
+   * Returns the user personal contact(s).
+   * [Batch request syntax](https://developers.ringcentral.com/api-reference/Batch-Requests) is supported.
    *
    * HTTP Method: get
    * Endpoint: /restapi/{apiVersion}/account/{accountId}/extension/{extensionId}/address-book/contact/{contactId}
@@ -78,7 +79,8 @@ class Index {
   }
 
   /**
-   * Updates the user personal contact(s) (full resource update). Batch request syntax is supported
+   * Updates the user personal contact(s) (full resource update).
+   * [Batch request syntax](https://developers.ringcentral.com/api-reference/Batch-Requests) is supported.
    *
    * HTTP Method: put
    * Endpoint: /restapi/{apiVersion}/account/{accountId}/extension/{extensionId}/address-book/contact/{contactId}
@@ -104,7 +106,8 @@ class Index {
   }
 
   /**
-   * Deletes the user personal contact(s). Batch request syntax is supported.
+   * Deletes the user personal contact(s).
+   * [Batch request syntax](https://developers.ringcentral.com/api-reference/Batch-Requests) is supported.
    *
    * HTTP Method: delete
    * Endpoint: /restapi/{apiVersion}/account/{accountId}/extension/{extensionId}/address-book/contact/{contactId}

package/src/paths/Restapi/Account/Extension/CallerBlocking/PhoneNumbers/index.ts

@@ -58,7 +58,9 @@ class Index {
   }
 
   /**
-   * Returns blocked or allowed phone number(s) by their ID(s). Batch request is supported.
+   * Returns blocked or allowed phone number(s) by their ID(s).
+   * [Batch request syntax](https://developers.ringcentral.com/api-reference/Batch-Requests) is supported.
+   *
    * HTTP Method: get
    * Endpoint: /restapi/{apiVersion}/account/{accountId}/extension/{extensionId}/caller-blocking/phone-numbers/{blockedNumberId}
    * Rate Limit Group: Light
@@ -74,7 +76,9 @@ class Index {
   }
 
   /**
-   * Updates blocked or allowed phone number(s) by their ID(s). Batch request is supported.
+   * Updates blocked or allowed phone number(s) by their ID(s).
+   * [Batch request syntax](https://developers.ringcentral.com/api-reference/Batch-Requests) is supported.
+   *
    * HTTP Method: put
    * Endpoint: /restapi/{apiVersion}/account/{accountId}/extension/{extensionId}/caller-blocking/phone-numbers/{blockedNumberId}
    * Rate Limit Group: Medium

package/src/paths/Restapi/Account/Extension/EmergencyLocations/index.ts

@@ -1,5 +1,6 @@
 import type DeleteExtensionEmergencyLocationParameters from '../../../../../definitions/DeleteExtensionEmergencyLocationParameters';
-import type EmergencyLocationResource from '../../../../../definitions/EmergencyLocationResource';
+import type EmergencyLocationInfoRequest from '../../../../../definitions/EmergencyLocationInfoRequest';
+import type CommonEmergencyLocationResource from '../../../../../definitions/CommonEmergencyLocationResource';
 import type CreateUserEmergencyLocationRequest from '../../../../../definitions/CreateUserEmergencyLocationRequest';
 import type EmergencyLocationsResource from '../../../../../definitions/EmergencyLocationsResource';
 import type GetExtensionEmergencyLocationsParameters from '../../../../../definitions/GetExtensionEmergencyLocationsParameters';
@@ -47,8 +48,8 @@ class Index {
   public async post(
     createUserEmergencyLocationRequest: CreateUserEmergencyLocationRequest,
     restRequestConfig?: RestRequestConfig,
-  ): Promise<EmergencyLocationResource> {
-    const r = await this.rc.post<EmergencyLocationResource>(
+  ): Promise<CommonEmergencyLocationResource> {
+    const r = await this.rc.post<CommonEmergencyLocationResource>(
       this.path(false),
       createUserEmergencyLocationRequest,
       undefined,
@@ -64,11 +65,11 @@ class Index {
    * Rate Limit Group: Light
    * App Permission: ReadAccounts
    */
-  public async get(restRequestConfig?: RestRequestConfig): Promise<EmergencyLocationResource> {
+  public async get(restRequestConfig?: RestRequestConfig): Promise<CommonEmergencyLocationResource> {
     if (this.locationId === null) {
       throw new Error('locationId must be specified.');
     }
-    const r = await this.rc.get<EmergencyLocationResource>(this.path(), undefined, restRequestConfig);
+    const r = await this.rc.get<CommonEmergencyLocationResource>(this.path(), undefined, restRequestConfig);
     return r.data;
   }
 
@@ -82,15 +83,15 @@ class Index {
    * User Permission: EmergencyFramework
    */
   public async put(
-    emergencyLocationResource: EmergencyLocationResource,
+    emergencyLocationInfoRequest: EmergencyLocationInfoRequest,
     restRequestConfig?: RestRequestConfig,
-  ): Promise<EmergencyLocationResource> {
+  ): Promise<CommonEmergencyLocationResource> {
     if (this.locationId === null) {
       throw new Error('locationId must be specified.');
     }
-    const r = await this.rc.put<EmergencyLocationResource>(
+    const r = await this.rc.put<CommonEmergencyLocationResource>(
       this.path(),
-      emergencyLocationResource,
+      emergencyLocationInfoRequest,
       undefined,
       restRequestConfig,
     );

package/src/paths/Restapi/Account/Extension/Fax/index.ts

@@ -15,7 +15,7 @@ class Index {
     return `${this._parent.path()}/fax`;
   }
   /**
-   * Creates and sends/resends a fax message. Resend can be implemented
+   * Creates and sends/re-sends a fax message. Re-send can be implemented
    * if sending has failed. Fax attachment size (both single and total) is
    * limited to 50Mb.
    *

package/src/paths/Restapi/Account/Extension/Presence/index.ts

@@ -16,19 +16,13 @@ class Index {
     return `${this._parent.path()}/presence`;
   }
   /**
-   * Returns the presence status of an extension or several extensions
-   * by their ID(s). Batch request is supported. The `presenceStatus` is returned
-   * as Offline (the parameters `telephonyStatus`, `message`, `userStatus`
-   * and `dndStatus` are not returned at all) for the following extension types:
-   * Department/Announcement Only/Take Messages Only (Voicemail)/Fax User/Paging
-   * Only Group/Shared Lines Group/IVR Menu/Application Extension/Park Location.If
-   * the user requests his/her own presence status, the response contains actual
-   * presence status even if the status publication is turned off. Batch request
-   * is supported. For batch requests the number of extensions in one request is
-   * limited to 30. If more extensions are included in the request, the error code
-   * 400 Bad Request is returned with the logical error code InvalidMultipartRequest
-   * and the corresponding message Extension Presence Info multipart request
-   * is limited to 30 extensions.
+   * Returns the presence status of an extension or several extensions by their ID(s). The `presenceStatus` is returned as Offline
+   * (the parameters `telephonyStatus`, `message`, `userStatus` and `dndStatus` are not returned at all) for the following extension types:
+   * Department/Announcement Only/Take Messages Only (Voicemail)/Fax User/Paging Only Group/Shared Lines Group/IVR Menu/Application Extension/Park Location.
+   * If the user requests his/her own presence status, the response contains actual presence status even if the status publication is turned off.
+   * [Batch request syntax](https://developers.ringcentral.com/api-reference/Batch-Requests) is supported. For batch requests the number of extensions
+   * in one request is limited to 30. If more extensions are included in the request, the error code 400 Bad Request is returned with the logical error
+   * code InvalidMultipartRequest and the corresponding message Extension Presence Info multipart request is limited to 30 extensions.
    *
    * HTTP Method: get
    * Endpoint: /restapi/{apiVersion}/account/{accountId}/extension/{extensionId}/presence

package/src/paths/Restapi/Account/PhoneNumber/index.ts

@@ -38,8 +38,8 @@ class Index {
   }
 
   /**
-   * Returns phone number(s) belonging to a certain account or extension
-   * by phoneNumberId(s). Batch request is supported.
+   * Returns phone number(s) belonging to a certain account or extension by phoneNumberId(s).
+   * [Batch request syntax](https://developers.ringcentral.com/api-reference/Batch-Requests) is supported.
    *
    * HTTP Method: get
    * Endpoint: /restapi/{apiVersion}/account/{accountId}/phone-number/{phoneNumberId}

package/src/paths/Restapi/Oauth/Revoke/index.ts

@@ -1,3 +1,4 @@
+import type RevokeTokenParameters from '../../../../definitions/RevokeTokenParameters';
 import type RevokeTokenRequest from '../../../../definitions/RevokeTokenRequest';
 import type { RingCentralInterface, ParentInterface, RestRequestConfig } from '../../../../types';
 
@@ -13,7 +14,8 @@ class Index {
     return `${this._parent.path()}/revoke`;
   }
   /**
-   * Revokes previously issued access and refresh token.
+   * Revokes all active access/refresh tokens and invalidates the OAuth session basing on token provided.
+   * `token` parameter may be passed in query string or body and may represent access or refresh token.
    *
    * Depending on client application type
    * requests to this endpoint may require authentication with HTTP Basic scheme
@@ -23,8 +25,12 @@ class Index {
    * Endpoint: /restapi/oauth/revoke
    * Rate Limit Group: Auth
    */
-  public async post(revokeTokenRequest: RevokeTokenRequest, restRequestConfig?: RestRequestConfig): Promise<string> {
-    const r = await this.rc.post<string>(this.path(), revokeTokenRequest, undefined, restRequestConfig);
+  public async post(
+    revokeTokenRequest: RevokeTokenRequest,
+    queryParams?: RevokeTokenParameters,
+    restRequestConfig?: RestRequestConfig,
+  ): Promise<string> {
+    const r = await this.rc.post<string>(this.path(), revokeTokenRequest, queryParams, restRequestConfig);
     return r.data;
   }
 }

package/src/paths/Restapi/Subscription/index.ts

@@ -110,6 +110,9 @@ class Index {
    * If the request body is empty then the specified subscription will be renewed without any
    * event filter modifications and using the default expiration time.
    *
+   * If the request is sent with empty body, it just renews a subscription
+   * (so it is an equivalent of the `POST /restapi/v1.0/subscription/{subscriptionId}/renew`).
+   *
    * Please note that `WebSocket` subscriptions cannot be updated via HTTP interface.
    *
    * HTTP Method: put

package/src/paths/Restapi/V2/Accounts/Devices/index.ts

@@ -20,12 +20,12 @@ class Index {
     return `${this._parent.path()}/devices`;
   }
   /**
-   * Disassociates phone line (DL & Device) from an extension.
-   *  - if value ```keepAssetsInInventory == true```,
+   * Disassociates a phone line (DL & Device) from an extension:
+   *
+   *  - if the value of `keepAssetsInInventory` is `true`,
    * the given device is moved to unassigned devices and the number is moved to the number inventory;
-   *  - if value ```keepAssetsInInventory == false```, the given device and number is removed from the account;
-   *  - if the parameter keepAssetsInInventory is not set (empty body),
-   * default value ```keepAssetsInInventory == true``` is used.
+   *  - if the value of `keepAssetsInInventory` is `false`, the given device and number is removed from the account;
+   *  - if the parameter `keepAssetsInInventory` is not set (empty body), default value `true` is set.
    *
    * HTTP Method: delete
    * Endpoint: /restapi/v2/accounts/{accountId}/devices/{deviceId}