From 0d524293d64f98525957a127c1be5d67d3d87a25 Mon Sep 17 00:00:00 2001
From: PureCloud Jenkins
Date: Tue, 29 Oct 2024 06:38:25 +0000
Subject: [PATCH] 207.0.0
---
README.md | 103 +-
build/.openapi-generator/FILES | 18 +
build/APIData.json | 342 +-
build/README.md | 103 +-
.../dist/node/purecloud-platform-client-v2.js | 804 +-
.../web-amd/purecloud-platform-client-v2.js | 804 +-
.../purecloud-platform-client-v2.min.js | 2 +-
build/dist/web-cjs/bundle.js | 368 +-
.../web-cjs/purecloud-platform-client-v2.js | 368 +-
.../purecloud-platform-client-v2.min.js | 2 +-
build/docs/AgentAssistantsApi.md | 2 +-
build/docs/AgentCopilotApi.md | 2 +-
build/docs/AgentUIApi.md | 2 +-
build/docs/AlertingApi.md | 2 +-
build/docs/AnalyticsApi.md | 20 +-
build/docs/ArchitectApi.md | 6 +-
build/docs/AuditApi.md | 2 +-
build/docs/AuthorizationApi.md | 6 +-
build/docs/BillingApi.md | 2 +-
build/docs/CarrierServicesApi.md | 2 +-
build/docs/ChatApi.md | 2 +-
build/docs/CoachingApi.md | 2 +-
build/docs/ContentManagementApi.md | 4 +-
build/docs/ConversationsApi.md | 7 +-
build/docs/DataExtensionsApi.md | 2 +-
build/docs/DownloadsApi.md | 2 +-
build/docs/EmailsApi.md | 2 +-
build/docs/EmployeeEngagementApi.md | 2 +-
build/docs/EventsApi.md | 2 +-
build/docs/ExternalContactsApi.md | 469 +-
build/docs/FaxApi.md | 2 +-
build/docs/FlowsApi.md | 2 +-
build/docs/GamificationApi.md | 2 +-
.../GeneralDataProtectionRegulationApi.md | 2 +-
build/docs/GeolocationApi.md | 2 +-
build/docs/GreetingsApi.md | 2 +-
build/docs/GroupsApi.md | 2 +-
build/docs/IdentityProviderApi.md | 2 +-
build/docs/InfrastructureAsCodeApi.md | 2 +-
build/docs/IntegrationsApi.md | 2 +-
build/docs/JourneyApi.md | 8 +-
build/docs/KnowledgeApi.md | 54 +-
build/docs/LanguageUnderstandingApi.md | 2 +-
build/docs/LanguagesApi.md | 2 +-
build/docs/LearningApi.md | 2 +-
build/docs/LicenseApi.md | 2 +-
build/docs/LocationsApi.md | 2 +-
build/docs/LogCaptureApi.md | 2 +-
build/docs/MessagingApi.md | 2 +-
build/docs/MobileDevicesApi.md | 2 +-
build/docs/NotificationsApi.md | 2 +-
build/docs/OAuthApi.md | 2 +-
build/docs/ObjectsApi.md | 2 +-
build/docs/OperationalEventsApi.md | 2 +-
build/docs/OrganizationApi.md | 2 +-
build/docs/OrganizationAuthorizationApi.md | 109 +-
build/docs/OutboundApi.md | 212 +-
build/docs/PresenceApi.md | 2 +-
build/docs/ProcessAutomationApi.md | 2 +-
build/docs/QualityApi.md | 2 +-
build/docs/RecordingApi.md | 2 +-
build/docs/ResponseManagementApi.md | 2 +-
build/docs/RoutingApi.md | 2 +-
build/docs/SCIMApi.md | 2 +-
build/docs/ScreenRecordingApi.md | 2 +-
build/docs/ScriptsApi.md | 2 +-
build/docs/SearchApi.md | 2 +-
build/docs/SettingsApi.md | 2 +-
build/docs/SpeechTextAnalyticsApi.md | 2 +-
build/docs/StationsApi.md | 2 +-
build/docs/SuggestApi.md | 2 +-
build/docs/TaskManagementApi.md | 2 +-
build/docs/TeamsApi.md | 10 +-
build/docs/TelephonyApi.md | 2 +-
build/docs/TelephonyProvidersEdgeApi.md | 2 +-
build/docs/TextbotsApi.md | 2 +-
build/docs/TokensApi.md | 2 +-
build/docs/UploadsApi.md | 2 +-
build/docs/UsageApi.md | 2 +-
build/docs/UserRecordingsApi.md | 2 +-
build/docs/UsersApi.md | 60 +-
build/docs/UtilitiesApi.md | 2 +-
build/docs/VoicemailApi.md | 110 +-
build/docs/WebChatApi.md | 2 +-
build/docs/WebDeploymentsApi.md | 4 +-
build/docs/WebMessagingApi.md | 2 +-
build/docs/WidgetsApi.md | 2 +-
build/docs/WorkforceManagementApi.md | 2 +-
build/docs/index.md | 103 +-
build/docs/releaseNotes.md | 10596 +++++++++++++++-
build/index.d.ts | 1045 +-
build/package-lock.json | 1363 +-
build/package.json | 2 +-
.../purecloud-platform-client-v2/ApiClient.js | 58 +-
.../api/AgentAssistantsApi.js | 2 +-
.../api/AgentCopilotApi.js | 2 +-
.../api/AgentUIApi.js | 2 +-
.../api/AlertingApi.js | 2 +-
.../api/AnalyticsApi.js | 13 +-
.../api/ArchitectApi.js | 4 +-
.../api/AuditApi.js | 2 +-
.../api/AuthorizationApi.js | 2 +-
.../api/BillingApi.js | 2 +-
.../api/CarrierServicesApi.js | 2 +-
.../api/ChatApi.js | 2 +-
.../api/CoachingApi.js | 2 +-
.../api/ContentManagementApi.js | 5 +-
.../api/ConversationsApi.js | 5 +-
.../api/DataExtensionsApi.js | 2 +-
.../api/DownloadsApi.js | 2 +-
.../api/EmailsApi.js | 2 +-
.../api/EmployeeEngagementApi.js | 2 +-
.../api/EventsApi.js | 2 +-
.../api/ExternalContactsApi.js | 233 +-
.../api/FaxApi.js | 2 +-
.../api/FlowsApi.js | 2 +-
.../api/GamificationApi.js | 2 +-
.../api/GeneralDataProtectionRegulationApi.js | 2 +-
.../api/GeolocationApi.js | 2 +-
.../api/GreetingsApi.js | 2 +-
.../api/GroupsApi.js | 2 +-
.../api/IdentityProviderApi.js | 2 +-
.../api/InfrastructureAsCodeApi.js | 2 +-
.../api/IntegrationsApi.js | 2 +-
.../api/JourneyApi.js | 5 +-
.../api/KnowledgeApi.js | 20 +-
.../api/LanguageUnderstandingApi.js | 2 +-
.../api/LanguagesApi.js | 2 +-
.../api/LearningApi.js | 2 +-
.../api/LicenseApi.js | 2 +-
.../api/LocationsApi.js | 2 +-
.../api/LogCaptureApi.js | 2 +-
.../api/MessagingApi.js | 2 +-
.../api/MobileDevicesApi.js | 2 +-
.../api/NotificationsApi.js | 2 +-
.../api/OAuthApi.js | 2 +-
.../api/ObjectsApi.js | 2 +-
.../api/OperationalEventsApi.js | 2 +-
.../api/OrganizationApi.js | 2 +-
.../api/OrganizationAuthorizationApi.js | 49 +-
.../api/OutboundApi.js | 102 +-
.../api/PresenceApi.js | 2 +-
.../api/ProcessAutomationApi.js | 2 +-
.../api/QualityApi.js | 2 +-
.../api/RecordingApi.js | 2 +-
.../api/ResponseManagementApi.js | 2 +-
.../api/RoutingApi.js | 2 +-
.../api/SCIMApi.js | 2 +-
.../api/ScreenRecordingApi.js | 2 +-
.../api/ScriptsApi.js | 2 +-
.../api/SearchApi.js | 2 +-
.../api/SettingsApi.js | 2 +-
.../api/SpeechTextAnalyticsApi.js | 2 +-
.../api/StationsApi.js | 2 +-
.../api/SuggestApi.js | 2 +-
.../api/TaskManagementApi.js | 2 +-
.../api/TeamsApi.js | 10 +-
.../api/TelephonyApi.js | 2 +-
.../api/TelephonyProvidersEdgeApi.js | 2 +-
.../api/TextbotsApi.js | 2 +-
.../api/TokensApi.js | 2 +-
.../api/UploadsApi.js | 2 +-
.../api/UsageApi.js | 2 +-
.../api/UserRecordingsApi.js | 2 +-
.../api/UsersApi.js | 28 +-
.../api/UtilitiesApi.js | 2 +-
.../api/VoicemailApi.js | 57 +-
.../api/WebChatApi.js | 2 +-
.../api/WebDeploymentsApi.js | 2 +-
.../api/WebMessagingApi.js | 2 +-
.../api/WidgetsApi.js | 2 +-
.../api/WorkforceManagementApi.js | 2 +-
.../configuration.js | 81 +
.../src/purecloud-platform-client-v2/index.js | 2 +-
notificationMappings.json | 4 +
releaseNotes.md | 10596 +++++++++++++++-
swagger.json | 2 +-
version.json | 6 +-
178 files changed, 26448 insertions(+), 2194 deletions(-)
diff --git a/README.md b/README.md
index b1c18b87b..7593784b9 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@ A JavaScript library to interface with the Genesys Cloud Platform API. View the
[![npm](https://img.shields.io/npm/v/purecloud-platform-client-v2.svg)](https://www.npmjs.com/package/purecloud-platform-client-v2)
[![Release Notes Badge](https://developer-content.genesys.cloud/images/sdk-release-notes.png)](https://github.com/MyPureCloud/platform-client-sdk-javascript/blob/master/releaseNotes.md)
-Documentation version purecloud-platform-client-v2@206.0.0
+Documentation version purecloud-platform-client-v2@207.0.0
## Preview APIs
@@ -29,7 +29,7 @@ For direct use in a browser script:
```html
-
+
@@ -346,6 +346,79 @@ JSON:
}
```
+The Genesys Cloud Login and API URL path can be overridden if necessary (i.e. if the Genesys Cloud requests must be sent through to an intermediate API gateway or equivalent).
+
+This can be achieved defining a "gateway" configuration, in the INI or the JSON configuration file.
+
+* "host" is the address of your gateway.
+* "protocol" is not mandatory. It will default to "https" if the parameter is not defined or empty.
+* "port" is not mandatory. This parameter can be defined if a non default port is used and needs to be specified in the url (value must be greater or equal to 0).
+* "path_params_login" and "path_params_api" are not mandatory. They will be appended to the gateway url path if these parameters are defined and non empty (for Login requests and for API requests).
+* "username" and "password" are not used at this stage. This is for a possible future use.
+
+With the configuration below, this would result in:
+
+* Login requests to: "https://mygateway.mydomain.myextension:1443/myadditionalpathforlogin" (e.g. "https://mygateway.mydomain.myextension:1443/myadditionalpathforlogin/oauth/token")
+* API requests to: "https://mygateway.mydomain.myextension:1443/myadditionalpathforapi" (e.g. "https://mygateway.mydomain.myextension:1443/myadditionalpathforlogin/api/v2/users/me")
+
+INI:
+
+```ini
+[logging]
+log_level = trace
+log_format = text
+log_to_console = false
+log_file_path = /var/log/javascriptsdk.log
+log_response_body = false
+log_request_body = false
+[reauthentication]
+refresh_access_token = true
+refresh_token_wait_max = 10
+[general]
+live_reload_config = true
+host = https://api.mypurecloud.com
+[gateway]
+host = mygateway.mydomain.myextension
+protocol = https
+port = 1443
+path_params_login = myadditionalpathforlogin
+path_params_api = myadditionalpathforapi
+username = username
+password = password
+```
+
+JSON:
+
+```json
+{
+ "logging": {
+ "log_level": "trace",
+ "log_format": "text",
+ "log_to_console": false,
+ "log_file_path": "/var/log/javascriptsdk.log",
+ "log_response_body": false,
+ "log_request_body": false
+ },
+ "reauthentication": {
+ "refresh_access_token": true,
+ "refresh_token_wait_max": 10
+ },
+ "general": {
+ "live_reload_config": true,
+ "host": "https://api.mypurecloud.com"
+ },
+ "gateway": {
+ "host": "mygateway.mydomain.myextension",
+ "protocol": "https",
+ "port": 1443,
+ "path_params_login": "myadditionalpathforlogin",
+ "path_params_api": "myadditionalpathforapi",
+ "username": "username",
+ "password": "password"
+ }
+}
+```
+
## Environments
If connecting to a Genesys Cloud environment other than mypurecloud.com (e.g. mypurecloud.ie), set the environment on the `ApiClient` instance with the PureCloudRegionHosts object.
@@ -355,6 +428,30 @@ const client = platformClient.ApiClient.instance;
client.setEnvironment(platformClient.PureCloudRegionHosts.eu_west_1);
```
+### Setting an intermediate Gateway
+
+The Genesys Cloud Login and API URL path can be overridden if necessary (i.e. if the Genesys Cloud requests must be sent through to an intermediate API gateway or equivalent).
+
+This can be achieved setting the gateway configuration on the `ApiClient` instance.
+
+```javascript
+const client = platformClient.ApiClient.instance;
+client.setGateway({host: 'mygateway.mydomain.myextension', protocol: 'https', port: 1443, path_params_login: 'myadditionalpathforlogin', path_params_api: 'myadditionalpathforapi'});
+
+// If you need, you can later remove the Gateway Configuration and fallback to the Enviroment setting using: client.setGateway();
+```
+
+* "host" is the address of your gateway.
+* "protocol" is not mandatory. It will default to "https" if the parameter is not defined or empty.
+* "port" is not mandatory. This parameter can be defined if a non default port is used and needs to be specified in the url (value must be greater or equal to 0).
+* "path_params_login" and "path_params_api" are not mandatory. They will be appended to the gateway url path if these parameters are defined and non empty (for Login requests and for API requests).
+* "username" and "password" are not used at this stage. This is for a possible future use.
+
+With the configuration below, this would result in:
+
+* Login requests to: "https://mygateway.mydomain.myextension:1443/myadditionalpathforlogin" (e.g. "https://mygateway.mydomain.myextension:1443/myadditionalpathforlogin/oauth/token")
+* API requests to: "https://mygateway.mydomain.myextension:1443/myadditionalpathforapi" (e.g. "https://mygateway.mydomain.myextension:1443/myadditionalpathforlogin/api/v2/users/me")
+
## Access Token persistence
diff --git a/build/.openapi-generator/FILES b/build/.openapi-generator/FILES
index ddcf34ad4..c5bece08a 100644
--- a/build/.openapi-generator/FILES
+++ b/build/.openapi-generator/FILES
@@ -218,6 +218,7 @@ docs/deleteExternalcontactsContact-example.txt
docs/deleteExternalcontactsContactNote-example.txt
docs/deleteExternalcontactsContactsSchema-example.txt
docs/deleteExternalcontactsExternalsource-example.txt
+docs/deleteExternalcontactsImportCsvSetting-example.txt
docs/deleteExternalcontactsOrganization-example.txt
docs/deleteExternalcontactsOrganizationNote-example.txt
docs/deleteExternalcontactsOrganizationTrustor-example.txt
@@ -747,6 +748,10 @@ docs/getExternalcontactsContactsSchemaVersions-example.txt
docs/getExternalcontactsContactsSchemas-example.txt
docs/getExternalcontactsExternalsource-example.txt
docs/getExternalcontactsExternalsources-example.txt
+docs/getExternalcontactsImportCsvSetting-example.txt
+docs/getExternalcontactsImportCsvSettings-example.txt
+docs/getExternalcontactsImportCsvUploadDetails-example.txt
+docs/getExternalcontactsImportCsvUploadPreview-example.txt
docs/getExternalcontactsOrganization-example.txt
docs/getExternalcontactsOrganizationContacts-example.txt
docs/getExternalcontactsOrganizationNote-example.txt
@@ -1110,6 +1115,7 @@ docs/getOrgauthorizationTrusteeUser-example.txt
docs/getOrgauthorizationTrusteeUserRoles-example.txt
docs/getOrgauthorizationTrusteeUsers-example.txt
docs/getOrgauthorizationTrustees-example.txt
+docs/getOrgauthorizationTrusteesCare-example.txt
docs/getOrgauthorizationTrusteesDefault-example.txt
docs/getOrgauthorizationTrustor-example.txt
docs/getOrgauthorizationTrustorCloneduser-example.txt
@@ -1540,6 +1546,7 @@ docs/getUserrecordingsSummary-example.txt
docs/getUsers-example.txt
docs/getUsersAgentuiAgentsAutoanswerAgentIdSettings-example.txt
docs/getUsersAgentuiAgentsAutoanswerAgentIdSettings-example.txt
+docs/getUsersChatsMe-example.txt
docs/getUsersDevelopmentActivities-example.txt
docs/getUsersDevelopmentActivitiesMe-example.txt
docs/getUsersDevelopmentActivity-example.txt
@@ -1562,6 +1569,8 @@ docs/getVoicemailPolicy-example.txt
docs/getVoicemailQueueMessages-example.txt
docs/getVoicemailSearch-example.txt
docs/getVoicemailSearch-example.txt
+docs/getVoicemailUserMailbox-example.txt
+docs/getVoicemailUserMessages-example.txt
docs/getVoicemailUserpolicy-example.txt
docs/getWebchatDeployment-example.txt
docs/getWebchatDeployments-example.txt
@@ -2127,6 +2136,9 @@ docs/postExternalcontactsContacts-example.txt
docs/postExternalcontactsContactsSchemas-example.txt
docs/postExternalcontactsExternalsources-example.txt
docs/postExternalcontactsIdentifierlookup-example.txt
+docs/postExternalcontactsImportCsvJobs-example.txt
+docs/postExternalcontactsImportCsvSettings-example.txt
+docs/postExternalcontactsImportCsvUploads-example.txt
docs/postExternalcontactsMergeContacts-example.txt
docs/postExternalcontactsOrganizationNotes-example.txt
docs/postExternalcontactsOrganizations-example.txt
@@ -2291,6 +2303,7 @@ docs/postOrgauthorizationTrusteeGroups-example.txt
docs/postOrgauthorizationTrusteeUsers-example.txt
docs/postOrgauthorizationTrustees-example.txt
docs/postOrgauthorizationTrusteesAudits-example.txt
+docs/postOrgauthorizationTrusteesCare-example.txt
docs/postOrgauthorizationTrusteesDefault-example.txt
docs/postOrgauthorizationTrustorAudits-example.txt
docs/postOutboundAttemptlimits-example.txt
@@ -2298,6 +2311,8 @@ docs/postOutboundCallabletimesets-example.txt
docs/postOutboundCallanalysisresponsesets-example.txt
docs/postOutboundCampaignAgentownedmappingpreview-example.txt
docs/postOutboundCampaignCallbackSchedule-example.txt
+docs/postOutboundCampaignStart-example.txt
+docs/postOutboundCampaignStop-example.txt
docs/postOutboundCampaignrules-example.txt
docs/postOutboundCampaigns-example.txt
docs/postOutboundCampaignsProgress-example.txt
@@ -2324,6 +2339,8 @@ docs/postOutboundDnclists-example.txt
docs/postOutboundFilespecificationtemplates-example.txt
docs/postOutboundImporttemplates-example.txt
docs/postOutboundImporttemplatesBulkAdd-example.txt
+docs/postOutboundMessagingcampaignStart-example.txt
+docs/postOutboundMessagingcampaignStop-example.txt
docs/postOutboundMessagingcampaigns-example.txt
docs/postOutboundMessagingcampaignsProgress-example.txt
docs/postOutboundRulesets-example.txt
@@ -2626,6 +2643,7 @@ docs/putExternalcontactsContactNote-example.txt
docs/putExternalcontactsContactsSchema-example.txt
docs/putExternalcontactsConversation-example.txt
docs/putExternalcontactsExternalsource-example.txt
+docs/putExternalcontactsImportCsvSetting-example.txt
docs/putExternalcontactsOrganization-example.txt
docs/putExternalcontactsOrganizationNote-example.txt
docs/putExternalcontactsOrganizationTrustorTrustorId-example.txt
diff --git a/build/APIData.json b/build/APIData.json
index 88f316c80..c14c8bb14 100644
--- a/build/APIData.json
+++ b/build/APIData.json
@@ -1292,7 +1292,7 @@
"getanalyticsreportingdashboardsusers": {
"operationId": "getanalyticsreportingdashboardsusers",
"functionName": "getAnalyticsReportingDashboardsUsers",
- "signature": "getAnalyticsReportingDashboardsUsers(sortBy, pageNumber, pageSize, id, state)",
+ "signature": "getAnalyticsReportingDashboardsUsers(sortBy, pageNumber, pageSize, id, state, deletedOnly)",
"parameters": [
{
"name": "sortBy",
@@ -1318,10 +1318,15 @@
"name": "state",
"type": "String",
"required": "false"
+ },
+ {
+ "name": "deletedOnly",
+ "type": "Boolean",
+ "required": "false"
}
],
"return": "DashboardUserListing",
- "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.AnalyticsApi();\n\nlet opts = { \n \"sortBy\": \"asc\", // String | \n \"pageNumber\": 1, // Number | \n \"pageSize\": 25, // Number | \n \"id\": [\"id_example\"], // [String] | A list of user IDs to fetch by bulk\n \"state\": \"state_example\" // String | Only list users of this state\n};\n\n// Get dashboards summary for users in a org\napiInstance.getAnalyticsReportingDashboardsUsers(opts)\n .then((data) => {\n console.log(`getAnalyticsReportingDashboardsUsers success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getAnalyticsReportingDashboardsUsers\");\n console.error(err);\n });"
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.AnalyticsApi();\n\nlet opts = { \n \"sortBy\": \"asc\", // String | \n \"pageNumber\": 1, // Number | \n \"pageSize\": 25, // Number | \n \"id\": [\"id_example\"], // [String] | A list of user IDs to fetch by bulk\n \"state\": \"state_example\", // String | Only list users of this state\n \"deletedOnly\": true // Boolean | Only list deleted dashboards that are still recoverable\n};\n\n// Get dashboards summary for users in a org\napiInstance.getAnalyticsReportingDashboardsUsers(opts)\n .then((data) => {\n console.log(`getAnalyticsReportingDashboardsUsers success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getAnalyticsReportingDashboardsUsers\");\n console.error(err);\n });"
},
"getanalyticsreportingexports": {
"operationId": "getanalyticsreportingexports",
@@ -1398,7 +1403,7 @@
"getanalyticsreportingsettingsuserdashboards": {
"operationId": "getanalyticsreportingsettingsuserdashboards",
"functionName": "getAnalyticsReportingSettingsUserDashboards",
- "signature": "getAnalyticsReportingSettingsUserDashboards(userId, sortBy, pageNumber, pageSize, publicOnly, favoriteOnly, name)",
+ "signature": "getAnalyticsReportingSettingsUserDashboards(userId, sortBy, pageNumber, pageSize, publicOnly, favoriteOnly, deletedOnly, name)",
"parameters": [
{
"name": "userId",
@@ -1430,6 +1435,11 @@
"type": "Boolean",
"required": "false"
},
+ {
+ "name": "deletedOnly",
+ "type": "Boolean",
+ "required": "false"
+ },
{
"name": "name",
"type": "String",
@@ -1437,7 +1447,7 @@
}
],
"return": "DashboardConfigurationListing",
- "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.AnalyticsApi();\n\nlet userId = \"userId_example\"; // String | User ID\nlet opts = { \n \"sortBy\": \"asc\", // String | \n \"pageNumber\": 1, // Number | \n \"pageSize\": 50, // Number | \n \"publicOnly\": true, // Boolean | If true, retrieve only public dashboards\n \"favoriteOnly\": true, // Boolean | If true, retrieve only favorite dashboards\n \"name\": \"name_example\" // String | retrieve dashboards that match with given name\n};\n\n// Get list of dashboards for an user\napiInstance.getAnalyticsReportingSettingsUserDashboards(userId, opts)\n .then((data) => {\n console.log(`getAnalyticsReportingSettingsUserDashboards success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getAnalyticsReportingSettingsUserDashboards\");\n console.error(err);\n });"
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.AnalyticsApi();\n\nlet userId = \"userId_example\"; // String | User ID\nlet opts = { \n \"sortBy\": \"asc\", // String | \n \"pageNumber\": 1, // Number | \n \"pageSize\": 50, // Number | \n \"publicOnly\": true, // Boolean | If true, retrieve only public dashboards\n \"favoriteOnly\": true, // Boolean | If true, retrieve only favorite dashboards\n \"deletedOnly\": true, // Boolean | If true, retrieve only deleted dashboards that are still recoverable\n \"name\": \"name_example\" // String | retrieve dashboards that match with given name\n};\n\n// Get list of dashboards for an user\napiInstance.getAnalyticsReportingSettingsUserDashboards(userId, opts)\n .then((data) => {\n console.log(`getAnalyticsReportingSettingsUserDashboards success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getAnalyticsReportingSettingsUserDashboards\");\n console.error(err);\n });"
},
"getanalyticsresolutionsaggregatesjob": {
"operationId": "getanalyticsresolutionsaggregatesjob",
@@ -2077,7 +2087,7 @@
"required": "true"
}
],
- "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.AnalyticsApi();\n\nlet body = [\"body_example\"]; // [String] | List of userIds\n\n// Bulk delete dashboards owned by other user(s)\napiInstance.postAnalyticsReportingDashboardsUsersBulkRemove(body)\n .then(() => {\n console.log(\"postAnalyticsReportingDashboardsUsersBulkRemove returned successfully.\");\n })\n .catch((err) => {\n console.log(\"There was a failure calling postAnalyticsReportingDashboardsUsersBulkRemove\");\n console.error(err);\n });"
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.AnalyticsApi();\n\nlet body = [\"body_example\"]; // [String] | List of userIds\n\n// Bulk soft delete dashboards owned by other user(s)\napiInstance.postAnalyticsReportingDashboardsUsersBulkRemove(body)\n .then(() => {\n console.log(\"postAnalyticsReportingDashboardsUsersBulkRemove returned successfully.\");\n })\n .catch((err) => {\n console.log(\"There was a failure calling postAnalyticsReportingDashboardsUsersBulkRemove\");\n console.error(err);\n });"
},
"postanalyticsreportingexports": {
"operationId": "postanalyticsreportingexports",
@@ -2104,7 +2114,7 @@
"required": "true"
}
],
- "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.AnalyticsApi();\n\nlet body = {}; // Object | \n\n// Bulk remove dashboard configurations\napiInstance.postAnalyticsReportingSettingsDashboardsBulkRemove(body)\n .then(() => {\n console.log(\"postAnalyticsReportingSettingsDashboardsBulkRemove returned successfully.\");\n })\n .catch((err) => {\n console.log(\"There was a failure calling postAnalyticsReportingSettingsDashboardsBulkRemove\");\n console.error(err);\n });"
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.AnalyticsApi();\n\nlet body = {}; // Object | \n\n// Bulk soft delete dashboard configurations\napiInstance.postAnalyticsReportingSettingsDashboardsBulkRemove(body)\n .then(() => {\n console.log(\"postAnalyticsReportingSettingsDashboardsBulkRemove returned successfully.\");\n })\n .catch((err) => {\n console.log(\"There was a failure calling postAnalyticsReportingSettingsDashboardsBulkRemove\");\n console.error(err);\n });"
},
"postanalyticsreportingsettingsdashboardsquery": {
"operationId": "postanalyticsreportingsettingsdashboardsquery",
@@ -3972,7 +3982,7 @@
}
],
"return": "Object",
- "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ArchitectApi();\n\nlet flowId = \"flowId_example\"; // String | Flow ID\nlet versionId = \"versionId_example\"; // String | Version ID\nlet opts = { \n \"deleted\": \"deleted_example\" // String | Deleted flows\n};\n\n// Create flow version configuration\napiInstance.getFlowVersionConfiguration(flowId, versionId, opts)\n .then((data) => {\n console.log(`getFlowVersionConfiguration success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getFlowVersionConfiguration\");\n console.error(err);\n });"
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ArchitectApi();\n\nlet flowId = \"flowId_example\"; // String | Flow ID\nlet versionId = \"versionId_example\"; // String | Version ID\nlet opts = { \n \"deleted\": \"deleted_example\" // String | Deleted flows\n};\n\n// Get flow version configuration\napiInstance.getFlowVersionConfiguration(flowId, versionId, opts)\n .then((data) => {\n console.log(`getFlowVersionConfiguration success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getFlowVersionConfiguration\");\n console.error(err);\n });"
},
"getflowversionhealth": {
"operationId": "getflowversionhealth",
@@ -6254,7 +6264,7 @@
"required": "false"
}
],
- "return": "UserEntityListing",
+ "return": "UserReferenceEntityListing",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.AuthorizationApi();\n\nlet roleId = \"roleId_example\"; // String | Role ID\nlet opts = { \n \"pageSize\": 25, // Number | Page size\n \"pageNumber\": 1 // Number | Page number\n};\n\n// Get a list of the users in a specified role.\napiInstance.getAuthorizationRoleUsers(roleId, opts)\n .then((data) => {\n console.log(`getAuthorizationRoleUsers success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getAuthorizationRoleUsers\");\n console.error(err);\n });"
},
"getauthorizationroles": {
@@ -8117,18 +8127,13 @@
"getcontentmanagementsharedsharedid": {
"operationId": "getcontentmanagementsharedsharedid",
"functionName": "getContentmanagementSharedSharedId",
- "signature": "getContentmanagementSharedSharedId(sharedId, redirect, disposition, contentType, expand)",
+ "signature": "getContentmanagementSharedSharedId(sharedId, disposition, contentType, expand)",
"parameters": [
{
"name": "sharedId",
"type": "String",
"required": "true"
},
- {
- "name": "redirect",
- "type": "Boolean",
- "required": "false"
- },
{
"name": "disposition",
"type": "String",
@@ -8146,7 +8151,7 @@
}
],
"return": "SharedResponse",
- "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ContentManagementApi();\n\nlet sharedId = \"sharedId_example\"; // String | Shared ID\nlet opts = { \n \"redirect\": true, // Boolean | Turn on or off redirect\n \"disposition\": \"attachment\", // String | Request how the share content will be downloaded: attached as a file or inline. Default is attachment.\n \"contentType\": \"contentType_example\", // String | The requested format for the specified document. If supported, the document will be returned in that format. Example contentType=audio/wav\n \"expand\": \"expand_example\" // String | Expand some document fields\n};\n\n// Get shared documents. Securely download a shared document.\napiInstance.getContentmanagementSharedSharedId(sharedId, opts)\n .then((data) => {\n console.log(`getContentmanagementSharedSharedId success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getContentmanagementSharedSharedId\");\n console.error(err);\n });"
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ContentManagementApi();\n\nlet sharedId = \"sharedId_example\"; // String | Shared ID\nlet opts = { \n \"disposition\": \"attachment\", // String | Request how the share content will be downloaded: attached as a file or inline. Default is attachment.\n \"contentType\": \"contentType_example\", // String | The requested format for the specified document. If supported, the document will be returned in that format. Example contentType=audio/wav\n \"expand\": \"expand_example\" // String | Expand some document fields\n};\n\n// Get shared documents. Securely download a shared document.\napiInstance.getContentmanagementSharedSharedId(sharedId, opts)\n .then((data) => {\n console.log(`getContentmanagementSharedSharedId success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getContentmanagementSharedSharedId\");\n console.error(err);\n });"
},
"getcontentmanagementshares": {
"operationId": "getcontentmanagementshares",
@@ -13305,6 +13310,19 @@
"return": "Object",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet externalSourceId = \"externalSourceId_example\"; // String | External Source ID\n\n// Delete an External Source. WARNING: Any records that reference this External Source will not be automatically cleaned up. Those records will still be editable, but their External IDs may not be fully viewable.\napiInstance.deleteExternalcontactsExternalsource(externalSourceId)\n .then((data) => {\n console.log(`deleteExternalcontactsExternalsource success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling deleteExternalcontactsExternalsource\");\n console.error(err);\n });"
},
+ "deleteexternalcontactsimportcsvsetting": {
+ "operationId": "deleteexternalcontactsimportcsvsetting",
+ "functionName": "deleteExternalcontactsImportCsvSetting",
+ "signature": "deleteExternalcontactsImportCsvSetting(settingsId)",
+ "parameters": [
+ {
+ "name": "settingsId",
+ "type": "String",
+ "required": "true"
+ }
+ ],
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet settingsId = \"settingsId_example\"; // String | Settings id\n\n// Delete settings for CSV import\napiInstance.deleteExternalcontactsImportCsvSetting(settingsId)\n .then(() => {\n console.log(\"deleteExternalcontactsImportCsvSetting returned successfully.\");\n })\n .catch((err) => {\n console.log(\"There was a failure calling deleteExternalcontactsImportCsvSetting\");\n console.error(err);\n });"
+ },
"deleteexternalcontactsorganization": {
"operationId": "deleteexternalcontactsorganization",
"functionName": "deleteExternalcontactsOrganization",
@@ -13635,6 +13653,72 @@
"return": "CursorExternalSourceListing",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet opts = { \n \"cursor\": \"cursor_example\", // String | Indicates where to resume query results (not required for first page), each page returns a new cursor with a 24h TTL\n \"limit\": 3.4, // Number | The number of ExternalSources per page; must be between 10 and 200, default is 100\n \"name\": \"name_example\", // String | Filter by external source name. Filtering is prefix filtering and not an exact match\n \"active\": true // Boolean | Filter by active status of external source\n};\n\n// Fetch a list of External Sources\napiInstance.getExternalcontactsExternalsources(opts)\n .then((data) => {\n console.log(`getExternalcontactsExternalsources success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getExternalcontactsExternalsources\");\n console.error(err);\n });"
},
+ "getexternalcontactsimportcsvsetting": {
+ "operationId": "getexternalcontactsimportcsvsetting",
+ "functionName": "getExternalcontactsImportCsvSetting",
+ "signature": "getExternalcontactsImportCsvSetting(settingsId)",
+ "parameters": [
+ {
+ "name": "settingsId",
+ "type": "String",
+ "required": "true"
+ }
+ ],
+ "return": "CsvSettings",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet settingsId = \"settingsId_example\"; // String | Settings id\n\n// Get settings for CSV import\napiInstance.getExternalcontactsImportCsvSetting(settingsId)\n .then((data) => {\n console.log(`getExternalcontactsImportCsvSetting success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getExternalcontactsImportCsvSetting\");\n console.error(err);\n });"
+ },
+ "getexternalcontactsimportcsvsettings": {
+ "operationId": "getexternalcontactsimportcsvsettings",
+ "functionName": "getExternalcontactsImportCsvSettings",
+ "signature": "getExternalcontactsImportCsvSettings(after, pageSize, externalSettingsId)",
+ "parameters": [
+ {
+ "name": "after",
+ "type": "String",
+ "required": "false"
+ },
+ {
+ "name": "pageSize",
+ "type": "String",
+ "required": "false"
+ },
+ {
+ "name": "externalSettingsId",
+ "type": "String",
+ "required": "false"
+ }
+ ],
+ "return": "Listing",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet opts = { \n \"after\": \"after_example\", // String | The cursor that points to the end of the set of entities that has been returned.\n \"pageSize\": \"pageSize_example\", // String | Number of entities to return. Maximum of 200.\n \"externalSettingsId\": \"externalSettingsId_example\" // String | External Settings Id to filter the list.\n};\n\n// Retrieve all settings for organization filtered by externalSettingsId if provided\napiInstance.getExternalcontactsImportCsvSettings(opts)\n .then((data) => {\n console.log(`getExternalcontactsImportCsvSettings success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getExternalcontactsImportCsvSettings\");\n console.error(err);\n });"
+ },
+ "getexternalcontactsimportcsvuploaddetails": {
+ "operationId": "getexternalcontactsimportcsvuploaddetails",
+ "functionName": "getExternalcontactsImportCsvUploadDetails",
+ "signature": "getExternalcontactsImportCsvUploadDetails(uploadId)",
+ "parameters": [
+ {
+ "name": "uploadId",
+ "type": "String",
+ "required": "true"
+ }
+ ],
+ "return": "CsvUploadDetailsResponse",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet uploadId = \"uploadId_example\"; // String | Upload id\n\n// Get details for CSV upload\napiInstance.getExternalcontactsImportCsvUploadDetails(uploadId)\n .then((data) => {\n console.log(`getExternalcontactsImportCsvUploadDetails success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getExternalcontactsImportCsvUploadDetails\");\n console.error(err);\n });"
+ },
+ "getexternalcontactsimportcsvuploadpreview": {
+ "operationId": "getexternalcontactsimportcsvuploadpreview",
+ "functionName": "getExternalcontactsImportCsvUploadPreview",
+ "signature": "getExternalcontactsImportCsvUploadPreview(uploadId)",
+ "parameters": [
+ {
+ "name": "uploadId",
+ "type": "String",
+ "required": "true"
+ }
+ ],
+ "return": "CsvUploadPreviewResponse",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet uploadId = \"uploadId_example\"; // String | Upload id\n\n// Get preview for CSV upload\napiInstance.getExternalcontactsImportCsvUploadPreview(uploadId)\n .then((data) => {\n console.log(`getExternalcontactsImportCsvUploadPreview success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getExternalcontactsImportCsvUploadPreview\");\n console.error(err);\n });"
+ },
"getexternalcontactsorganization": {
"operationId": "getexternalcontactsorganization",
"functionName": "getExternalcontactsOrganization",
@@ -14353,6 +14437,48 @@
"return": "ExternalContact",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet identifier = {}; // Object | \nlet opts = { \n \"expand\": [\"expand_example\"] // [String] | which field, if any, to expand\n};\n\n// Fetch a contact using an identifier type and value.\napiInstance.postExternalcontactsIdentifierlookup(identifier, opts)\n .then((data) => {\n console.log(`postExternalcontactsIdentifierlookup success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling postExternalcontactsIdentifierlookup\");\n console.error(err);\n });"
},
+ "postexternalcontactsimportcsvjobs": {
+ "operationId": "postexternalcontactsimportcsvjobs",
+ "functionName": "postExternalcontactsImportCsvJobs",
+ "signature": "postExternalcontactsImportCsvJobs(body)",
+ "parameters": [
+ {
+ "name": "body",
+ "type": "Object",
+ "required": "true"
+ }
+ ],
+ "return": "CsvJobResponse",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet body = {}; // Object | ImportRequest\n\n// Create CSV import job\napiInstance.postExternalcontactsImportCsvJobs(body)\n .then((data) => {\n console.log(`postExternalcontactsImportCsvJobs success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling postExternalcontactsImportCsvJobs\");\n console.error(err);\n });"
+ },
+ "postexternalcontactsimportcsvsettings": {
+ "operationId": "postexternalcontactsimportcsvsettings",
+ "functionName": "postExternalcontactsImportCsvSettings",
+ "signature": "postExternalcontactsImportCsvSettings(body)",
+ "parameters": [
+ {
+ "name": "body",
+ "type": "Object",
+ "required": "true"
+ }
+ ],
+ "return": "CsvSettings",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet body = {}; // Object | Settings\n\n// Create settings for CSV import\napiInstance.postExternalcontactsImportCsvSettings(body)\n .then((data) => {\n console.log(`postExternalcontactsImportCsvSettings success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling postExternalcontactsImportCsvSettings\");\n console.error(err);\n });"
+ },
+ "postexternalcontactsimportcsvuploads": {
+ "operationId": "postexternalcontactsimportcsvuploads",
+ "functionName": "postExternalcontactsImportCsvUploads",
+ "signature": "postExternalcontactsImportCsvUploads(body)",
+ "parameters": [
+ {
+ "name": "body",
+ "type": "Object",
+ "required": "true"
+ }
+ ],
+ "return": "CsvUploadResponse",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet body = {}; // Object | UploadRequest\n\n// Get url for CSV upload\napiInstance.postExternalcontactsImportCsvUploads(body)\n .then((data) => {\n console.log(`postExternalcontactsImportCsvUploads success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling postExternalcontactsImportCsvUploads\");\n console.error(err);\n });"
+ },
"postexternalcontactsmergecontacts": {
"operationId": "postexternalcontactsmergecontacts",
"functionName": "postExternalcontactsMergeContacts",
@@ -14527,6 +14653,25 @@
"return": "ExternalSource",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet externalSourceId = \"externalSourceId_example\"; // String | External Source ID\nlet body = {}; // Object | External Source\n\n// Update an External Source\napiInstance.putExternalcontactsExternalsource(externalSourceId, body)\n .then((data) => {\n console.log(`putExternalcontactsExternalsource success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling putExternalcontactsExternalsource\");\n console.error(err);\n });"
},
+ "putexternalcontactsimportcsvsetting": {
+ "operationId": "putexternalcontactsimportcsvsetting",
+ "functionName": "putExternalcontactsImportCsvSetting",
+ "signature": "putExternalcontactsImportCsvSetting(settingsId, body)",
+ "parameters": [
+ {
+ "name": "settingsId",
+ "type": "String",
+ "required": "true"
+ },
+ {
+ "name": "body",
+ "type": "Object",
+ "required": "true"
+ }
+ ],
+ "return": "CsvSettings",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.ExternalContactsApi();\n\nlet settingsId = \"settingsId_example\"; // String | Settings id\nlet body = {}; // Object | Settings\n\n// Update settings for CSV import\napiInstance.putExternalcontactsImportCsvSetting(settingsId, body)\n .then((data) => {\n console.log(`putExternalcontactsImportCsvSetting success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling putExternalcontactsImportCsvSetting\");\n console.error(err);\n });"
+ },
"putexternalcontactsorganization": {
"operationId": "putexternalcontactsorganization",
"functionName": "putExternalcontactsOrganization",
@@ -21133,7 +21278,7 @@
"required": "false"
}
],
- "return": "DocumentVariation",
+ "return": "DocumentVariationResponse",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.KnowledgeApi();\n\nlet documentVariationId = \"documentVariationId_example\"; // String | Globally unique identifier for a document variation.\nlet documentId = \"documentId_example\"; // String | Globally unique identifier for a document.\nlet knowledgeBaseId = \"knowledgeBaseId_example\"; // String | Globally unique identifier for a knowledge base.\nlet opts = { \n \"documentState\": \"documentState_example\" // String | The state of the document.\n};\n\n// Get a variation for a document.\napiInstance.getKnowledgeKnowledgebaseDocumentVariation(documentVariationId, documentId, knowledgeBaseId, opts)\n .then((data) => {\n console.log(`getKnowledgeKnowledgebaseDocumentVariation success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getKnowledgeKnowledgebaseDocumentVariation\");\n console.error(err);\n });"
},
"getknowledgeknowledgebasedocumentvariations": {
@@ -21172,7 +21317,7 @@
"required": "false"
}
],
- "return": "DocumentVariationListing",
+ "return": "DocumentVariationResponseListing",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.KnowledgeApi();\n\nlet knowledgeBaseId = \"knowledgeBaseId_example\"; // String | Globally unique identifier for the knowledge base.\nlet documentId = \"documentId_example\"; // String | Globally unique identifier for the document.\nlet opts = { \n \"before\": \"before_example\", // String | The cursor that points to the start of the set of entities that has been returned.\n \"after\": \"after_example\", // String | The cursor that points to the end of the set of entities that has been returned.\n \"pageSize\": \"pageSize_example\", // String | Number of entities to return. Maximum of 200.\n \"documentState\": \"documentState_example\" // String | The state of the document.\n};\n\n// Get variations for a document.\napiInstance.getKnowledgeKnowledgebaseDocumentVariations(knowledgeBaseId, documentId, opts)\n .then((data) => {\n console.log(`getKnowledgeKnowledgebaseDocumentVariations success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getKnowledgeKnowledgebaseDocumentVariations\");\n console.error(err);\n });"
},
"getknowledgeknowledgebasedocumentversion": {
@@ -22266,7 +22411,7 @@
"required": "true"
}
],
- "return": "DocumentVariation",
+ "return": "DocumentVariationResponse",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.KnowledgeApi();\n\nlet documentVariationId = \"documentVariationId_example\"; // String | Globally unique identifier for a document variation.\nlet documentId = \"documentId_example\"; // String | Globally unique identifier for a document.\nlet knowledgeBaseId = \"knowledgeBaseId_example\"; // String | Globally unique identifier for a knowledge base.\nlet body = {}; // Object | \n\n// Update a variation for a document.\napiInstance.patchKnowledgeKnowledgebaseDocumentVariation(documentVariationId, documentId, knowledgeBaseId, body)\n .then((data) => {\n console.log(`patchKnowledgeKnowledgebaseDocumentVariation success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling patchKnowledgeKnowledgebaseDocumentVariation\");\n console.error(err);\n });"
},
"patchknowledgeknowledgebasedocumentssearchsearchid": {
@@ -22792,7 +22937,7 @@
"required": "true"
}
],
- "return": "DocumentVariation",
+ "return": "DocumentVariationResponse",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.KnowledgeApi();\n\nlet knowledgeBaseId = \"knowledgeBaseId_example\"; // String | Globally unique identifier for the knowledge base.\nlet documentId = \"documentId_example\"; // String | Globally unique identifier for the document.\nlet body = {}; // Object | \n\n// Create a variation for a document.\napiInstance.postKnowledgeKnowledgebaseDocumentVariations(knowledgeBaseId, documentId, body)\n .then((data) => {\n console.log(`postKnowledgeKnowledgebaseDocumentVariations success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling postKnowledgeKnowledgebaseDocumentVariations\");\n console.error(err);\n });"
},
"postknowledgeknowledgebasedocumentversions": {
@@ -26777,6 +26922,13 @@
"return": "TrustEntityListing",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.OrganizationAuthorizationApi();\n\nlet opts = { \n \"pageSize\": 25, // Number | Page size\n \"pageNumber\": 1 // Number | Page number\n};\n\n// The list of trustees for this organization (i.e. organizations granted access to this organization).\napiInstance.getOrgauthorizationTrustees(opts)\n .then((data) => {\n console.log(`getOrgauthorizationTrustees success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getOrgauthorizationTrustees\");\n console.error(err);\n });"
},
+ "getorgauthorizationtrusteescare": {
+ "operationId": "getorgauthorizationtrusteescare",
+ "functionName": "getOrgauthorizationTrusteesCare",
+ "signature": "getOrgauthorizationTrusteesCare()",
+ "return": "TrusteeReferenceList",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.OrganizationAuthorizationApi();\n\n// Get Customer Care organization ids.\napiInstance.getOrgauthorizationTrusteesCare()\n .then((data) => {\n console.log(`getOrgauthorizationTrusteesCare success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getOrgauthorizationTrusteesCare\");\n console.error(err);\n });"
+ },
"getorgauthorizationtrusteesdefault": {
"operationId": "getorgauthorizationtrusteesdefault",
"functionName": "getOrgauthorizationTrusteesDefault",
@@ -27036,6 +27188,35 @@
"return": "Object",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.OrganizationAuthorizationApi();\n\nlet body = {}; // Object | Values to scope the request.\nlet opts = { \n \"pageSize\": 25, // Number | Page size\n \"pageNumber\": 1, // Number | Page number\n \"sortBy\": \"timestamp\", // String | Sort by\n \"sortOrder\": \"descending\" // String | Sort order\n};\n\n// Get Org Trustee Audits\napiInstance.postOrgauthorizationTrusteesAudits(body, opts)\n .then((data) => {\n console.log(`postOrgauthorizationTrusteesAudits success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling postOrgauthorizationTrusteesAudits\");\n console.error(err);\n });"
},
+ "postorgauthorizationtrusteescare": {
+ "operationId": "postorgauthorizationtrusteescare",
+ "functionName": "postOrgauthorizationTrusteesCare",
+ "signature": "postOrgauthorizationTrusteesCare(assignDefaultRole, autoExpire, assignFullAccess, allowTrustedUserAccess)",
+ "parameters": [
+ {
+ "name": "assignDefaultRole",
+ "type": "Boolean",
+ "required": "false"
+ },
+ {
+ "name": "autoExpire",
+ "type": "Boolean",
+ "required": "false"
+ },
+ {
+ "name": "assignFullAccess",
+ "type": "Boolean",
+ "required": "false"
+ },
+ {
+ "name": "allowTrustedUserAccess",
+ "type": "Boolean",
+ "required": "false"
+ }
+ ],
+ "return": "TrustEntityListing",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.OrganizationAuthorizationApi();\n\nlet opts = { \n \"assignDefaultRole\": true, // Boolean | Assign Admin role to default pairing with Customer Care\n \"autoExpire\": true, // Boolean | Automatically expire pairing after 30 days\n \"assignFullAccess\": true, // Boolean | Grant Customer Care full access to the organization\n \"allowTrustedUserAccess\": true // Boolean | Make Customer Care a Trusted User\n};\n\n// Create a new organization authorization trust with Customer Care. This is required to grant your regional Customer Care organization access to your organization.\napiInstance.postOrgauthorizationTrusteesCare(opts)\n .then((data) => {\n console.log(`postOrgauthorizationTrusteesCare success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling postOrgauthorizationTrusteesCare\");\n console.error(err);\n });"
+ },
"postorgauthorizationtrusteesdefault": {
"operationId": "postorgauthorizationtrusteesdefault",
"functionName": "postOrgauthorizationTrusteesDefault",
@@ -29666,6 +29847,32 @@
"return": "ContactCallbackRequest",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.OutboundApi();\n\nlet campaignId = \"campaignId_example\"; // String | Campaign ID\nlet body = {}; // Object | ContactCallbackRequest\n\n// Schedule a Callback for a Dialer Campaign (Deprecated)\napiInstance.postOutboundCampaignCallbackSchedule(campaignId, body)\n .then((data) => {\n console.log(`postOutboundCampaignCallbackSchedule success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling postOutboundCampaignCallbackSchedule\");\n console.error(err);\n });"
},
+ "postoutboundcampaignstart": {
+ "operationId": "postoutboundcampaignstart",
+ "functionName": "postOutboundCampaignStart",
+ "signature": "postOutboundCampaignStart(campaignId)",
+ "parameters": [
+ {
+ "name": "campaignId",
+ "type": "String",
+ "required": "true"
+ }
+ ],
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.OutboundApi();\n\nlet campaignId = \"campaignId_example\"; // String | Campaign ID\n\n// Start the campaign\napiInstance.postOutboundCampaignStart(campaignId)\n .then(() => {\n console.log(\"postOutboundCampaignStart returned successfully.\");\n })\n .catch((err) => {\n console.log(\"There was a failure calling postOutboundCampaignStart\");\n console.error(err);\n });"
+ },
+ "postoutboundcampaignstop": {
+ "operationId": "postoutboundcampaignstop",
+ "functionName": "postOutboundCampaignStop",
+ "signature": "postOutboundCampaignStop(campaignId)",
+ "parameters": [
+ {
+ "name": "campaignId",
+ "type": "String",
+ "required": "true"
+ }
+ ],
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.OutboundApi();\n\nlet campaignId = \"campaignId_example\"; // String | Campaign ID\n\n// Stop the campaign\napiInstance.postOutboundCampaignStop(campaignId)\n .then(() => {\n console.log(\"postOutboundCampaignStop returned successfully.\");\n })\n .catch((err) => {\n console.log(\"There was a failure calling postOutboundCampaignStop\");\n console.error(err);\n });"
+ },
"postoutboundcampaignrules": {
"operationId": "postoutboundcampaignrules",
"functionName": "postOutboundCampaignrules",
@@ -30086,6 +30293,32 @@
"return": "ImportTemplateEntityListing",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.OutboundApi();\n\nlet body = [{}]; // Object | import template(s) to add\n\n// Add multiple import templates\napiInstance.postOutboundImporttemplatesBulkAdd(body)\n .then((data) => {\n console.log(`postOutboundImporttemplatesBulkAdd success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling postOutboundImporttemplatesBulkAdd\");\n console.error(err);\n });"
},
+ "postoutboundmessagingcampaignstart": {
+ "operationId": "postoutboundmessagingcampaignstart",
+ "functionName": "postOutboundMessagingcampaignStart",
+ "signature": "postOutboundMessagingcampaignStart(messagingCampaignId)",
+ "parameters": [
+ {
+ "name": "messagingCampaignId",
+ "type": "String",
+ "required": "true"
+ }
+ ],
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.OutboundApi();\n\nlet messagingCampaignId = \"messagingCampaignId_example\"; // String | The Messaging Campaign ID\n\n// Start the campaign\napiInstance.postOutboundMessagingcampaignStart(messagingCampaignId)\n .then(() => {\n console.log(\"postOutboundMessagingcampaignStart returned successfully.\");\n })\n .catch((err) => {\n console.log(\"There was a failure calling postOutboundMessagingcampaignStart\");\n console.error(err);\n });"
+ },
+ "postoutboundmessagingcampaignstop": {
+ "operationId": "postoutboundmessagingcampaignstop",
+ "functionName": "postOutboundMessagingcampaignStop",
+ "signature": "postOutboundMessagingcampaignStop(messagingCampaignId)",
+ "parameters": [
+ {
+ "name": "messagingCampaignId",
+ "type": "String",
+ "required": "true"
+ }
+ ],
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.OutboundApi();\n\nlet messagingCampaignId = \"messagingCampaignId_example\"; // String | The Messaging Campaign ID\n\n// Stop the campaign\napiInstance.postOutboundMessagingcampaignStop(messagingCampaignId)\n .then(() => {\n console.log(\"postOutboundMessagingcampaignStop returned successfully.\");\n })\n .catch((err) => {\n console.log(\"There was a failure calling postOutboundMessagingcampaignStop\");\n console.error(err);\n });"
+ },
"postoutboundmessagingcampaigns": {
"operationId": "postoutboundmessagingcampaigns",
"functionName": "postOutboundMessagingcampaigns",
@@ -40294,16 +40527,21 @@
"getteam": {
"operationId": "getteam",
"functionName": "getTeam",
- "signature": "getTeam(teamId)",
+ "signature": "getTeam(teamId, expand)",
"parameters": [
{
"name": "teamId",
"type": "String",
"required": "true"
+ },
+ {
+ "name": "expand",
+ "type": "String",
+ "required": "false"
}
],
"return": "Team",
- "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.TeamsApi();\n\nlet teamId = \"teamId_example\"; // String | Team ID\n\n// Get team\napiInstance.getTeam(teamId)\n .then((data) => {\n console.log(`getTeam success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getTeam\");\n console.error(err);\n });"
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.TeamsApi();\n\nlet teamId = \"teamId_example\"; // String | Team ID\nlet opts = { \n \"expand\": \"expand_example\" // String | Expand the division name\n};\n\n// Get team\napiInstance.getTeam(teamId, opts)\n .then((data) => {\n console.log(`getTeam success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getTeam\");\n console.error(err);\n });"
},
"getteammembers": {
"operationId": "getteammembers",
@@ -43808,6 +44046,30 @@
"return": "UserEntityListing",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.UsersApi();\n\nlet opts = { \n \"pageSize\": 25, // Number | Page size\n \"pageNumber\": 1, // Number | Page number\n \"id\": [\"id_example\"], // [String] | A list of user IDs to fetch by bulk\n \"jabberId\": [\"jabberId_example\"], // [String] | A list of jabberIds to fetch by bulk (cannot be used with the id parameter)\n \"sortOrder\": \"ASC\", // String | Ascending or descending sort order\n \"expand\": [\"expand_example\"], // [String] | Which fields, if any, to expand. Note, expand parameters are resolved with a best effort approach and not guaranteed to be returned. If requested expand information is absolutely required, it's recommended to use specific API requests instead.\n \"integrationPresenceSource\": \"integrationPresenceSource_example\", // String | Gets an integration presence for users instead of their defaults. This parameter will only be used when presence is provided as an expand. When using this parameter the maximum number of users that can be returned is 100.\n \"state\": \"active\" // String | Only list users of this state\n};\n\n// Get the list of available users.\napiInstance.getUsers(opts)\n .then((data) => {\n console.log(`getUsers success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getUsers\");\n console.error(err);\n });"
},
+ "getuserschatsme": {
+ "operationId": "getuserschatsme",
+ "functionName": "getUsersChatsMe",
+ "signature": "getUsersChatsMe(excludeClosed, includePresence, after)",
+ "parameters": [
+ {
+ "name": "excludeClosed",
+ "type": "Boolean",
+ "required": "false"
+ },
+ {
+ "name": "includePresence",
+ "type": "Boolean",
+ "required": "false"
+ },
+ {
+ "name": "after",
+ "type": "String",
+ "required": "false"
+ }
+ ],
+ "return": "ChatItemCursorListing",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.UsersApi();\n\nlet opts = { \n \"excludeClosed\": true, // Boolean | Whether or not to exclude closed chats\n \"includePresence\": true, // Boolean | Whether or not to include user presence\n \"after\": \"after_example\" // String | The key to start after\n};\n\n// Get chats for a user\napiInstance.getUsersChatsMe(opts)\n .then((data) => {\n console.log(`getUsersChatsMe success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getUsersChatsMe\");\n console.error(err);\n });"
+ },
"getusersdevelopmentactivities": {
"operationId": "getusersdevelopmentactivities",
"functionName": "getUsersDevelopmentActivities",
@@ -44528,6 +44790,44 @@
"return": "VoicemailMessageEntityListing",
"example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.VoicemailApi();\n\nlet queueId = \"queueId_example\"; // String | Queue ID\nlet opts = { \n \"pageSize\": 25, // Number | Page size\n \"pageNumber\": 1 // Number | Page number\n};\n\n// List voicemail messages\napiInstance.getVoicemailQueueMessages(queueId, opts)\n .then((data) => {\n console.log(`getVoicemailQueueMessages success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getVoicemailQueueMessages\");\n console.error(err);\n });"
},
+ "getvoicemailusermailbox": {
+ "operationId": "getvoicemailusermailbox",
+ "functionName": "getVoicemailUserMailbox",
+ "signature": "getVoicemailUserMailbox(userId)",
+ "parameters": [
+ {
+ "name": "userId",
+ "type": "String",
+ "required": "true"
+ }
+ ],
+ "return": "VoicemailMailboxInfo",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.VoicemailApi();\n\nlet userId = \"userId_example\"; // String | userId\n\n// Get a user's mailbox information\napiInstance.getVoicemailUserMailbox(userId)\n .then((data) => {\n console.log(`getVoicemailUserMailbox success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getVoicemailUserMailbox\");\n console.error(err);\n });"
+ },
+ "getvoicemailusermessages": {
+ "operationId": "getvoicemailusermessages",
+ "functionName": "getVoicemailUserMessages",
+ "signature": "getVoicemailUserMessages(userId, pageSize, pageNumber)",
+ "parameters": [
+ {
+ "name": "userId",
+ "type": "String",
+ "required": "true"
+ },
+ {
+ "name": "pageSize",
+ "type": "Number",
+ "required": "false"
+ },
+ {
+ "name": "pageNumber",
+ "type": "Number",
+ "required": "false"
+ }
+ ],
+ "return": "VoicemailMessageEntityListing",
+ "example": "const platformClient = require(\"purecloud-platform-client-v2\");\n\nconst client = platformClient.ApiClient.instance;\nclient.setEnvironment(platformClient.PureCloudRegionHosts.us_east_1); // Genesys Cloud region\n\n// Manually set auth token or use loginImplicitGrant(...) or loginClientCredentialsGrant(...) or loginPKCEGrant(...)\nclient.setAccessToken(\"your_access_token\");\n\nlet apiInstance = new platformClient.VoicemailApi();\n\nlet userId = \"userId_example\"; // String | User ID\nlet opts = { \n \"pageSize\": 25, // Number | Page size\n \"pageNumber\": 1 // Number | Page number\n};\n\n// List voicemail messages\napiInstance.getVoicemailUserMessages(userId, opts)\n .then((data) => {\n console.log(`getVoicemailUserMessages success! data: ${JSON.stringify(data, null, 2)}`);\n })\n .catch((err) => {\n console.log(\"There was a failure calling getVoicemailUserMessages\");\n console.error(err);\n });"
+ },
"getvoicemailuserpolicy": {
"operationId": "getvoicemailuserpolicy",
"functionName": "getVoicemailUserpolicy",
diff --git a/build/README.md b/build/README.md
index b1c18b87b..7593784b9 100644
--- a/build/README.md
+++ b/build/README.md
@@ -6,7 +6,7 @@ A JavaScript library to interface with the Genesys Cloud Platform API. View the
[![npm](https://img.shields.io/npm/v/purecloud-platform-client-v2.svg)](https://www.npmjs.com/package/purecloud-platform-client-v2)
[![Release Notes Badge](https://developer-content.genesys.cloud/images/sdk-release-notes.png)](https://github.com/MyPureCloud/platform-client-sdk-javascript/blob/master/releaseNotes.md)
-Documentation version purecloud-platform-client-v2@206.0.0
+Documentation version purecloud-platform-client-v2@207.0.0
## Preview APIs
@@ -29,7 +29,7 @@ For direct use in a browser script:
```html
-
+
@@ -346,6 +346,79 @@ JSON:
}
```
+The Genesys Cloud Login and API URL path can be overridden if necessary (i.e. if the Genesys Cloud requests must be sent through to an intermediate API gateway or equivalent).
+
+This can be achieved defining a "gateway" configuration, in the INI or the JSON configuration file.
+
+* "host" is the address of your gateway.
+* "protocol" is not mandatory. It will default to "https" if the parameter is not defined or empty.
+* "port" is not mandatory. This parameter can be defined if a non default port is used and needs to be specified in the url (value must be greater or equal to 0).
+* "path_params_login" and "path_params_api" are not mandatory. They will be appended to the gateway url path if these parameters are defined and non empty (for Login requests and for API requests).
+* "username" and "password" are not used at this stage. This is for a possible future use.
+
+With the configuration below, this would result in:
+
+* Login requests to: "https://mygateway.mydomain.myextension:1443/myadditionalpathforlogin" (e.g. "https://mygateway.mydomain.myextension:1443/myadditionalpathforlogin/oauth/token")
+* API requests to: "https://mygateway.mydomain.myextension:1443/myadditionalpathforapi" (e.g. "https://mygateway.mydomain.myextension:1443/myadditionalpathforlogin/api/v2/users/me")
+
+INI:
+
+```ini
+[logging]
+log_level = trace
+log_format = text
+log_to_console = false
+log_file_path = /var/log/javascriptsdk.log
+log_response_body = false
+log_request_body = false
+[reauthentication]
+refresh_access_token = true
+refresh_token_wait_max = 10
+[general]
+live_reload_config = true
+host = https://api.mypurecloud.com
+[gateway]
+host = mygateway.mydomain.myextension
+protocol = https
+port = 1443
+path_params_login = myadditionalpathforlogin
+path_params_api = myadditionalpathforapi
+username = username
+password = password
+```
+
+JSON:
+
+```json
+{
+ "logging": {
+ "log_level": "trace",
+ "log_format": "text",
+ "log_to_console": false,
+ "log_file_path": "/var/log/javascriptsdk.log",
+ "log_response_body": false,
+ "log_request_body": false
+ },
+ "reauthentication": {
+ "refresh_access_token": true,
+ "refresh_token_wait_max": 10
+ },
+ "general": {
+ "live_reload_config": true,
+ "host": "https://api.mypurecloud.com"
+ },
+ "gateway": {
+ "host": "mygateway.mydomain.myextension",
+ "protocol": "https",
+ "port": 1443,
+ "path_params_login": "myadditionalpathforlogin",
+ "path_params_api": "myadditionalpathforapi",
+ "username": "username",
+ "password": "password"
+ }
+}
+```
+
## Environments
If connecting to a Genesys Cloud environment other than mypurecloud.com (e.g. mypurecloud.ie), set the environment on the `ApiClient` instance with the PureCloudRegionHosts object.
@@ -355,6 +428,30 @@ const client = platformClient.ApiClient.instance;
client.setEnvironment(platformClient.PureCloudRegionHosts.eu_west_1);
```
+### Setting an intermediate Gateway
+
+The Genesys Cloud Login and API URL path can be overridden if necessary (i.e. if the Genesys Cloud requests must be sent through to an intermediate API gateway or equivalent).
+
+This can be achieved setting the gateway configuration on the `ApiClient` instance.
+
+```javascript
+const client = platformClient.ApiClient.instance;
+client.setGateway({host: 'mygateway.mydomain.myextension', protocol: 'https', port: 1443, path_params_login: 'myadditionalpathforlogin', path_params_api: 'myadditionalpathforapi'});
+
+// If you need, you can later remove the Gateway Configuration and fallback to the Enviroment setting using: client.setGateway();
+```
+
+* "host" is the address of your gateway.
+* "protocol" is not mandatory. It will default to "https" if the parameter is not defined or empty.
+* "port" is not mandatory. This parameter can be defined if a non default port is used and needs to be specified in the url (value must be greater or equal to 0).
+* "path_params_login" and "path_params_api" are not mandatory. They will be appended to the gateway url path if these parameters are defined and non empty (for Login requests and for API requests).
+* "username" and "password" are not used at this stage. This is for a possible future use.
+
+With the configuration below, this would result in:
+
+* Login requests to: "https://mygateway.mydomain.myextension:1443/myadditionalpathforlogin" (e.g. "https://mygateway.mydomain.myextension:1443/myadditionalpathforlogin/oauth/token")
+* API requests to: "https://mygateway.mydomain.myextension:1443/myadditionalpathforapi" (e.g. "https://mygateway.mydomain.myextension:1443/myadditionalpathforlogin/api/v2/users/me")
+
## Access Token persistence
diff --git a/build/dist/node/purecloud-platform-client-v2.js b/build/dist/node/purecloud-platform-client-v2.js
index 74618a853..5110bfd1a 100644
--- a/build/dist/node/purecloud-platform-client-v2.js
+++ b/build/dist/node/purecloud-platform-client-v2.js
@@ -262,6 +262,7 @@ class Configuration {
this.basePath;
this.authUrl;
this.config;
+ this.gateway = undefined;
this.logger = new Logger();
this.setEnvironment();
this.liveLoadConfig();
@@ -359,12 +360,72 @@ class Configuration {
: this.live_reload_config;
this.host = this.getConfigString('general', 'host') !== undefined ? this.getConfigString('general', 'host') : this.host;
+ if (this.getConfigString('gateway', 'host') !== undefined) {
+ let gateway = {
+ host: this.getConfigString('gateway', 'host')
+ };
+ if (this.getConfigString('gateway', 'protocol') !== undefined) gateway.protocol = this.getConfigString('gateway', 'protocol');
+ if (this.getConfigInt('gateway', 'port') !== undefined) gateway.port = this.getConfigInt('gateway', 'port');
+ if (this.getConfigString('gateway', 'path_params_login') !== undefined) gateway.path_params_login = this.getConfigString('gateway', 'path_params_login');
+ if (this.getConfigString('gateway', 'path_params_api') !== undefined) gateway.path_params_api = this.getConfigString('gateway', 'path_params_api');
+ if (this.getConfigString('gateway', 'username') !== undefined) gateway.username = this.getConfigString('gateway', 'username');
+ if (this.getConfigString('gateway', 'password') !== undefined) gateway.password = this.getConfigString('gateway', 'password');
+ this.setGateway(gateway);
+ } else {
+ this.setGateway();
+ }
+
this.setEnvironment();
// Update logging configs
this.logger.setLogger();
}
+ /**
+ * @description Sets the gateway used by the session
+ * @param {object} gateway - Gateway Configuration interface
+ * @param {string} gateway.host - The address of the gateway.
+ * @param {string} gateway.protocol - (optional) The protocol to use. It will default to "https" if the parameter is not defined or empty.
+ * @param {number} gateway.port - (optional) The port to target. This parameter can be defined if a non default port is used and needs to be specified in the url (value must be greater or equal to 0).
+ * @param {string} gateway.path_params_login - (optional) An arbitrary string to be appended to the gateway url path for Login requests.
+ * @param {string} gateway.path_params_api - (optional) An arbitrary string to be appended to the gateway url path for API requests.
+ * @param {string} gateway.username - (optional) Not used at this stage (for a possible future use).
+ * @param {string} gateway.password - (optional) Not used at this stage (for a possible future use).
+ */
+ setGateway(gateway) {
+ if (gateway) {
+ this.gateway = {
+ host: ''
+ };
+
+ if (gateway.protocol) this.gateway.protocol = gateway.protocol;
+ else this.gateway.protocol = 'https';
+
+ if (gateway.host) this.gateway.host = gateway.host;
+ else this.gateway.host = '';
+
+ if (gateway.port && gateway.port > -1) this.gateway.port = gateway.port;
+ else this.gateway.port = -1;
+
+ if (gateway.path_params_login) {
+ this.gateway.path_params_login = gateway.path_params_login;
+ // Strip trailing slash
+ this.gateway.path_params_login = this.gateway.path_params_login.replace(/\/+$/, '');
+ } else this.gateway.path_params_login = '';
+
+ if (gateway.path_params_api) {
+ this.gateway.path_params_api = gateway.path_params_api;
+ // Strip trailing slash
+ this.gateway.path_params_api = this.gateway.path_params_api.replace(/\/+$/, '');
+ } else this.gateway.path_params_api = '';
+
+ if (gateway.username) this.gateway.username = gateway.username;
+ if (gateway.password) this.gateway.password = gateway.password;
+ } else {
+ this.gateway = undefined;
+ }
+ }
+
setEnvironment(env) {
// Default value
if (env) this.environment = env;
@@ -382,6 +443,26 @@ class Configuration {
this.authUrl = `https://login.${this.environment}`;
}
+ getConfUrl(pathType, regionUrl) {
+ if (!this.gateway) return regionUrl;
+ if (!this.gateway.host) return regionUrl;
+
+ var url = this.gateway.protocol + '://' + this.gateway.host;
+ if (this.gateway.port > -1) url = url + ':' + this.gateway.port.toString();
+ if (pathType === 'login') {
+ if (this.gateway.path_params_login) {
+ if (this.gateway.path_params_login.startsWith('/')) url = url + this.gateway.path_params_login;
+ else url = url + '/' + this.gateway.path_params_login;
+ }
+ } else {
+ if (this.gateway.path_params_api) {
+ if (this.gateway.path_params_api.startsWith('/')) url = url + this.gateway.path_params_api;
+ else url = url + '/' + this.gateway.path_params_api;
+ }
+ }
+ return url;
+ }
+
getConfigString(section, key) {
if (this.config._sections[section]) return this.config._sections[section][key];
}
@@ -405,7 +486,7 @@ class Configuration {
/**
* @module purecloud-platform-client-v2/ApiClient
- * @version 206.0.0
+ * @version 207.0.0
*/
class ApiClient {
/**
@@ -603,6 +684,21 @@ class ApiClient {
this.config.setEnvironment(environment);
}
+ /**
+ * @description Sets the gateway used by the session
+ * @param {object} gateway - Gateway Configuration interface
+ * @param {string} gateway.host - The address of the gateway.
+ * @param {string} gateway.protocol - (optional) The protocol to use. It will default to "https" if the parameter is not defined or empty.
+ * @param {string} gateway.port - (optional) The port to target. This parameter can be defined if a non default port is used and needs to be specified in the url (value must be greater than 0).
+ * @param {string} gateway.path_params_login - (optional) An arbitrary string to be appended to the gateway url path for Login requests.
+ * @param {string} gateway.path_params_api - (optional) An arbitrary string to be appended to the gateway url path for API requests.
+ * @param {string} gateway.username - (optional) Not used at this stage (for a possible future use).
+ * @param {string} gateway.password - (optional) Not used at this stage (for a possible future use).
+ */
+ setGateway(gateway) {
+ this.config.setGateway(gateway);
+ }
+
/**
* @description Initiates the implicit grant login flow. Will attempt to load the token from local storage, if enabled.
* @param {string} clientId - The client ID of an OAuth Implicit Grant client
@@ -667,6 +763,7 @@ class ApiClient {
loginClientCredentialsGrant(clientId, clientSecret) {
this.clientId = clientId;
var authHeader = Buffer.from(`${clientId}:${clientSecret}`).toString('base64');
+ var loginBasePath = this.config.getConfUrl('login', `https://login.${this.config.environment}`);
return new Promise((resolve, reject) => {
// Block browsers from using client credentials
@@ -679,7 +776,7 @@ class ApiClient {
};
axios__default["default"]({
method: `POST`,
- url: `https://login.${this.config.environment}/oauth/token`,
+ url: `${loginBasePath}/oauth/token`,
headers: headers,
data: 'grant_type=client_credentials',
httpsAgent: this.proxyAgent
@@ -690,7 +787,7 @@ class ApiClient {
'trace',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
headers,
response.headers,
{ grant_type: 'client_credentials' },
@@ -700,7 +797,7 @@ class ApiClient {
'debug',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
headers,
undefined,
{ grant_type: 'client_credentials' },
@@ -724,7 +821,7 @@ class ApiClient {
'error',
error.response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
headers,
error.response.headers,
{ grant_type: 'client_credentials' },
@@ -745,6 +842,7 @@ class ApiClient {
*/
loginSaml2BearerGrant(clientId, clientSecret, orgName, assertion) {
this.clientId = clientId;
+ var loginBasePath = this.config.getConfUrl('login', `https://login.${this.config.environment}`);
return new Promise((resolve, reject) => {
if (typeof window !== 'undefined') {
reject(new Error('The saml2bearer grant is not supported in a browser.'));
@@ -770,7 +868,7 @@ class ApiClient {
'trace',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
response.headers,
bodyParam,
@@ -780,7 +878,7 @@ class ApiClient {
'debug',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
undefined,
bodyParam,
@@ -804,7 +902,7 @@ class ApiClient {
'error',
error.response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
error.response.headers,
bodyParam,
@@ -825,10 +923,11 @@ class ApiClient {
*/
authorizePKCEGrant(clientId, codeVerifier, authCode, redirectUri) {
this.clientId = clientId;
+ var loginBasePath = this.config.getConfUrl('login', `https://login.${this.config.environment}`);
return new Promise((resolve, reject) => {
var request = axios__default["default"]({
method: `POST`,
- url: `https://login.${this.config.environment}/oauth/token`,
+ url: `${loginBasePath}/oauth/token`,
headers: {
'Content-Type': 'application/x-www-form-urlencoded'
},
@@ -855,7 +954,7 @@ class ApiClient {
'trace',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
response.headers,
bodyParam,
@@ -865,7 +964,7 @@ class ApiClient {
'debug',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
undefined,
bodyParam,
@@ -889,7 +988,7 @@ class ApiClient {
'error',
error.response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
error.response.headers,
bodyParam,
@@ -1213,6 +1312,8 @@ class ApiClient {
* @param {function} reject - Promise reject callback
*/
_handleCodeAuthorizationResponse(request, bodyParam, resolve, reject) {
+ var loginBasePath = this.config.getConfUrl('login', `https://login.${this.config.environment}`);
+
request
.then((response) => {
// Logging
@@ -1220,7 +1321,7 @@ class ApiClient {
'trace',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
response.headers,
bodyParam,
@@ -1230,7 +1331,7 @@ class ApiClient {
'debug',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
undefined,
bodyParam,
@@ -1256,7 +1357,7 @@ class ApiClient {
'error',
error.response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
error.response.headers,
bodyParam,
@@ -1274,9 +1375,10 @@ class ApiClient {
* @param {object} data - data to url form encode
*/
_formAuthRequest(encodedData, data) {
+ var loginBasePath = this.config.getConfUrl('login', `https://login.${this.config.environment}`);
var request = axios__default["default"]({
method: `POST`,
- url: `https://login.${this.config.environment}/oauth/token`,
+ url: `${loginBasePath}/oauth/token`,
headers: {
'Authorization': 'Basic ' + encodedData,
'Content-Type': 'application/x-www-form-urlencoded'
@@ -1465,7 +1567,8 @@ class ApiClient {
*/
_buildAuthUrl(path, query) {
if (!query) query = {};
- return Object.keys(query).reduce((url, key) => !query[key] ? url : `${url}&${key}=${query[key]}`, `${this.config.authUrl}/${path}?`);
+ var loginBasePath = this.config.getConfUrl('login', this.config.authUrl);
+ return Object.keys(query).reduce((url, key) => !query[key] ? url : `${url}&${key}=${query[key]}`, `${loginBasePath}/${path}?`);
}
/**
@@ -1527,7 +1630,7 @@ class ApiClient {
if (!path.match(/^\//)) {
path = `/${path}`;
}
- var url = this.config.basePath + path;
+ var url = this.config.getConfUrl('api', this.config.basePath) + path;
url = url.replace(/\{([\w-]+)\}/g, (fullMatch, key) => {
var value;
if (pathParams.hasOwnProperty(key)) {
@@ -1827,7 +1930,7 @@ class AgentAssistantsApi {
/**
* AgentAssistants service.
* @module purecloud-platform-client-v2/api/AgentAssistantsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -2203,7 +2306,7 @@ class AgentCopilotApi {
/**
* AgentCopilot service.
* @module purecloud-platform-client-v2/api/AgentCopilotApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -2279,7 +2382,7 @@ class AgentUIApi {
/**
* AgentUI service.
* @module purecloud-platform-client-v2/api/AgentUIApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -2410,7 +2513,7 @@ class AlertingApi {
/**
* Alerting service.
* @module purecloud-platform-client-v2/api/AlertingApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -3071,7 +3174,7 @@ class AnalyticsApi {
/**
* Analytics service.
* @module purecloud-platform-client-v2/api/AnalyticsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -3922,6 +4025,7 @@ class AnalyticsApi {
* @param {Number} opts.pageSize (default to 25)
* @param {Array.} opts.id A list of user IDs to fetch by bulk
* @param {Object} opts.state Only list users of this state
+ * @param {Boolean} opts.deletedOnly Only list deleted dashboards that are still recoverable
*/
getAnalyticsReportingDashboardsUsers(opts) {
opts = opts || {};
@@ -3931,7 +4035,7 @@ class AnalyticsApi {
'/api/v2/analytics/reporting/dashboards/users',
'GET',
{ },
- { 'sortBy': opts['sortBy'],'pageNumber': opts['pageNumber'],'pageSize': opts['pageSize'],'id': this.apiClient.buildCollectionParam(opts['id'], 'multi'),'state': opts['state'] },
+ { 'sortBy': opts['sortBy'],'pageNumber': opts['pageNumber'],'pageSize': opts['pageSize'],'id': this.apiClient.buildCollectionParam(opts['id'], 'multi'),'state': opts['state'],'deletedOnly': opts['deletedOnly'] },
{ },
{ },
null,
@@ -4053,6 +4157,7 @@ class AnalyticsApi {
* @param {Number} opts.pageSize (default to 50)
* @param {Boolean} opts.publicOnly If true, retrieve only public dashboards
* @param {Boolean} opts.favoriteOnly If true, retrieve only favorite dashboards
+ * @param {Boolean} opts.deletedOnly If true, retrieve only deleted dashboards that are still recoverable
* @param {String} opts.name retrieve dashboards that match with given name
*/
getAnalyticsReportingSettingsUserDashboards(userId, opts) {
@@ -4067,7 +4172,7 @@ class AnalyticsApi {
'/api/v2/analytics/reporting/settings/users/{userId}/dashboards',
'GET',
{ 'userId': userId },
- { 'sortBy': opts['sortBy'],'pageNumber': opts['pageNumber'],'pageSize': opts['pageSize'],'publicOnly': opts['publicOnly'],'favoriteOnly': opts['favoriteOnly'],'name': opts['name'] },
+ { 'sortBy': opts['sortBy'],'pageNumber': opts['pageNumber'],'pageSize': opts['pageSize'],'publicOnly': opts['publicOnly'],'favoriteOnly': opts['favoriteOnly'],'deletedOnly': opts['deletedOnly'],'name': opts['name'] },
{ },
{ },
null,
@@ -5157,7 +5262,7 @@ class AnalyticsApi {
}
/**
- * Bulk delete dashboards owned by other user(s)
+ * Bulk soft delete dashboards owned by other user(s)
*
* @param {Array.} body List of userIds
*/
@@ -5207,7 +5312,7 @@ class AnalyticsApi {
}
/**
- * Bulk remove dashboard configurations
+ * Bulk soft delete dashboard configurations
*
* @param {Object} body
*/
@@ -5393,7 +5498,6 @@ class AnalyticsApi {
* Query for task management aggregates
*
* @param {Object} body query
- * postAnalyticsTaskmanagementAggregatesQuery is a preview method and is subject to both breaking and non-breaking changes at any time without notice
*/
postAnalyticsTaskmanagementAggregatesQuery(body) {
// verify the required parameter 'body' is set
@@ -5683,7 +5787,7 @@ class ArchitectApi {
/**
* Architect service.
* @module purecloud-platform-client-v2/api/ArchitectApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -7428,7 +7532,7 @@ class ArchitectApi {
}
/**
- * Create flow version configuration
+ * Get flow version configuration
*
* @param {String} flowId Flow ID
* @param {String} versionId Version ID
@@ -9805,7 +9909,7 @@ class AuditApi {
/**
* Audit service.
* @module purecloud-platform-client-v2/api/AuditApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -10006,7 +10110,7 @@ class AuthorizationApi {
/**
* Authorization service.
* @module purecloud-platform-client-v2/api/AuthorizationApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -11289,7 +11393,7 @@ class BillingApi {
/**
* Billing service.
* @module purecloud-platform-client-v2/api/BillingApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -11369,7 +11473,7 @@ class CarrierServicesApi {
/**
* CarrierServices service.
* @module purecloud-platform-client-v2/api/CarrierServicesApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -11439,7 +11543,7 @@ class ChatApi {
/**
* Chat service.
* @module purecloud-platform-client-v2/api/ChatApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -12375,7 +12479,7 @@ class CoachingApi {
/**
* Coaching service.
* @module purecloud-platform-client-v2/api/CoachingApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -12952,7 +13056,7 @@ class ContentManagementApi {
/**
* ContentManagement service.
* @module purecloud-platform-client-v2/api/ContentManagementApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -13341,7 +13445,6 @@ class ContentManagementApi {
* This method requires the download sharing URI obtained in the get document response (downloadSharingUri). Documents may be shared between users in the same workspace. Documents may also be shared between any user by creating a content management share.
* @param {String} sharedId Shared ID
* @param {Object} opts Optional parameters
- * @param {Boolean} opts.redirect Turn on or off redirect (default to true)
* @param {Object} opts.disposition Request how the share content will be downloaded: attached as a file or inline. Default is attachment. (default to attachment)
* @param {String} opts.contentType The requested format for the specified document. If supported, the document will be returned in that format. Example contentType=audio/wav
* @param {Object} opts.expand Expand some document fields
@@ -13358,7 +13461,7 @@ class ContentManagementApi {
'/api/v2/contentmanagement/shared/{sharedId}',
'GET',
{ 'sharedId': sharedId },
- { 'redirect': opts['redirect'],'disposition': opts['disposition'],'contentType': opts['contentType'],'expand': opts['expand'] },
+ { 'disposition': opts['disposition'],'contentType': opts['contentType'],'expand': opts['expand'] },
{ },
{ },
null,
@@ -14034,7 +14137,7 @@ class ConversationsApi {
/**
* Conversations service.
* @module purecloud-platform-client-v2/api/ConversationsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -18727,9 +18830,10 @@ class ConversationsApi {
/**
* Suggestion feedback.
- *
+ * Google Agent Assist offering within Genesys will no longer be supported
* @param {String} conversationId Conversation ID
* @param {Object} body SuggestionFeedback
+ * @deprecated
*/
postConversationSuggestionsFeedback(conversationId, body) {
// verify the required parameter 'conversationId' is set
@@ -21175,7 +21279,7 @@ class DataExtensionsApi {
/**
* DataExtensions service.
* @module purecloud-platform-client-v2/api/DataExtensionsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -21261,7 +21365,7 @@ class DownloadsApi {
/**
* Downloads service.
* @module purecloud-platform-client-v2/api/DownloadsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -21313,7 +21417,7 @@ class EmailsApi {
/**
* Emails service.
* @module purecloud-platform-client-v2/api/EmailsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -21378,7 +21482,7 @@ class EmployeeEngagementApi {
/**
* EmployeeEngagement service.
* @module purecloud-platform-client-v2/api/EmployeeEngagementApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -21529,7 +21633,7 @@ class EventsApi {
/**
* Events service.
* @module purecloud-platform-client-v2/api/EventsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -21625,7 +21729,7 @@ class ExternalContactsApi {
/**
* ExternalContacts service.
* @module purecloud-platform-client-v2/api/ExternalContactsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -21746,6 +21850,31 @@ class ExternalContactsApi {
);
}
+ /**
+ * Delete settings for CSV import
+ *
+ * @param {String} settingsId Settings id
+ */
+ deleteExternalcontactsImportCsvSetting(settingsId) {
+ // verify the required parameter 'settingsId' is set
+ if (settingsId === undefined || settingsId === null) {
+ throw 'Missing the required parameter "settingsId" when calling deleteExternalcontactsImportCsvSetting';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/settings/{settingsId}',
+ 'DELETE',
+ { 'settingsId': settingsId },
+ { },
+ { },
+ { },
+ null,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
/**
* Delete an external organization
*
@@ -22213,6 +22342,107 @@ class ExternalContactsApi {
);
}
+ /**
+ * Get settings for CSV import
+ *
+ * @param {String} settingsId Settings id
+ */
+ getExternalcontactsImportCsvSetting(settingsId) {
+ // verify the required parameter 'settingsId' is set
+ if (settingsId === undefined || settingsId === null) {
+ throw 'Missing the required parameter "settingsId" when calling getExternalcontactsImportCsvSetting';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/settings/{settingsId}',
+ 'GET',
+ { 'settingsId': settingsId },
+ { },
+ { },
+ { },
+ null,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
+ /**
+ * Retrieve all settings for organization filtered by externalSettingsId if provided
+ *
+ * @param {Object} opts Optional parameters
+ * @param {String} opts.after The cursor that points to the end of the set of entities that has been returned.
+ * @param {String} opts.pageSize Number of entities to return. Maximum of 200.
+ * @param {String} opts.externalSettingsId External Settings Id to filter the list.
+ */
+ getExternalcontactsImportCsvSettings(opts) {
+ opts = opts || {};
+
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/settings',
+ 'GET',
+ { },
+ { 'after': opts['after'],'pageSize': opts['pageSize'],'externalSettingsId': opts['externalSettingsId'] },
+ { },
+ { },
+ null,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
+ /**
+ * Get details for CSV upload
+ *
+ * @param {String} uploadId Upload id
+ */
+ getExternalcontactsImportCsvUploadDetails(uploadId) {
+ // verify the required parameter 'uploadId' is set
+ if (uploadId === undefined || uploadId === null) {
+ throw 'Missing the required parameter "uploadId" when calling getExternalcontactsImportCsvUploadDetails';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/uploads/{uploadId}/details',
+ 'GET',
+ { 'uploadId': uploadId },
+ { },
+ { },
+ { },
+ null,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
+ /**
+ * Get preview for CSV upload
+ *
+ * @param {String} uploadId Upload id
+ */
+ getExternalcontactsImportCsvUploadPreview(uploadId) {
+ // verify the required parameter 'uploadId' is set
+ if (uploadId === undefined || uploadId === null) {
+ throw 'Missing the required parameter "uploadId" when calling getExternalcontactsImportCsvUploadPreview';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/uploads/{uploadId}/preview',
+ 'GET',
+ { 'uploadId': uploadId },
+ { },
+ { },
+ { },
+ null,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
/**
* Fetch an external organization
*
@@ -23277,6 +23507,81 @@ class ExternalContactsApi {
);
}
+ /**
+ * Create CSV import job
+ *
+ * @param {Object} body ImportRequest
+ */
+ postExternalcontactsImportCsvJobs(body) {
+ // verify the required parameter 'body' is set
+ if (body === undefined || body === null) {
+ throw 'Missing the required parameter "body" when calling postExternalcontactsImportCsvJobs';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/jobs',
+ 'POST',
+ { },
+ { },
+ { },
+ { },
+ body,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
+ /**
+ * Create settings for CSV import
+ *
+ * @param {Object} body Settings
+ */
+ postExternalcontactsImportCsvSettings(body) {
+ // verify the required parameter 'body' is set
+ if (body === undefined || body === null) {
+ throw 'Missing the required parameter "body" when calling postExternalcontactsImportCsvSettings';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/settings',
+ 'POST',
+ { },
+ { },
+ { },
+ { },
+ body,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
+ /**
+ * Get url for CSV upload
+ *
+ * @param {Object} body UploadRequest
+ */
+ postExternalcontactsImportCsvUploads(body) {
+ // verify the required parameter 'body' is set
+ if (body === undefined || body === null) {
+ throw 'Missing the required parameter "body" when calling postExternalcontactsImportCsvUploads';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/uploads',
+ 'POST',
+ { },
+ { },
+ { },
+ { },
+ body,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
/**
* Merge two contacts into a new contact record
* Two curated contacts cannot be merged. Refer to the Contact Merging article on the Developer Center for details
@@ -23563,6 +23868,36 @@ class ExternalContactsApi {
);
}
+ /**
+ * Update settings for CSV import
+ *
+ * @param {String} settingsId Settings id
+ * @param {Object} body Settings
+ */
+ putExternalcontactsImportCsvSetting(settingsId, body) {
+ // verify the required parameter 'settingsId' is set
+ if (settingsId === undefined || settingsId === null) {
+ throw 'Missing the required parameter "settingsId" when calling putExternalcontactsImportCsvSetting';
+ }
+ // verify the required parameter 'body' is set
+ if (body === undefined || body === null) {
+ throw 'Missing the required parameter "body" when calling putExternalcontactsImportCsvSetting';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/settings/{settingsId}',
+ 'PUT',
+ { 'settingsId': settingsId },
+ { },
+ { },
+ { },
+ body,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
/**
* Update an external organization
*
@@ -23724,7 +24059,7 @@ class FaxApi {
/**
* Fax service.
* @module purecloud-platform-client-v2/api/FaxApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -23939,7 +24274,7 @@ class FlowsApi {
/**
* Flows service.
* @module purecloud-platform-client-v2/api/FlowsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -24122,7 +24457,7 @@ class GamificationApi {
/**
* Gamification service.
* @module purecloud-platform-client-v2/api/GamificationApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -26208,7 +26543,7 @@ class GeneralDataProtectionRegulationApi {
/**
* GeneralDataProtectionRegulation service.
* @module purecloud-platform-client-v2/api/GeneralDataProtectionRegulationApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -26338,7 +26673,7 @@ class GeolocationApi {
/**
* Geolocation service.
* @module purecloud-platform-client-v2/api/GeolocationApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -26469,7 +26804,7 @@ class GreetingsApi {
/**
* Greetings service.
* @module purecloud-platform-client-v2/api/GreetingsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -26924,7 +27259,7 @@ class GroupsApi {
/**
* Groups service.
* @module purecloud-platform-client-v2/api/GroupsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -27443,7 +27778,7 @@ class IdentityProviderApi {
/**
* IdentityProvider service.
* @module purecloud-platform-client-v2/api/IdentityProviderApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -28304,7 +28639,7 @@ class InfrastructureAsCodeApi {
/**
* InfrastructureAsCode service.
* @module purecloud-platform-client-v2/api/InfrastructureAsCodeApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -28471,7 +28806,7 @@ class IntegrationsApi {
/**
* Integrations service.
* @module purecloud-platform-client-v2/api/IntegrationsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -30893,7 +31228,7 @@ class JourneyApi {
/**
* Journey service.
* @module purecloud-platform-client-v2/api/JourneyApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -31987,7 +32322,6 @@ class JourneyApi {
* Get an Event Definition
*
* @param {String} eventDefinitionId Event Definition ID
- * getJourneyViewsEventdefinition is a preview method and is subject to both breaking and non-breaking changes at any time without notice
*/
getJourneyViewsEventdefinition(eventDefinitionId) {
// verify the required parameter 'eventDefinitionId' is set
@@ -32012,7 +32346,6 @@ class JourneyApi {
/**
* Get a list of Event Definitions
*
- * getJourneyViewsEventdefinitions is a preview method and is subject to both breaking and non-breaking changes at any time without notice
*/
getJourneyViewsEventdefinitions() {
@@ -32665,7 +32998,6 @@ class JourneyApi {
* True indicates a valid encoding
* @param {Object} opts Optional parameters
* @param {Array.
* @module purecloud-platform-client-v2/index
- * @version 206.0.0
+ * @version 207.0.0
*/
class platformClient {
constructor() {
diff --git a/build/dist/web-amd/purecloud-platform-client-v2.js b/build/dist/web-amd/purecloud-platform-client-v2.js
index 9675dedc8..cce852d51 100644
--- a/build/dist/web-amd/purecloud-platform-client-v2.js
+++ b/build/dist/web-amd/purecloud-platform-client-v2.js
@@ -259,6 +259,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
this.basePath;
this.authUrl;
this.config;
+ this.gateway = undefined;
this.logger = new Logger();
this.setEnvironment();
this.liveLoadConfig();
@@ -356,12 +357,72 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
: this.live_reload_config;
this.host = this.getConfigString('general', 'host') !== undefined ? this.getConfigString('general', 'host') : this.host;
+ if (this.getConfigString('gateway', 'host') !== undefined) {
+ let gateway = {
+ host: this.getConfigString('gateway', 'host')
+ };
+ if (this.getConfigString('gateway', 'protocol') !== undefined) gateway.protocol = this.getConfigString('gateway', 'protocol');
+ if (this.getConfigInt('gateway', 'port') !== undefined) gateway.port = this.getConfigInt('gateway', 'port');
+ if (this.getConfigString('gateway', 'path_params_login') !== undefined) gateway.path_params_login = this.getConfigString('gateway', 'path_params_login');
+ if (this.getConfigString('gateway', 'path_params_api') !== undefined) gateway.path_params_api = this.getConfigString('gateway', 'path_params_api');
+ if (this.getConfigString('gateway', 'username') !== undefined) gateway.username = this.getConfigString('gateway', 'username');
+ if (this.getConfigString('gateway', 'password') !== undefined) gateway.password = this.getConfigString('gateway', 'password');
+ this.setGateway(gateway);
+ } else {
+ this.setGateway();
+ }
+
this.setEnvironment();
// Update logging configs
this.logger.setLogger();
}
+ /**
+ * @description Sets the gateway used by the session
+ * @param {object} gateway - Gateway Configuration interface
+ * @param {string} gateway.host - The address of the gateway.
+ * @param {string} gateway.protocol - (optional) The protocol to use. It will default to "https" if the parameter is not defined or empty.
+ * @param {number} gateway.port - (optional) The port to target. This parameter can be defined if a non default port is used and needs to be specified in the url (value must be greater or equal to 0).
+ * @param {string} gateway.path_params_login - (optional) An arbitrary string to be appended to the gateway url path for Login requests.
+ * @param {string} gateway.path_params_api - (optional) An arbitrary string to be appended to the gateway url path for API requests.
+ * @param {string} gateway.username - (optional) Not used at this stage (for a possible future use).
+ * @param {string} gateway.password - (optional) Not used at this stage (for a possible future use).
+ */
+ setGateway(gateway) {
+ if (gateway) {
+ this.gateway = {
+ host: ''
+ };
+
+ if (gateway.protocol) this.gateway.protocol = gateway.protocol;
+ else this.gateway.protocol = 'https';
+
+ if (gateway.host) this.gateway.host = gateway.host;
+ else this.gateway.host = '';
+
+ if (gateway.port && gateway.port > -1) this.gateway.port = gateway.port;
+ else this.gateway.port = -1;
+
+ if (gateway.path_params_login) {
+ this.gateway.path_params_login = gateway.path_params_login;
+ // Strip trailing slash
+ this.gateway.path_params_login = this.gateway.path_params_login.replace(/\/+$/, '');
+ } else this.gateway.path_params_login = '';
+
+ if (gateway.path_params_api) {
+ this.gateway.path_params_api = gateway.path_params_api;
+ // Strip trailing slash
+ this.gateway.path_params_api = this.gateway.path_params_api.replace(/\/+$/, '');
+ } else this.gateway.path_params_api = '';
+
+ if (gateway.username) this.gateway.username = gateway.username;
+ if (gateway.password) this.gateway.password = gateway.password;
+ } else {
+ this.gateway = undefined;
+ }
+ }
+
setEnvironment(env) {
// Default value
if (env) this.environment = env;
@@ -379,6 +440,26 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
this.authUrl = `https://login.${this.environment}`;
}
+ getConfUrl(pathType, regionUrl) {
+ if (!this.gateway) return regionUrl;
+ if (!this.gateway.host) return regionUrl;
+
+ var url = this.gateway.protocol + '://' + this.gateway.host;
+ if (this.gateway.port > -1) url = url + ':' + this.gateway.port.toString();
+ if (pathType === 'login') {
+ if (this.gateway.path_params_login) {
+ if (this.gateway.path_params_login.startsWith('/')) url = url + this.gateway.path_params_login;
+ else url = url + '/' + this.gateway.path_params_login;
+ }
+ } else {
+ if (this.gateway.path_params_api) {
+ if (this.gateway.path_params_api.startsWith('/')) url = url + this.gateway.path_params_api;
+ else url = url + '/' + this.gateway.path_params_api;
+ }
+ }
+ return url;
+ }
+
getConfigString(section, key) {
if (this.config._sections[section]) return this.config._sections[section][key];
}
@@ -402,7 +483,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* @module purecloud-platform-client-v2/ApiClient
- * @version 206.0.0
+ * @version 207.0.0
*/
class ApiClient {
/**
@@ -600,6 +681,21 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
this.config.setEnvironment(environment);
}
+ /**
+ * @description Sets the gateway used by the session
+ * @param {object} gateway - Gateway Configuration interface
+ * @param {string} gateway.host - The address of the gateway.
+ * @param {string} gateway.protocol - (optional) The protocol to use. It will default to "https" if the parameter is not defined or empty.
+ * @param {string} gateway.port - (optional) The port to target. This parameter can be defined if a non default port is used and needs to be specified in the url (value must be greater than 0).
+ * @param {string} gateway.path_params_login - (optional) An arbitrary string to be appended to the gateway url path for Login requests.
+ * @param {string} gateway.path_params_api - (optional) An arbitrary string to be appended to the gateway url path for API requests.
+ * @param {string} gateway.username - (optional) Not used at this stage (for a possible future use).
+ * @param {string} gateway.password - (optional) Not used at this stage (for a possible future use).
+ */
+ setGateway(gateway) {
+ this.config.setGateway(gateway);
+ }
+
/**
* @description Initiates the implicit grant login flow. Will attempt to load the token from local storage, if enabled.
* @param {string} clientId - The client ID of an OAuth Implicit Grant client
@@ -664,6 +760,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
loginClientCredentialsGrant(clientId, clientSecret) {
this.clientId = clientId;
var authHeader = Buffer.from(`${clientId}:${clientSecret}`).toString('base64');
+ var loginBasePath = this.config.getConfUrl('login', `https://login.${this.config.environment}`);
return new Promise((resolve, reject) => {
// Block browsers from using client credentials
@@ -676,7 +773,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
};
axios__default["default"]({
method: `POST`,
- url: `https://login.${this.config.environment}/oauth/token`,
+ url: `${loginBasePath}/oauth/token`,
headers: headers,
data: 'grant_type=client_credentials',
httpsAgent: this.proxyAgent
@@ -687,7 +784,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'trace',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
headers,
response.headers,
{ grant_type: 'client_credentials' },
@@ -697,7 +794,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'debug',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
headers,
undefined,
{ grant_type: 'client_credentials' },
@@ -721,7 +818,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'error',
error.response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
headers,
error.response.headers,
{ grant_type: 'client_credentials' },
@@ -742,6 +839,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
*/
loginSaml2BearerGrant(clientId, clientSecret, orgName, assertion) {
this.clientId = clientId;
+ var loginBasePath = this.config.getConfUrl('login', `https://login.${this.config.environment}`);
return new Promise((resolve, reject) => {
if (typeof window !== 'undefined') {
reject(new Error('The saml2bearer grant is not supported in a browser.'));
@@ -767,7 +865,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'trace',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
response.headers,
bodyParam,
@@ -777,7 +875,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'debug',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
undefined,
bodyParam,
@@ -801,7 +899,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'error',
error.response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
error.response.headers,
bodyParam,
@@ -822,10 +920,11 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
*/
authorizePKCEGrant(clientId, codeVerifier, authCode, redirectUri) {
this.clientId = clientId;
+ var loginBasePath = this.config.getConfUrl('login', `https://login.${this.config.environment}`);
return new Promise((resolve, reject) => {
var request = axios__default["default"]({
method: `POST`,
- url: `https://login.${this.config.environment}/oauth/token`,
+ url: `${loginBasePath}/oauth/token`,
headers: {
'Content-Type': 'application/x-www-form-urlencoded'
},
@@ -852,7 +951,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'trace',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
response.headers,
bodyParam,
@@ -862,7 +961,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'debug',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
undefined,
bodyParam,
@@ -886,7 +985,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'error',
error.response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
error.response.headers,
bodyParam,
@@ -1210,6 +1309,8 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
* @param {function} reject - Promise reject callback
*/
_handleCodeAuthorizationResponse(request, bodyParam, resolve, reject) {
+ var loginBasePath = this.config.getConfUrl('login', `https://login.${this.config.environment}`);
+
request
.then((response) => {
// Logging
@@ -1217,7 +1318,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'trace',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
response.headers,
bodyParam,
@@ -1227,7 +1328,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'debug',
response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
undefined,
bodyParam,
@@ -1253,7 +1354,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'error',
error.response.status,
'POST',
- `https://login.${this.config.environment}/oauth/token`,
+ `${loginBasePath}/oauth/token`,
request.headers,
error.response.headers,
bodyParam,
@@ -1271,9 +1372,10 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
* @param {object} data - data to url form encode
*/
_formAuthRequest(encodedData, data) {
+ var loginBasePath = this.config.getConfUrl('login', `https://login.${this.config.environment}`);
var request = axios__default["default"]({
method: `POST`,
- url: `https://login.${this.config.environment}/oauth/token`,
+ url: `${loginBasePath}/oauth/token`,
headers: {
'Authorization': 'Basic ' + encodedData,
'Content-Type': 'application/x-www-form-urlencoded'
@@ -1462,7 +1564,8 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
*/
_buildAuthUrl(path, query) {
if (!query) query = {};
- return Object.keys(query).reduce((url, key) => !query[key] ? url : `${url}&${key}=${query[key]}`, `${this.config.authUrl}/${path}?`);
+ var loginBasePath = this.config.getConfUrl('login', this.config.authUrl);
+ return Object.keys(query).reduce((url, key) => !query[key] ? url : `${url}&${key}=${query[key]}`, `${loginBasePath}/${path}?`);
}
/**
@@ -1524,7 +1627,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
if (!path.match(/^\//)) {
path = `/${path}`;
}
- var url = this.config.basePath + path;
+ var url = this.config.getConfUrl('api', this.config.basePath) + path;
url = url.replace(/\{([\w-]+)\}/g, (fullMatch, key) => {
var value;
if (pathParams.hasOwnProperty(key)) {
@@ -1824,7 +1927,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* AgentAssistants service.
* @module purecloud-platform-client-v2/api/AgentAssistantsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -2200,7 +2303,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* AgentCopilot service.
* @module purecloud-platform-client-v2/api/AgentCopilotApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -2276,7 +2379,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* AgentUI service.
* @module purecloud-platform-client-v2/api/AgentUIApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -2407,7 +2510,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Alerting service.
* @module purecloud-platform-client-v2/api/AlertingApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -3068,7 +3171,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Analytics service.
* @module purecloud-platform-client-v2/api/AnalyticsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -3919,6 +4022,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
* @param {Number} opts.pageSize (default to 25)
* @param {Array.} opts.id A list of user IDs to fetch by bulk
* @param {Object} opts.state Only list users of this state
+ * @param {Boolean} opts.deletedOnly Only list deleted dashboards that are still recoverable
*/
getAnalyticsReportingDashboardsUsers(opts) {
opts = opts || {};
@@ -3928,7 +4032,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'/api/v2/analytics/reporting/dashboards/users',
'GET',
{ },
- { 'sortBy': opts['sortBy'],'pageNumber': opts['pageNumber'],'pageSize': opts['pageSize'],'id': this.apiClient.buildCollectionParam(opts['id'], 'multi'),'state': opts['state'] },
+ { 'sortBy': opts['sortBy'],'pageNumber': opts['pageNumber'],'pageSize': opts['pageSize'],'id': this.apiClient.buildCollectionParam(opts['id'], 'multi'),'state': opts['state'],'deletedOnly': opts['deletedOnly'] },
{ },
{ },
null,
@@ -4050,6 +4154,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
* @param {Number} opts.pageSize (default to 50)
* @param {Boolean} opts.publicOnly If true, retrieve only public dashboards
* @param {Boolean} opts.favoriteOnly If true, retrieve only favorite dashboards
+ * @param {Boolean} opts.deletedOnly If true, retrieve only deleted dashboards that are still recoverable
* @param {String} opts.name retrieve dashboards that match with given name
*/
getAnalyticsReportingSettingsUserDashboards(userId, opts) {
@@ -4064,7 +4169,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'/api/v2/analytics/reporting/settings/users/{userId}/dashboards',
'GET',
{ 'userId': userId },
- { 'sortBy': opts['sortBy'],'pageNumber': opts['pageNumber'],'pageSize': opts['pageSize'],'publicOnly': opts['publicOnly'],'favoriteOnly': opts['favoriteOnly'],'name': opts['name'] },
+ { 'sortBy': opts['sortBy'],'pageNumber': opts['pageNumber'],'pageSize': opts['pageSize'],'publicOnly': opts['publicOnly'],'favoriteOnly': opts['favoriteOnly'],'deletedOnly': opts['deletedOnly'],'name': opts['name'] },
{ },
{ },
null,
@@ -5154,7 +5259,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
}
/**
- * Bulk delete dashboards owned by other user(s)
+ * Bulk soft delete dashboards owned by other user(s)
*
* @param {Array.} body List of userIds
*/
@@ -5204,7 +5309,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
}
/**
- * Bulk remove dashboard configurations
+ * Bulk soft delete dashboard configurations
*
* @param {Object} body
*/
@@ -5390,7 +5495,6 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
* Query for task management aggregates
*
* @param {Object} body query
- * postAnalyticsTaskmanagementAggregatesQuery is a preview method and is subject to both breaking and non-breaking changes at any time without notice
*/
postAnalyticsTaskmanagementAggregatesQuery(body) {
// verify the required parameter 'body' is set
@@ -5680,7 +5784,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Architect service.
* @module purecloud-platform-client-v2/api/ArchitectApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -7425,7 +7529,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
}
/**
- * Create flow version configuration
+ * Get flow version configuration
*
* @param {String} flowId Flow ID
* @param {String} versionId Version ID
@@ -9802,7 +9906,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Audit service.
* @module purecloud-platform-client-v2/api/AuditApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -10003,7 +10107,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Authorization service.
* @module purecloud-platform-client-v2/api/AuthorizationApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -11286,7 +11390,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Billing service.
* @module purecloud-platform-client-v2/api/BillingApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -11366,7 +11470,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* CarrierServices service.
* @module purecloud-platform-client-v2/api/CarrierServicesApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -11436,7 +11540,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Chat service.
* @module purecloud-platform-client-v2/api/ChatApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -12372,7 +12476,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Coaching service.
* @module purecloud-platform-client-v2/api/CoachingApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -12949,7 +13053,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* ContentManagement service.
* @module purecloud-platform-client-v2/api/ContentManagementApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -13338,7 +13442,6 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
* This method requires the download sharing URI obtained in the get document response (downloadSharingUri). Documents may be shared between users in the same workspace. Documents may also be shared between any user by creating a content management share.
* @param {String} sharedId Shared ID
* @param {Object} opts Optional parameters
- * @param {Boolean} opts.redirect Turn on or off redirect (default to true)
* @param {Object} opts.disposition Request how the share content will be downloaded: attached as a file or inline. Default is attachment. (default to attachment)
* @param {String} opts.contentType The requested format for the specified document. If supported, the document will be returned in that format. Example contentType=audio/wav
* @param {Object} opts.expand Expand some document fields
@@ -13355,7 +13458,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
'/api/v2/contentmanagement/shared/{sharedId}',
'GET',
{ 'sharedId': sharedId },
- { 'redirect': opts['redirect'],'disposition': opts['disposition'],'contentType': opts['contentType'],'expand': opts['expand'] },
+ { 'disposition': opts['disposition'],'contentType': opts['contentType'],'expand': opts['expand'] },
{ },
{ },
null,
@@ -14031,7 +14134,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Conversations service.
* @module purecloud-platform-client-v2/api/ConversationsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -18724,9 +18827,10 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Suggestion feedback.
- *
+ * Google Agent Assist offering within Genesys will no longer be supported
* @param {String} conversationId Conversation ID
* @param {Object} body SuggestionFeedback
+ * @deprecated
*/
postConversationSuggestionsFeedback(conversationId, body) {
// verify the required parameter 'conversationId' is set
@@ -21172,7 +21276,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* DataExtensions service.
* @module purecloud-platform-client-v2/api/DataExtensionsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -21258,7 +21362,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Downloads service.
* @module purecloud-platform-client-v2/api/DownloadsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -21310,7 +21414,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Emails service.
* @module purecloud-platform-client-v2/api/EmailsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -21375,7 +21479,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* EmployeeEngagement service.
* @module purecloud-platform-client-v2/api/EmployeeEngagementApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -21526,7 +21630,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Events service.
* @module purecloud-platform-client-v2/api/EventsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -21622,7 +21726,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* ExternalContacts service.
* @module purecloud-platform-client-v2/api/ExternalContactsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -21743,6 +21847,31 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
);
}
+ /**
+ * Delete settings for CSV import
+ *
+ * @param {String} settingsId Settings id
+ */
+ deleteExternalcontactsImportCsvSetting(settingsId) {
+ // verify the required parameter 'settingsId' is set
+ if (settingsId === undefined || settingsId === null) {
+ throw 'Missing the required parameter "settingsId" when calling deleteExternalcontactsImportCsvSetting';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/settings/{settingsId}',
+ 'DELETE',
+ { 'settingsId': settingsId },
+ { },
+ { },
+ { },
+ null,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
/**
* Delete an external organization
*
@@ -22210,6 +22339,107 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
);
}
+ /**
+ * Get settings for CSV import
+ *
+ * @param {String} settingsId Settings id
+ */
+ getExternalcontactsImportCsvSetting(settingsId) {
+ // verify the required parameter 'settingsId' is set
+ if (settingsId === undefined || settingsId === null) {
+ throw 'Missing the required parameter "settingsId" when calling getExternalcontactsImportCsvSetting';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/settings/{settingsId}',
+ 'GET',
+ { 'settingsId': settingsId },
+ { },
+ { },
+ { },
+ null,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
+ /**
+ * Retrieve all settings for organization filtered by externalSettingsId if provided
+ *
+ * @param {Object} opts Optional parameters
+ * @param {String} opts.after The cursor that points to the end of the set of entities that has been returned.
+ * @param {String} opts.pageSize Number of entities to return. Maximum of 200.
+ * @param {String} opts.externalSettingsId External Settings Id to filter the list.
+ */
+ getExternalcontactsImportCsvSettings(opts) {
+ opts = opts || {};
+
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/settings',
+ 'GET',
+ { },
+ { 'after': opts['after'],'pageSize': opts['pageSize'],'externalSettingsId': opts['externalSettingsId'] },
+ { },
+ { },
+ null,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
+ /**
+ * Get details for CSV upload
+ *
+ * @param {String} uploadId Upload id
+ */
+ getExternalcontactsImportCsvUploadDetails(uploadId) {
+ // verify the required parameter 'uploadId' is set
+ if (uploadId === undefined || uploadId === null) {
+ throw 'Missing the required parameter "uploadId" when calling getExternalcontactsImportCsvUploadDetails';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/uploads/{uploadId}/details',
+ 'GET',
+ { 'uploadId': uploadId },
+ { },
+ { },
+ { },
+ null,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
+ /**
+ * Get preview for CSV upload
+ *
+ * @param {String} uploadId Upload id
+ */
+ getExternalcontactsImportCsvUploadPreview(uploadId) {
+ // verify the required parameter 'uploadId' is set
+ if (uploadId === undefined || uploadId === null) {
+ throw 'Missing the required parameter "uploadId" when calling getExternalcontactsImportCsvUploadPreview';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/uploads/{uploadId}/preview',
+ 'GET',
+ { 'uploadId': uploadId },
+ { },
+ { },
+ { },
+ null,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
/**
* Fetch an external organization
*
@@ -23274,6 +23504,81 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
);
}
+ /**
+ * Create CSV import job
+ *
+ * @param {Object} body ImportRequest
+ */
+ postExternalcontactsImportCsvJobs(body) {
+ // verify the required parameter 'body' is set
+ if (body === undefined || body === null) {
+ throw 'Missing the required parameter "body" when calling postExternalcontactsImportCsvJobs';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/jobs',
+ 'POST',
+ { },
+ { },
+ { },
+ { },
+ body,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
+ /**
+ * Create settings for CSV import
+ *
+ * @param {Object} body Settings
+ */
+ postExternalcontactsImportCsvSettings(body) {
+ // verify the required parameter 'body' is set
+ if (body === undefined || body === null) {
+ throw 'Missing the required parameter "body" when calling postExternalcontactsImportCsvSettings';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/settings',
+ 'POST',
+ { },
+ { },
+ { },
+ { },
+ body,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
+ /**
+ * Get url for CSV upload
+ *
+ * @param {Object} body UploadRequest
+ */
+ postExternalcontactsImportCsvUploads(body) {
+ // verify the required parameter 'body' is set
+ if (body === undefined || body === null) {
+ throw 'Missing the required parameter "body" when calling postExternalcontactsImportCsvUploads';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/uploads',
+ 'POST',
+ { },
+ { },
+ { },
+ { },
+ body,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
/**
* Merge two contacts into a new contact record
* Two curated contacts cannot be merged. Refer to the Contact Merging article on the Developer Center for details
@@ -23560,6 +23865,36 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
);
}
+ /**
+ * Update settings for CSV import
+ *
+ * @param {String} settingsId Settings id
+ * @param {Object} body Settings
+ */
+ putExternalcontactsImportCsvSetting(settingsId, body) {
+ // verify the required parameter 'settingsId' is set
+ if (settingsId === undefined || settingsId === null) {
+ throw 'Missing the required parameter "settingsId" when calling putExternalcontactsImportCsvSetting';
+ }
+ // verify the required parameter 'body' is set
+ if (body === undefined || body === null) {
+ throw 'Missing the required parameter "body" when calling putExternalcontactsImportCsvSetting';
+ }
+
+ return this.apiClient.callApi(
+ '/api/v2/externalcontacts/import/csv/settings/{settingsId}',
+ 'PUT',
+ { 'settingsId': settingsId },
+ { },
+ { },
+ { },
+ body,
+ ['PureCloud OAuth'],
+ ['application/json'],
+ ['application/json']
+ );
+ }
+
/**
* Update an external organization
*
@@ -23721,7 +24056,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Fax service.
* @module purecloud-platform-client-v2/api/FaxApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -23936,7 +24271,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Flows service.
* @module purecloud-platform-client-v2/api/FlowsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -24119,7 +24454,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Gamification service.
* @module purecloud-platform-client-v2/api/GamificationApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -26205,7 +26540,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* GeneralDataProtectionRegulation service.
* @module purecloud-platform-client-v2/api/GeneralDataProtectionRegulationApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -26335,7 +26670,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Geolocation service.
* @module purecloud-platform-client-v2/api/GeolocationApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -26466,7 +26801,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Greetings service.
* @module purecloud-platform-client-v2/api/GreetingsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -26921,7 +27256,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Groups service.
* @module purecloud-platform-client-v2/api/GroupsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -27440,7 +27775,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* IdentityProvider service.
* @module purecloud-platform-client-v2/api/IdentityProviderApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -28301,7 +28636,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* InfrastructureAsCode service.
* @module purecloud-platform-client-v2/api/InfrastructureAsCodeApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -28468,7 +28803,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Integrations service.
* @module purecloud-platform-client-v2/api/IntegrationsApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -30890,7 +31225,7 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Journey service.
* @module purecloud-platform-client-v2/api/JourneyApi
- * @version 206.0.0
+ * @version 207.0.0
*/
/**
@@ -31984,7 +32319,6 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
* Get an Event Definition
*
* @param {String} eventDefinitionId Event Definition ID
- * getJourneyViewsEventdefinition is a preview method and is subject to both breaking and non-breaking changes at any time without notice
*/
getJourneyViewsEventdefinition(eventDefinitionId) {
// verify the required parameter 'eventDefinitionId' is set
@@ -32009,7 +32343,6 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
/**
* Get a list of Event Definitions
*
- * getJourneyViewsEventdefinitions is a preview method and is subject to both breaking and non-breaking changes at any time without notice
*/
getJourneyViewsEventdefinitions() {
@@ -32662,7 +32995,6 @@ ${this.formatValue('Status', statusCode)}${this.formatValue('Headers', this.form
* True indicates a valid encoding
* @param {Object} opts Optional parameters
* @param {Array.