# TalonOne.ManagementApi All URIs are relative to *https://yourbaseurl.talon.one* Method | HTTP request | Description ------------- | ------------- | ------------- [**activateUserByEmail**](ManagementApi.md#activateUserByEmail) | **POST** /v1/users/activate | Enable user by email address [**addLoyaltyCardPoints**](ManagementApi.md#addLoyaltyCardPoints) | **PUT** /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/add_points | Add points to card [**addLoyaltyPoints**](ManagementApi.md#addLoyaltyPoints) | **PUT** /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/add_points | Add points to customer profile [**copyCampaignToApplications**](ManagementApi.md#copyCampaignToApplications) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/copy | Copy the campaign into the specified Application [**createAccountCollection**](ManagementApi.md#createAccountCollection) | **POST** /v1/collections | Create account-level collection [**createAchievement**](ManagementApi.md#createAchievement) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/achievements | Create achievement [**createAchievementV2**](ManagementApi.md#createAchievementV2) | **POST** /v2/achievements | Create achievement [**createAdditionalCost**](ManagementApi.md#createAdditionalCost) | **POST** /v1/additional_costs | Create additional cost [**createAttribute**](ManagementApi.md#createAttribute) | **POST** /v1/attributes | Create custom attribute [**createBatchLoyaltyCards**](ManagementApi.md#createBatchLoyaltyCards) | **POST** /v1/loyalty_programs/{loyaltyProgramId}/cards/batch | Create loyalty cards [**createCampaignFromTemplate**](ManagementApi.md#createCampaignFromTemplate) | **POST** /v1/applications/{applicationId}/create_campaign_from_template | Create campaign from campaign template [**createCampaignStoreBudget**](ManagementApi.md#createCampaignStoreBudget) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/stores/budgets | Create campaign store budget [**createCollection**](ManagementApi.md#createCollection) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/collections | Create campaign-level collection [**createCoupons**](ManagementApi.md#createCoupons) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/coupons | Create coupons [**createCouponsAsync**](ManagementApi.md#createCouponsAsync) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/coupons_async | Create coupons asynchronously [**createCouponsDeletionJob**](ManagementApi.md#createCouponsDeletionJob) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/coupons_deletion_jobs | Creates a coupon deletion job [**createCouponsForMultipleRecipients**](ManagementApi.md#createCouponsForMultipleRecipients) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/coupons_with_recipients | Create coupons for multiple recipients [**createInviteEmail**](ManagementApi.md#createInviteEmail) | **POST** /v1/invite_emails | Resend invitation email [**createInviteV2**](ManagementApi.md#createInviteV2) | **POST** /v2/invites | Invite user [**createPasswordRecoveryEmail**](ManagementApi.md#createPasswordRecoveryEmail) | **POST** /v1/password_recovery_emails | Request a password reset [**createRulesetV2**](ManagementApi.md#createRulesetV2) | **POST** /v2/applications/{applicationId}/campaigns/{campaignId}/rulesets | Create ruleset (V2) [**createSession**](ManagementApi.md#createSession) | **POST** /v1/sessions | Create session [**createStore**](ManagementApi.md#createStore) | **POST** /v1/applications/{applicationId}/stores | Create store [**deactivateUserByEmail**](ManagementApi.md#deactivateUserByEmail) | **POST** /v1/users/deactivate | Disable user by email address [**deductLoyaltyCardPoints**](ManagementApi.md#deductLoyaltyCardPoints) | **PUT** /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/deduct_points | Deduct points from card [**deleteAccountCollection**](ManagementApi.md#deleteAccountCollection) | **DELETE** /v1/collections/{collectionId} | Delete account-level collection [**deleteAchievement**](ManagementApi.md#deleteAchievement) | **DELETE** /v1/applications/{applicationId}/campaigns/{campaignId}/achievements/{achievementId} | Delete achievement [**deleteAchievementV2**](ManagementApi.md#deleteAchievementV2) | **DELETE** /v2/achievements/{achievementId} | Delete achievement [**deleteCampaign**](ManagementApi.md#deleteCampaign) | **DELETE** /v1/applications/{applicationId}/campaigns/{campaignId} | Delete campaign [**deleteCampaignStoreBudgets**](ManagementApi.md#deleteCampaignStoreBudgets) | **DELETE** /v1/applications/{applicationId}/campaigns/{campaignId}/stores/budgets | Delete campaign store budgets [**deleteCollection**](ManagementApi.md#deleteCollection) | **DELETE** /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId} | Delete campaign-level collection [**deleteCoupon**](ManagementApi.md#deleteCoupon) | **DELETE** /v1/applications/{applicationId}/campaigns/{campaignId}/coupons/{couponId} | Delete coupon [**deleteCoupons**](ManagementApi.md#deleteCoupons) | **DELETE** /v1/applications/{applicationId}/campaigns/{campaignId}/coupons | Delete coupons [**deleteLoyaltyCard**](ManagementApi.md#deleteLoyaltyCard) | **DELETE** /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId} | Delete loyalty card [**deleteReferral**](ManagementApi.md#deleteReferral) | **DELETE** /v1/applications/{applicationId}/campaigns/{campaignId}/referrals/{referralId} | Delete referral [**deleteStore**](ManagementApi.md#deleteStore) | **DELETE** /v1/applications/{applicationId}/stores/{storeId} | Delete store [**deleteUser**](ManagementApi.md#deleteUser) | **DELETE** /v1/users/{userId} | Delete user [**deleteUserByEmail**](ManagementApi.md#deleteUserByEmail) | **POST** /v1/users/delete | Delete user by email address [**destroySession**](ManagementApi.md#destroySession) | **DELETE** /v1/sessions | Destroy session [**disconnectCampaignStores**](ManagementApi.md#disconnectCampaignStores) | **DELETE** /v1/applications/{applicationId}/campaigns/{campaignId}/stores | Disconnect stores [**excludePriceHistory**](ManagementApi.md#excludePriceHistory) | **POST** /v1/applications/{applicationId}/price_history/exclusions | Exclude price records from price history [**exportAccountCollectionItems**](ManagementApi.md#exportAccountCollectionItems) | **GET** /v1/collections/{collectionId}/export | Export account-level collection's items [**exportAchievementV2**](ManagementApi.md#exportAchievementV2) | **GET** /v2/achievements/{achievementId}/export | Export achievement customer data [**exportAchievements**](ManagementApi.md#exportAchievements) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/achievements/{achievementId}/export | Export achievement customer data [**exportApplicationCampaignAnalytics**](ManagementApi.md#exportApplicationCampaignAnalytics) | **GET** /v1/applications/{applicationId}/campaign_analytics/export | Export Application analytics aggregated by campaign [**exportAudiencesMemberships**](ManagementApi.md#exportAudiencesMemberships) | **GET** /v1/audiences/{audienceId}/memberships/export | Export audience members [**exportCampaignStoreBudgets**](ManagementApi.md#exportCampaignStoreBudgets) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/stores/budgets/export | Export campaign store budgets [**exportCampaignStores**](ManagementApi.md#exportCampaignStores) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/stores/export | Export stores [**exportCampaignValueMap**](ManagementApi.md#exportCampaignValueMap) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/value_maps/{valueMapId}/export | Export campaign value map [**exportCollectionItems**](ManagementApi.md#exportCollectionItems) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId}/export | Export campaign-level collection's items [**exportCoupons**](ManagementApi.md#exportCoupons) | **GET** /v1/applications/{applicationId}/export_coupons | Export coupons [**exportCustomerSessions**](ManagementApi.md#exportCustomerSessions) | **GET** /v1/applications/{applicationId}/export_customer_sessions | Export customer sessions [**exportCustomersTiers**](ManagementApi.md#exportCustomersTiers) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/export_customers_tiers | Export customers' tier data [**exportEffects**](ManagementApi.md#exportEffects) | **GET** /v1/applications/{applicationId}/export_effects | Export triggered effects [**exportLoyaltyBalance**](ManagementApi.md#exportLoyaltyBalance) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/export_customer_balance | Export customer loyalty balance to CSV [**exportLoyaltyBalances**](ManagementApi.md#exportLoyaltyBalances) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/export_customer_balances | Export customer loyalty balances [**exportLoyaltyCardBalances**](ManagementApi.md#exportLoyaltyCardBalances) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/export_card_balances | Export all card transaction logs [**exportLoyaltyCardLedger**](ManagementApi.md#exportLoyaltyCardLedger) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/export_log | Export card's ledger log [**exportLoyaltyCards**](ManagementApi.md#exportLoyaltyCards) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/cards/export | Export loyalty cards [**exportLoyaltyJoinDates**](ManagementApi.md#exportLoyaltyJoinDates) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/export_join_dates | Export customers' loyalty program join dates [**exportLoyaltyLedger**](ManagementApi.md#exportLoyaltyLedger) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/export_log | Export customer's transaction logs [**exportPoolGiveaways**](ManagementApi.md#exportPoolGiveaways) | **GET** /v1/giveaways/pools/{poolId}/export | Export giveaway codes of a giveaway pool [**exportReferrals**](ManagementApi.md#exportReferrals) | **GET** /v1/applications/{applicationId}/export_referrals | Export referrals [**generateCouponRejections**](ManagementApi.md#generateCouponRejections) | **GET** /v1/coupon_rejections | Summarize coupon redemption failures in session [**getAccessLogsWithoutTotalCount**](ManagementApi.md#getAccessLogsWithoutTotalCount) | **GET** /v1/applications/{applicationId}/access_logs/no_total | Get access logs for Application [**getAccount**](ManagementApi.md#getAccount) | **GET** /v1/accounts/{accountId} | Get account details [**getAccountAnalytics**](ManagementApi.md#getAccountAnalytics) | **GET** /v1/accounts/{accountId}/analytics | Get account analytics [**getAccountCollection**](ManagementApi.md#getAccountCollection) | **GET** /v1/collections/{collectionId} | Get account-level collection [**getAchievement**](ManagementApi.md#getAchievement) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/achievements/{achievementId} | Get achievement [**getAchievementV2**](ManagementApi.md#getAchievementV2) | **GET** /v2/achievements/{achievementId} | Get achievement [**getAdditionalCost**](ManagementApi.md#getAdditionalCost) | **GET** /v1/additional_costs/{additionalCostId} | Get additional cost [**getAdditionalCosts**](ManagementApi.md#getAdditionalCosts) | **GET** /v1/additional_costs | List additional costs [**getApplication**](ManagementApi.md#getApplication) | **GET** /v1/applications/{applicationId} | Get Application [**getApplicationApiHealth**](ManagementApi.md#getApplicationApiHealth) | **GET** /v1/applications/{applicationId}/health_report | Get Application health [**getApplicationCartItemFilterExpression**](ManagementApi.md#getApplicationCartItemFilterExpression) | **GET** /v1/applications/{applicationId}/cart_item_filters/{cartItemFilterId}/expressions/{expressionId} | Get Application cart item filter expression [**getApplicationCustomer**](ManagementApi.md#getApplicationCustomer) | **GET** /v1/applications/{applicationId}/customers/{customerId} | Get application's customer [**getApplicationCustomerFriends**](ManagementApi.md#getApplicationCustomerFriends) | **GET** /v1/applications/{applicationId}/profile/{integrationId}/friends | List friends referred by customer profile [**getApplicationCustomers**](ManagementApi.md#getApplicationCustomers) | **GET** /v1/applications/{applicationId}/customers | List application's customers [**getApplicationCustomersByAttributes**](ManagementApi.md#getApplicationCustomersByAttributes) | **POST** /v1/applications/{applicationId}/customer_search | List application customers matching the given attributes [**getApplicationEventTypes**](ManagementApi.md#getApplicationEventTypes) | **GET** /v1/applications/{applicationId}/event_types | List Applications event types [**getApplicationEventsWithoutTotalCount**](ManagementApi.md#getApplicationEventsWithoutTotalCount) | **GET** /v1/applications/{applicationId}/events/no_total | List Applications events [**getApplicationSession**](ManagementApi.md#getApplicationSession) | **GET** /v1/applications/{applicationId}/sessions/{sessionId} | Get Application session [**getApplicationSessions**](ManagementApi.md#getApplicationSessions) | **GET** /v1/applications/{applicationId}/sessions | List Application sessions [**getApplicationSessionsByCustomerAttributes**](ManagementApi.md#getApplicationSessionsByCustomerAttributes) | **POST** /v1/applications/{applicationId}/sessions_search | List Application sessions matching the given customer attributes [**getApplications**](ManagementApi.md#getApplications) | **GET** /v1/applications | List Applications [**getAttribute**](ManagementApi.md#getAttribute) | **GET** /v1/attributes/{attributeId} | Get custom attribute [**getAttributes**](ManagementApi.md#getAttributes) | **GET** /v1/attributes | List custom attributes [**getAudienceMemberships**](ManagementApi.md#getAudienceMemberships) | **GET** /v1/audiences/{audienceId}/memberships | List audience members [**getAudiences**](ManagementApi.md#getAudiences) | **GET** /v1/audiences | List audiences [**getAudiencesAnalytics**](ManagementApi.md#getAudiencesAnalytics) | **GET** /v1/audiences/analytics | List audience analytics [**getCampaign**](ManagementApi.md#getCampaign) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId} | Get campaign [**getCampaignAnalytics**](ManagementApi.md#getCampaignAnalytics) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/analytics | Get analytics of campaigns [**getCampaignByAttributes**](ManagementApi.md#getCampaignByAttributes) | **POST** /v1/applications/{applicationId}/campaigns_search | List campaigns that match the given attributes [**getCampaignGroup**](ManagementApi.md#getCampaignGroup) | **GET** /v1/campaign_groups/{campaignGroupId} | Get campaign access group [**getCampaignGroups**](ManagementApi.md#getCampaignGroups) | **GET** /v1/campaign_groups | List campaign access groups [**getCampaignTemplates**](ManagementApi.md#getCampaignTemplates) | **GET** /v1/campaign_templates | List campaign templates [**getCampaigns**](ManagementApi.md#getCampaigns) | **GET** /v1/applications/{applicationId}/campaigns | List campaigns [**getChanges**](ManagementApi.md#getChanges) | **GET** /v1/changes | Get audit logs for an account [**getCollection**](ManagementApi.md#getCollection) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId} | Get campaign-level collection [**getCollectionItems**](ManagementApi.md#getCollectionItems) | **GET** /v1/collections/{collectionId}/items | Get collection items [**getCouponsWithoutTotalCount**](ManagementApi.md#getCouponsWithoutTotalCount) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/coupons/no_total | List coupons [**getCustomerActivityReport**](ManagementApi.md#getCustomerActivityReport) | **GET** /v1/applications/{applicationId}/customer_activity_reports/{customerId} | Get customer's activity report [**getCustomerActivityReportsWithoutTotalCount**](ManagementApi.md#getCustomerActivityReportsWithoutTotalCount) | **GET** /v1/applications/{applicationId}/customer_activity_reports/no_total | Get Activity Reports for Application Customers [**getCustomerAnalytics**](ManagementApi.md#getCustomerAnalytics) | **GET** /v1/applications/{applicationId}/customers/{customerId}/analytics | Get customer's analytics report [**getCustomerProfile**](ManagementApi.md#getCustomerProfile) | **GET** /v1/customers/{customerId} | Get customer profile [**getCustomerProfileAchievementProgress**](ManagementApi.md#getCustomerProfileAchievementProgress) | **GET** /v1/applications/{applicationId}/achievement_progress/{integrationId} | List customer achievements [**getCustomerProfiles**](ManagementApi.md#getCustomerProfiles) | **GET** /v1/customers/no_total | List customer profiles [**getCustomersByAttributes**](ManagementApi.md#getCustomersByAttributes) | **POST** /v1/customer_search/no_total | List customer profiles matching the given attributes [**getDashboardStatistics**](ManagementApi.md#getDashboardStatistics) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/dashboard | Get statistics for loyalty dashboard [**getEventTypes**](ManagementApi.md#getEventTypes) | **GET** /v1/event_types | List event types [**getExperiment**](ManagementApi.md#getExperiment) | **GET** /v1/applications/{applicationId}/experiments/{experimentId} | Get experiment in Application [**getExports**](ManagementApi.md#getExports) | **GET** /v1/exports | Get exports [**getLoyaltyCard**](ManagementApi.md#getLoyaltyCard) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId} | Get loyalty card [**getLoyaltyCardTransactionLogs**](ManagementApi.md#getLoyaltyCardTransactionLogs) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/logs | List card's transactions (Management API) [**getLoyaltyCards**](ManagementApi.md#getLoyaltyCards) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/cards | List loyalty cards [**getLoyaltyLedgerBalances**](ManagementApi.md#getLoyaltyLedgerBalances) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/ledger_balances | Get customer's loyalty balances (Management API) [**getLoyaltyPoints**](ManagementApi.md#getLoyaltyPoints) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId} | Get customer's full loyalty ledger [**getLoyaltyProgram**](ManagementApi.md#getLoyaltyProgram) | **GET** /v1/loyalty_programs/{loyaltyProgramId} | Get loyalty program [**getLoyaltyProgramProfileLedgerTransactions**](ManagementApi.md#getLoyaltyProgramProfileLedgerTransactions) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/ledger_transactions | List customer's loyalty transactions (Management API) [**getLoyaltyProgramTransactions**](ManagementApi.md#getLoyaltyProgramTransactions) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/transactions | List loyalty program transactions [**getLoyaltyPrograms**](ManagementApi.md#getLoyaltyPrograms) | **GET** /v1/loyalty_programs | List loyalty programs [**getLoyaltyStatistics**](ManagementApi.md#getLoyaltyStatistics) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/statistics | Get loyalty program statistics [**getMessageLogs**](ManagementApi.md#getMessageLogs) | **GET** /v1/message_logs | List message log entries [**getReferralsWithoutTotalCount**](ManagementApi.md#getReferralsWithoutTotalCount) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/referrals/no_total | List referrals [**getRoleV2**](ManagementApi.md#getRoleV2) | **GET** /v2/roles/{roleId} | Get role [**getRuleset**](ManagementApi.md#getRuleset) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/rulesets/{rulesetId} | Get ruleset [**getRulesetV2**](ManagementApi.md#getRulesetV2) | **GET** /v2/applications/{applicationId}/campaigns/{campaignId}/rulesets/{rulesetId} | Get ruleset (V2) [**getRulesets**](ManagementApi.md#getRulesets) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/rulesets | List campaign rulesets [**getStore**](ManagementApi.md#getStore) | **GET** /v1/applications/{applicationId}/stores/{storeId} | Get store [**getUser**](ManagementApi.md#getUser) | **GET** /v1/users/{userId} | Get user [**getUsers**](ManagementApi.md#getUsers) | **GET** /v1/users | List users in account [**getWebhook**](ManagementApi.md#getWebhook) | **GET** /v1/webhooks/{webhookId} | Get webhook [**getWebhooks**](ManagementApi.md#getWebhooks) | **GET** /v1/webhooks | List webhooks [**importAccountCollection**](ManagementApi.md#importAccountCollection) | **POST** /v1/collections/{collectionId}/import | Import data into existing account-level collection [**importAllowedList**](ManagementApi.md#importAllowedList) | **POST** /v1/attributes/{attributeId}/allowed_list/import | Import allowed values for attribute [**importAudiencesMemberships**](ManagementApi.md#importAudiencesMemberships) | **POST** /v1/audiences/{audienceId}/memberships/import | Import audience members [**importCampaignStoreBudget**](ManagementApi.md#importCampaignStoreBudget) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/stores/budgets/import | Import campaign store budgets [**importCampaignStores**](ManagementApi.md#importCampaignStores) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/stores/import | Import stores [**importCollection**](ManagementApi.md#importCollection) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId}/import | Import data into existing campaign-level collection [**importCoupons**](ManagementApi.md#importCoupons) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/import_coupons | Import coupons [**importLoyaltyCards**](ManagementApi.md#importLoyaltyCards) | **POST** /v1/loyalty_programs/{loyaltyProgramId}/import_cards | Import loyalty cards [**importLoyaltyCustomersTiers**](ManagementApi.md#importLoyaltyCustomersTiers) | **POST** /v1/loyalty_programs/{loyaltyProgramId}/import_customers_tiers | Import customers into loyalty tiers [**importLoyaltyJoinDates**](ManagementApi.md#importLoyaltyJoinDates) | **POST** /v1/loyalty_programs/{loyaltyProgramId}/import_join_dates | Import join dates for a loyalty program [**importLoyaltyPoints**](ManagementApi.md#importLoyaltyPoints) | **POST** /v1/loyalty_programs/{loyaltyProgramId}/import_points | Import loyalty points [**importPoolGiveaways**](ManagementApi.md#importPoolGiveaways) | **POST** /v1/giveaways/pools/{poolId}/import | Import giveaway codes into a giveaway pool [**importReferrals**](ManagementApi.md#importReferrals) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/import_referrals | Import referrals [**inviteUserExternal**](ManagementApi.md#inviteUserExternal) | **POST** /v1/users/invite | Invite user from identity provider [**listAccountCollections**](ManagementApi.md#listAccountCollections) | **GET** /v1/collections | List collections in account [**listAchievements**](ManagementApi.md#listAchievements) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/achievements | List achievements [**listAchievementsV2**](ManagementApi.md#listAchievementsV2) | **GET** /v2/achievements | List achievements [**listAllRolesV2**](ManagementApi.md#listAllRolesV2) | **GET** /v2/roles | List roles [**listApplicationCartItemFilters**](ManagementApi.md#listApplicationCartItemFilters) | **GET** /v1/applications/{applicationId}/cart_item_filters | List Application cart item filters [**listCampaignStoreBudgetLimits**](ManagementApi.md#listCampaignStoreBudgetLimits) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/stores/budgets | List campaign store budget limits [**listCatalogItems**](ManagementApi.md#listCatalogItems) | **GET** /v1/catalogs/{catalogId}/items | List items in a catalog [**listCollections**](ManagementApi.md#listCollections) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/collections | List collections in campaign [**listCollectionsInApplication**](ManagementApi.md#listCollectionsInApplication) | **GET** /v1/applications/{applicationId}/collections | List collections in Application [**listExperiments**](ManagementApi.md#listExperiments) | **GET** /v1/applications/{applicationId}/experiments | List experiments [**listStores**](ManagementApi.md#listStores) | **GET** /v1/applications/{applicationId}/stores | List stores [**oktaEventHandlerChallenge**](ManagementApi.md#oktaEventHandlerChallenge) | **GET** /v1/provisioning/okta | Validate Okta API ownership [**priceHistory**](ManagementApi.md#priceHistory) | **POST** /v1/applications/{applicationId}/price_history | Get summary of price history [**removeLoyaltyPoints**](ManagementApi.md#removeLoyaltyPoints) | **PUT** /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/deduct_points | Deduct points from customer profile [**resetPassword**](ManagementApi.md#resetPassword) | **POST** /v1/reset_password | Reset password [**scimCreateGroup**](ManagementApi.md#scimCreateGroup) | **POST** /v1/provisioning/scim/Groups | Create SCIM group [**scimCreateUser**](ManagementApi.md#scimCreateUser) | **POST** /v1/provisioning/scim/Users | Create SCIM user [**scimDeleteGroup**](ManagementApi.md#scimDeleteGroup) | **DELETE** /v1/provisioning/scim/Groups/{groupId} | Delete SCIM group [**scimDeleteUser**](ManagementApi.md#scimDeleteUser) | **DELETE** /v1/provisioning/scim/Users/{userId} | Delete SCIM user [**scimGetGroup**](ManagementApi.md#scimGetGroup) | **GET** /v1/provisioning/scim/Groups/{groupId} | Get SCIM group [**scimGetGroups**](ManagementApi.md#scimGetGroups) | **GET** /v1/provisioning/scim/Groups | List SCIM groups [**scimGetResourceTypes**](ManagementApi.md#scimGetResourceTypes) | **GET** /v1/provisioning/scim/ResourceTypes | List supported SCIM resource types [**scimGetSchemas**](ManagementApi.md#scimGetSchemas) | **GET** /v1/provisioning/scim/Schemas | List supported SCIM schemas [**scimGetServiceProviderConfig**](ManagementApi.md#scimGetServiceProviderConfig) | **GET** /v1/provisioning/scim/ServiceProviderConfig | Get SCIM service provider configuration [**scimGetUser**](ManagementApi.md#scimGetUser) | **GET** /v1/provisioning/scim/Users/{userId} | Get SCIM user [**scimGetUsers**](ManagementApi.md#scimGetUsers) | **GET** /v1/provisioning/scim/Users | List SCIM users [**scimPatchGroup**](ManagementApi.md#scimPatchGroup) | **PATCH** /v1/provisioning/scim/Groups/{groupId} | Update SCIM group attributes [**scimPatchUser**](ManagementApi.md#scimPatchUser) | **PATCH** /v1/provisioning/scim/Users/{userId} | Update SCIM user attributes [**scimReplaceGroupAttributes**](ManagementApi.md#scimReplaceGroupAttributes) | **PUT** /v1/provisioning/scim/Groups/{groupId} | Update SCIM group [**scimReplaceUserAttributes**](ManagementApi.md#scimReplaceUserAttributes) | **PUT** /v1/provisioning/scim/Users/{userId} | Update SCIM user [**searchCouponsAdvancedApplicationWideWithoutTotalCount**](ManagementApi.md#searchCouponsAdvancedApplicationWideWithoutTotalCount) | **POST** /v1/applications/{applicationId}/coupons_search_advanced/no_total | List coupons that match the given attributes (without total count) [**searchCouponsAdvancedWithoutTotalCount**](ManagementApi.md#searchCouponsAdvancedWithoutTotalCount) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/coupons_search_advanced/no_total | List coupons that match the given attributes in campaign (without total count) [**summarizeCampaignStoreBudget**](ManagementApi.md#summarizeCampaignStoreBudget) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/stores/budgets/summary | Get summary of campaign store budgets [**transferLoyaltyCard**](ManagementApi.md#transferLoyaltyCard) | **PUT** /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/transfer | Transfer card data [**updateAccountCollection**](ManagementApi.md#updateAccountCollection) | **PUT** /v1/collections/{collectionId} | Update account-level collection [**updateAchievement**](ManagementApi.md#updateAchievement) | **PUT** /v1/applications/{applicationId}/campaigns/{campaignId}/achievements/{achievementId} | Update achievement [**updateAchievementV2**](ManagementApi.md#updateAchievementV2) | **PUT** /v2/achievements/{achievementId} | Update achievement [**updateAdditionalCost**](ManagementApi.md#updateAdditionalCost) | **PUT** /v1/additional_costs/{additionalCostId} | Update additional cost [**updateAttribute**](ManagementApi.md#updateAttribute) | **PUT** /v1/attributes/{attributeId} | Update custom attribute [**updateCampaign**](ManagementApi.md#updateCampaign) | **PUT** /v1/applications/{applicationId}/campaigns/{campaignId} | Update campaign [**updateCollection**](ManagementApi.md#updateCollection) | **PUT** /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId} | Update campaign-level collection's description [**updateCoupon**](ManagementApi.md#updateCoupon) | **PUT** /v1/applications/{applicationId}/campaigns/{campaignId}/coupons/{couponId} | Update coupon [**updateCouponBatch**](ManagementApi.md#updateCouponBatch) | **PUT** /v1/applications/{applicationId}/campaigns/{campaignId}/coupons | Update coupons [**updateLoyaltyCard**](ManagementApi.md#updateLoyaltyCard) | **PUT** /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId} | Update loyalty card [**updateReferral**](ManagementApi.md#updateReferral) | **PUT** /v1/applications/{applicationId}/campaigns/{campaignId}/referrals/{referralId} | Update referral [**updateRoleV2**](ManagementApi.md#updateRoleV2) | **PUT** /v2/roles/{roleId} | Update role [**updateStore**](ManagementApi.md#updateStore) | **PUT** /v1/applications/{applicationId}/stores/{storeId} | Update store [**updateUser**](ManagementApi.md#updateUser) | **PUT** /v1/users/{userId} | Update user ## activateUserByEmail > activateUserByEmail(body) Enable user by email address Enable a [disabled user](https://docs.talon.one/docs/product/account/account-settings/managing-users#disabling-a-user) by their email address. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.DeleteUserRequest(); // DeleteUserRequest | body apiInstance.activateUserByEmail(body).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | **DeleteUserRequest**| body | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: Not defined ## addLoyaltyCardPoints > addLoyaltyCardPoints(loyaltyProgramId, loyaltyCardId, body) Add points to card Add points to the given loyalty card in the specified card-based loyalty program. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. let loyaltyCardId = "loyaltyCardId_example"; // String | Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. let body = new TalonOne.AddLoyaltyPoints(); // AddLoyaltyPoints | body apiInstance.addLoyaltyCardPoints(loyaltyProgramId, loyaltyCardId, body).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. | **loyaltyCardId** | **String**| Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. | **body** | [**AddLoyaltyPoints**](AddLoyaltyPoints.md)| body | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## addLoyaltyPoints > addLoyaltyPoints(loyaltyProgramId, integrationId, body) Add points to customer profile Add points in the specified loyalty program for the given customer. To get the `integrationId` of the profile from a `sessionId`, use the [Update customer session](https://docs.talon.one/integration-api#tag/Customer-sessions/operation/updateCustomerSessionV2) endpoint. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = "loyaltyProgramId_example"; // String | The identifier for the loyalty program. let integrationId = "integrationId_example"; // String | The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. let body = new TalonOne.AddLoyaltyPoints(); // AddLoyaltyPoints | body apiInstance.addLoyaltyPoints(loyaltyProgramId, integrationId, body).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **String**| The identifier for the loyalty program. | **integrationId** | **String**| The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. | **body** | [**AddLoyaltyPoints**](AddLoyaltyPoints.md)| body | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## copyCampaignToApplications > InlineResponse2009 copyCampaignToApplications(applicationId, campaignId, body) Copy the campaign into the specified Application Copy the campaign into all specified Applications. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let body = new TalonOne.CampaignCopy(); // CampaignCopy | body apiInstance.copyCampaignToApplications(applicationId, campaignId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **body** | [**CampaignCopy**](CampaignCopy.md)| body | ### Return type [**InlineResponse2009**](InlineResponse2009.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createAccountCollection > Collection createAccountCollection(body) Create account-level collection Create an account-level collection. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.NewCollection(); // NewCollection | body apiInstance.createAccountCollection(body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**NewCollection**](NewCollection.md)| body | ### Return type [**Collection**](Collection.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createAchievement > Achievement createAchievement(applicationId, campaignId, body) Create achievement Create a new achievement in a specific campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let body = new TalonOne.CreateAchievement(); // CreateAchievement | body apiInstance.createAchievement(applicationId, campaignId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **body** | [**CreateAchievement**](CreateAchievement.md)| body | ### Return type [**Achievement**](Achievement.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createAchievementV2 > AchievementV2 createAchievementV2(body) Create achievement Create a new account-level achievement. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.CreateAchievementV2(); // CreateAchievementV2 | body apiInstance.createAchievementV2(body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**CreateAchievementV2**](CreateAchievementV2.md)| body | ### Return type [**AchievementV2**](AchievementV2.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createAdditionalCost > AccountAdditionalCost createAdditionalCost(body) Create additional cost Create an [additional cost](https://docs.talon.one/docs/product/account/dev-tools/managing-additional-costs). These additional costs are shared across all applications in your account, and are never required. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.NewAdditionalCost(); // NewAdditionalCost | body apiInstance.createAdditionalCost(body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**NewAdditionalCost**](NewAdditionalCost.md)| body | ### Return type [**AccountAdditionalCost**](AccountAdditionalCost.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createAttribute > Attribute createAttribute(body) Create custom attribute Create a _custom attribute_ in this account. [Custom attributes](https://docs.talon.one/docs/dev/concepts/attributes) allow you to add data to Talon.One domain entities like campaigns, coupons, customers and so on. These attributes can then be given values when creating/updating these entities, and these values can be used in your campaign rules. For example, you could define a `zipCode` field for customer sessions, and add a rule to your campaign that only allows certain ZIP codes. These attributes are shared across all Applications in your account and are never required. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.NewAttribute(); // NewAttribute | body apiInstance.createAttribute(body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**NewAttribute**](NewAttribute.md)| body | ### Return type [**Attribute**](Attribute.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createBatchLoyaltyCards > LoyaltyCardBatchResponse createBatchLoyaltyCards(loyaltyProgramId, body) Create loyalty cards Create a batch of loyalty cards in a specified [card-based loyalty program](https://docs.talon.one/docs/product/loyalty-programs/overview#loyalty-program-types). Customers can use loyalty cards to collect and spend loyalty points. > [!important] **Note** > - The specified card-based loyalty program must have a defined card code > format that is used to generate the loyalty card codes. > - Trying to create more than 20,000 loyalty cards in a single request > returns an error message with a `400` status code. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let body = new TalonOne.LoyaltyCardBatch(); // LoyaltyCardBatch | body apiInstance.createBatchLoyaltyCards(loyaltyProgramId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **body** | [**LoyaltyCardBatch**](LoyaltyCardBatch.md)| body | ### Return type [**LoyaltyCardBatchResponse**](LoyaltyCardBatchResponse.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createCampaignFromTemplate > CreateTemplateCampaignResponse createCampaignFromTemplate(applicationId, body) Create campaign from campaign template Use the campaign template referenced in the request body to create a new campaign in one of the connected Applications. If the template was created from a campaign with rules referencing [campaign collections](https://docs.talon.one/docs/product/campaigns/managing-collections), the corresponding collections for the new campaign are created automatically. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let body = new TalonOne.CreateTemplateCampaign(); // CreateTemplateCampaign | body apiInstance.createCampaignFromTemplate(applicationId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **body** | [**CreateTemplateCampaign**](CreateTemplateCampaign.md)| body | ### Return type [**CreateTemplateCampaignResponse**](CreateTemplateCampaignResponse.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createCampaignStoreBudget > createCampaignStoreBudget(applicationId, campaignId, body) Create campaign store budget Create a new store budget for a given campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let body = new TalonOne.NewCampaignStoreBudget(); // NewCampaignStoreBudget | body apiInstance.createCampaignStoreBudget(applicationId, campaignId, body).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **body** | [**NewCampaignStoreBudget**](NewCampaignStoreBudget.md)| body | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createCollection > Collection createCollection(applicationId, campaignId, body) Create campaign-level collection Create a campaign-level collection in a given campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let body = new TalonOne.NewCampaignCollection(); // NewCampaignCollection | body apiInstance.createCollection(applicationId, campaignId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **body** | [**NewCampaignCollection**](NewCampaignCollection.md)| body | ### Return type [**Collection**](Collection.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createCoupons > InlineResponse20011 createCoupons(applicationId, campaignId, body, opts) Create coupons Create coupons according to some pattern. Up to 20.000 coupons can be created without a unique prefix. When a unique prefix is provided, up to 200.000 coupons can be created. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let body = new TalonOne.NewCoupons(); // NewCoupons | body let opts = { 'silent': "'yes'" // String | Possible values: `yes` or `no`. - `yes`: Increases the performance of the API call by returning a 204 response. - `no`: Returns a 200 response that contains the updated customer profiles. }; apiInstance.createCoupons(applicationId, campaignId, body, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **body** | [**NewCoupons**](NewCoupons.md)| body | **silent** | **String**| Possible values: `yes` or `no`. - `yes`: Increases the performance of the API call by returning a 204 response. - `no`: Returns a 200 response that contains the updated customer profiles. | [optional] [default to 'yes'] ### Return type [**InlineResponse20011**](InlineResponse20011.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createCouponsAsync > AsyncCouponCreationResponse createCouponsAsync(applicationId, campaignId, body) Create coupons asynchronously Create up to 5,000,000 coupons asynchronously. You should typically use this enpdoint when you create at least 20,001 coupons. You receive an email when the creation is complete. If you want to create less than 20,001 coupons, you can use the [Create coupons](https://docs.talon.one/management-api#tag/Coupons/operation/createCoupons) endpoint. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let body = new TalonOne.NewCouponCreationJob(); // NewCouponCreationJob | body apiInstance.createCouponsAsync(applicationId, campaignId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **body** | [**NewCouponCreationJob**](NewCouponCreationJob.md)| body | ### Return type [**AsyncCouponCreationResponse**](AsyncCouponCreationResponse.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createCouponsDeletionJob > AsyncCouponDeletionJobResponse createCouponsDeletionJob(applicationId, campaignId, body) Creates a coupon deletion job This endpoint handles creating a job to delete coupons asynchronously. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let body = new TalonOne.NewCouponDeletionJob(); // NewCouponDeletionJob | body apiInstance.createCouponsDeletionJob(applicationId, campaignId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **body** | [**NewCouponDeletionJob**](NewCouponDeletionJob.md)| body | ### Return type [**AsyncCouponDeletionJobResponse**](AsyncCouponDeletionJobResponse.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createCouponsForMultipleRecipients > InlineResponse20011 createCouponsForMultipleRecipients(applicationId, campaignId, body, opts) Create coupons for multiple recipients Create coupons according to some pattern for up to 1000 recipients. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let body = new TalonOne.NewCouponsForMultipleRecipients(); // NewCouponsForMultipleRecipients | body let opts = { 'silent': "'yes'" // String | Possible values: `yes` or `no`. - `yes`: Increases the performance of the API call by returning a 204 response. - `no`: Returns a 200 response that contains the updated customer profiles. }; apiInstance.createCouponsForMultipleRecipients(applicationId, campaignId, body, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **body** | [**NewCouponsForMultipleRecipients**](NewCouponsForMultipleRecipients.md)| body | **silent** | **String**| Possible values: `yes` or `no`. - `yes`: Increases the performance of the API call by returning a 204 response. - `no`: Returns a 200 response that contains the updated customer profiles. | [optional] [default to 'yes'] ### Return type [**InlineResponse20011**](InlineResponse20011.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createInviteEmail > NewInviteEmail createInviteEmail(body) Resend invitation email Resend an email invitation to an existing user. > [!note] The invitation token is valid for 24 hours after the email has been sent. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.NewInviteEmail(); // NewInviteEmail | body apiInstance.createInviteEmail(body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**NewInviteEmail**](NewInviteEmail.md)| body | ### Return type [**NewInviteEmail**](NewInviteEmail.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createInviteV2 > User createInviteV2(body) Invite user Create a new user in the account and send an invitation to their email address. > [!note] The invitation token is valid for 24 hours after the email has > been sent. You can resend an invitation to a user with the [Resend > invitation email](https://docs.talon.one/management-api#tag/Accounts-and-users/operation/createInviteEmail) > endpoint. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.NewInvitation(); // NewInvitation | body apiInstance.createInviteV2(body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**NewInvitation**](NewInvitation.md)| body | ### Return type [**User**](User.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createPasswordRecoveryEmail > NewPasswordEmail createPasswordRecoveryEmail(body) Request a password reset Send an email with a password recovery link to the email address of an existing account. > [!note] The password recovery link expires 30 minutes after this endpoint is triggered. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.NewPasswordEmail(); // NewPasswordEmail | body apiInstance.createPasswordRecoveryEmail(body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**NewPasswordEmail**](NewPasswordEmail.md)| body | ### Return type [**NewPasswordEmail**](NewPasswordEmail.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createRulesetV2 > RulesetV2 createRulesetV2(applicationId, campaignId, body) Create ruleset (V2) Create a ruleset from promotion and strikethrough rules in the V2 JSON block format. A ruleset is a revision of all the rules of a campaign. Only `group` and `passthrough` blocks are currently writable, with optional `onFailure` blocks. A payload containing any other block type is rejected. Each rule's `blocks` array may contain at most one block. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let body = new TalonOne.RulesetV2(); // RulesetV2 | body apiInstance.createRulesetV2(applicationId, campaignId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **body** | [**RulesetV2**](RulesetV2.md)| body | ### Return type [**RulesetV2**](RulesetV2.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createSession > Session createSession(body) Create session Create a session to use the Management API endpoints. Use the value of the `token` property provided in the response as bearer token in other API calls. A token is valid for 3 months. In accordance with best pratices, use your generated token for all your API requests. Do **not** regenerate a token for each request. This endpoint has a rate limit of 3 to 6 requests per second per account, depending on your setup. > [!note] > Instead of using a session, you can also use the <a href=\"https://docs.talon.one/docs/product/account/dev-tools/managing-mapi-keys\">Management API key feature</a> > in the Campaign Manager to decide which endpoints can be used with a given key. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.LoginParams(); // LoginParams | body apiInstance.createSession(body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**LoginParams**](LoginParams.md)| body | ### Return type [**Session**](Session.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## createStore > Store createStore(applicationId, body) Create store Create a new store in a specific Application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let body = new TalonOne.NewStore(); // NewStore | body apiInstance.createStore(applicationId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **body** | [**NewStore**](NewStore.md)| body | ### Return type [**Store**](Store.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## deactivateUserByEmail > deactivateUserByEmail(body) Disable user by email address [Disable a specific user](https://docs.talon.one/docs/product/account/account-settings/managing-users#disabling-a-user) by their email address. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.DeleteUserRequest(); // DeleteUserRequest | body apiInstance.deactivateUserByEmail(body).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | **DeleteUserRequest**| body | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: Not defined ## deductLoyaltyCardPoints > deductLoyaltyCardPoints(loyaltyProgramId, loyaltyCardId, body) Deduct points from card Deduct points from the given loyalty card in the specified card-based loyalty program. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let loyaltyCardId = "loyaltyCardId_example"; // String | Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. let body = new TalonOne.DeductLoyaltyPoints(); // DeductLoyaltyPoints | body apiInstance.deductLoyaltyCardPoints(loyaltyProgramId, loyaltyCardId, body).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **loyaltyCardId** | **String**| Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. | **body** | [**DeductLoyaltyPoints**](DeductLoyaltyPoints.md)| body | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## deleteAccountCollection > deleteAccountCollection(collectionId) Delete account-level collection Delete a given account-level collection. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let collectionId = 789; // Number | The ID of the collection. You can get it with the [List collections in account](#tag/Collections/operation/listAccountCollections) endpoint. apiInstance.deleteAccountCollection(collectionId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **collectionId** | **Number**| The ID of the collection. You can get it with the [List collections in account](#tag/Collections/operation/listAccountCollections) endpoint. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## deleteAchievement > deleteAchievement(applicationId, campaignId, achievementId) Delete achievement Delete the specified achievement. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let achievementId = 789; // Number | The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievements) endpoint. apiInstance.deleteAchievement(applicationId, campaignId, achievementId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **achievementId** | **Number**| The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievements) endpoint. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## deleteAchievementV2 > deleteAchievementV2(achievementId) Delete achievement Delete a specific achievement. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let achievementId = 789; // Number | The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievementsV2) endpoint. apiInstance.deleteAchievementV2(achievementId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **achievementId** | **Number**| The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievementsV2) endpoint. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## deleteCampaign > deleteCampaign(applicationId, campaignId) Delete campaign Delete the given campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. apiInstance.deleteCampaign(applicationId, campaignId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: Not defined ## deleteCampaignStoreBudgets > deleteCampaignStoreBudgets(applicationId, campaignId, opts) Delete campaign store budgets Delete the store budgets for a given campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'action': "action_example", // String | The action that this budget is limiting. 'period': "period_example" // String | The period to which the limit applies. **Note**: For budgets with no period, set this to `overall`. }; apiInstance.deleteCampaignStoreBudgets(applicationId, campaignId, opts).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **action** | **String**| The action that this budget is limiting. | [optional] **period** | **String**| The period to which the limit applies. **Note**: For budgets with no period, set this to `overall`. | [optional] ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## deleteCollection > deleteCollection(applicationId, campaignId, collectionId) Delete campaign-level collection Delete a given campaign-level collection. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let collectionId = 789; // Number | The ID of the collection. You can get it with the [List collections in Application](#tag/Collections/operation/listCollectionsInApplication) endpoint. apiInstance.deleteCollection(applicationId, campaignId, collectionId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **collectionId** | **Number**| The ID of the collection. You can get it with the [List collections in Application](#tag/Collections/operation/listCollectionsInApplication) endpoint. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## deleteCoupon > deleteCoupon(applicationId, campaignId, couponId) Delete coupon Delete the specified coupon. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let couponId = "couponId_example"; // String | The internal ID of the coupon code. You can find this value in the `id` property from the [List coupons](https://docs.talon.one/management-api#tag/Coupons/operation/getCouponsWithoutTotalCount) endpoint response. apiInstance.deleteCoupon(applicationId, campaignId, couponId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **couponId** | **String**| The internal ID of the coupon code. You can find this value in the `id` property from the [List coupons](https://docs.talon.one/management-api#tag/Coupons/operation/getCouponsWithoutTotalCount) endpoint response. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: Not defined ## deleteCoupons > deleteCoupons(applicationId, campaignId, opts) Delete coupons Deletes all the coupons matching the specified criteria. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'value': "value_example", // String | Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'startsAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon start date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'startsBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon start date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'expiresAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon expiration date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'expiresBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon expiration date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'valid': "valid_example", // String | - `expired`: Matches coupons in which the expiration date is set and in the past. - `validNow`: Matches coupons in which start date is null or in the past and expiration date is null or in the future. - `validFuture`: Matches coupons in which start date is set and in the future. 'batchId': "batchId_example", // String | Filter results by batches of coupons 'usable': "usable_example", // String | - `true`: only coupons where `usageCounter < usageLimit` will be returned. - `false`: only coupons where `usageCounter >= usageLimit` will be returned. 'referralId': 789, // Number | Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. 'recipientIntegrationId': "recipientIntegrationId_example", // String | Filter results by match with a profile ID specified in the coupon's `RecipientIntegrationId` field. 'exactMatch': false // Boolean | Filter results to an exact case-insensitive matching against the coupon code }; apiInstance.deleteCoupons(applicationId, campaignId, opts).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **value** | **String**| Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. | [optional] **createdBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **createdAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **startsAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon start date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **startsBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon start date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **expiresAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon expiration date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **expiresBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon expiration date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **valid** | **String**| - `expired`: Matches coupons in which the expiration date is set and in the past. - `validNow`: Matches coupons in which start date is null or in the past and expiration date is null or in the future. - `validFuture`: Matches coupons in which start date is set and in the future. | [optional] **batchId** | **String**| Filter results by batches of coupons | [optional] **usable** | **String**| - `true`: only coupons where `usageCounter < usageLimit` will be returned. - `false`: only coupons where `usageCounter >= usageLimit` will be returned. | [optional] **referralId** | **Number**| Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. | [optional] **recipientIntegrationId** | **String**| Filter results by match with a profile ID specified in the coupon's `RecipientIntegrationId` field. | [optional] **exactMatch** | **Boolean**| Filter results to an exact case-insensitive matching against the coupon code | [optional] [default to false] ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: Not defined ## deleteLoyaltyCard > deleteLoyaltyCard(loyaltyProgramId, loyaltyCardId) Delete loyalty card Delete the given loyalty card. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let loyaltyCardId = "loyaltyCardId_example"; // String | Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. apiInstance.deleteLoyaltyCard(loyaltyProgramId, loyaltyCardId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **loyaltyCardId** | **String**| Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## deleteReferral > deleteReferral(applicationId, campaignId, referralId) Delete referral Delete the specified referral. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let referralId = "referralId_example"; // String | The ID of the referral code. apiInstance.deleteReferral(applicationId, campaignId, referralId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **referralId** | **String**| The ID of the referral code. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: Not defined ## deleteStore > deleteStore(applicationId, storeId) Delete store Delete the specified store. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let storeId = "storeId_example"; // String | The ID of the store. You can get this ID with the [List stores](#tag/Stores/operation/listStores) endpoint. apiInstance.deleteStore(applicationId, storeId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **storeId** | **String**| The ID of the store. You can get this ID with the [List stores](#tag/Stores/operation/listStores) endpoint. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## deleteUser > deleteUser(userId) Delete user Delete a specific user. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let userId = 789; // Number | The ID of the user. apiInstance.deleteUser(userId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **userId** | **Number**| The ID of the user. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: Not defined ## deleteUserByEmail > deleteUserByEmail(body) Delete user by email address [Delete a specific user](https://docs.talon.one/docs/product/account/account-settings/managing-users#deleting-a-user) by their email address. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.DeleteUserRequest(); // DeleteUserRequest | body apiInstance.deleteUserByEmail(body).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**DeleteUserRequest**](DeleteUserRequest.md)| body | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: Not defined ## destroySession > destroySession() Destroy session Destroys the session. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); apiInstance.destroySession().then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters This endpoint does not need any parameter. ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: Not defined ## disconnectCampaignStores > disconnectCampaignStores(applicationId, campaignId) Disconnect stores Disconnect the stores linked to a specific campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. apiInstance.disconnectCampaignStores(applicationId, campaignId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## excludePriceHistory > excludePriceHistory(applicationId, body) Exclude price records from price history Select a batch of historical price IDs to exclude from [best prior price calculation](https://docs.talon.one/integration-api#tag/Catalogs/operation/bestPriorPrice). All IDs in the batch must be valid `id` values obtained from the [Get summary of price history](https://docs.talon.one/management-api#tag/Catalogs/operation/priceHistory.responses.200.history) endpoint, must belong to the specified Application, must not already be excluded from best prior price calculation, and must not be associated with a scheduled strikethrough pricing notification. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let body = new TalonOne.ExcludePriceObservationsRequest(); // ExcludePriceObservationsRequest | body apiInstance.excludePriceHistory(applicationId, body).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **body** | [**ExcludePriceObservationsRequest**](ExcludePriceObservationsRequest.md)| body | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: Not defined ## exportAccountCollectionItems > String exportAccountCollectionItems(collectionId) Export account-level collection's items Download a CSV file containing items from a given account-level collection. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let collectionId = 789; // Number | The ID of the collection. You can get it with the [List collections in account](#tag/Collections/operation/listAccountCollections) endpoint. apiInstance.exportAccountCollectionItems(collectionId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **collectionId** | **Number**| The ID of the collection. You can get it with the [List collections in account](#tag/Collections/operation/listAccountCollections) endpoint. | ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportAchievementV2 > String exportAchievementV2(achievementId) Export achievement customer data Download a CSV file containing a list of all the customers who have participated in and are currently participating in the given achievement. The CSV file contains the following columns: - `profileIntegrationID`: The integration ID of the customer profile participating in the achievement. - `title`: The display name of the achievement in the Campaign Manager. - `target`: The required number of actions or the transactional milestone to complete the achievement. - `progress`: The current progress of the customer in the achievement. - `status`: The status of the achievement. Can be one of: ['inprogress', 'completed', 'expired']. - `startDate`: The date on which the customer profile started the achievement in RFC3339. - `endDate`: The date on which the achievement ends and resets for the customer profile in RFC3339. - `completionDate`: The date on which the customer profile completed the achievement in RFC3339. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let achievementId = 789; // Number | The ID of the achievement. You can get this ID with the [List achievements](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievementsV2) endpoint. apiInstance.exportAchievementV2(achievementId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **achievementId** | **Number**| The ID of the achievement. You can get this ID with the [List achievements](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievementsV2) endpoint. | ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportAchievements > String exportAchievements(applicationId, campaignId, achievementId) Export achievement customer data Download a CSV file containing a list of all the customers who have participated in and are currently participating in the given achievement. The CSV file contains the following columns: - `profileIntegrationID`: The integration ID of the customer profile participating in the achievement. - `title`: The display name of the achievement in the Campaign Manager. - `target`: The required number of actions or the transactional milestone to complete the achievement. - `progress`: The current progress of the customer in the achievement. - `status`: The status of the achievement. Can be one of: ['inprogress', 'completed', 'expired']. - `startDate`: The date on which the customer profile started the achievement in RFC3339. - `endDate`: The date on which the achievement ends and resets for the customer profile in RFC3339. - `completionDate`: The date on which the customer profile completed the achievement in RFC3339. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let achievementId = 789; // Number | The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievements) endpoint. apiInstance.exportAchievements(applicationId, campaignId, achievementId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **achievementId** | **Number**| The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievements) endpoint. | ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportApplicationCampaignAnalytics > String exportApplicationCampaignAnalytics(applicationId, rangeStart, rangeEnd, opts) Export Application analytics aggregated by campaign Download a CSV file containing analytics data aggregated by campaign for the campaigns of an Application. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The CSV file contains the following columns: - `campaign_id`: The ID of the campaign. This column also contains labels for the [total and influenced values](https://docs.talon.one/docs/product/campaigns/analytics/application-dashboard#display-the-analytics-data). - `start_date`: The start of the aggregation time frame in UTC. - `end_date`: The end of the aggregation time frame in UTC. - `revenue`: The total, pre-discount value of all items purchased in a customer session. - `sessions`: The number of all closed sessions. - `average_session_value`: The average customer session value, calculated by dividing the revenue value by the number of sessions. - `average_items_per_session`: The number of items from sessions divided by the number of sessions. - `coupons`: The number of times a coupon was successfully redeemed in sessions. - `discounts`: The total value of discounts given for cart items in sessions. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let rangeStart = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let rangeEnd = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let opts = { 'campaignIds': ["null"] // [String] | Filter by one or more Campaign IDs, separated by a comma. **Note:** If no campaigns are specified, data for all the campaigns in the Application is returned. }; apiInstance.exportApplicationCampaignAnalytics(applicationId, rangeStart, rangeEnd, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **rangeStart** | **Date**| Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **rangeEnd** | **Date**| Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **campaignIds** | [**[String]**](String.md)| Filter by one or more Campaign IDs, separated by a comma. **Note:** If no campaigns are specified, data for all the campaigns in the Application is returned. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportAudiencesMemberships > String exportAudiencesMemberships(audienceId) Export audience members Download a CSV file containing the integration IDs of the members of an audience. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The file contains the following column: - `profileintegrationid`: The integration ID of the customer profile. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let audienceId = 789; // Number | The ID of the audience. apiInstance.exportAudiencesMemberships(audienceId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **audienceId** | **Number**| The ID of the audience. | ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportCampaignStoreBudgets > String exportCampaignStoreBudgets(applicationId, campaignId, opts) Export campaign store budgets Download a CSV file containing the store budgets for a given campaign. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The CSV file contains the following columns: - `store_integration_id`: The identifier of the store. - `limit`: The budget limit for the store. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'action': "action_example", // String | The action that this budget is limiting. 'period': "period_example" // String | The period to which the limit applies. **Note**: For budgets with no period, set this to `overall`. }; apiInstance.exportCampaignStoreBudgets(applicationId, campaignId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **action** | **String**| The action that this budget is limiting. | [optional] **period** | **String**| The period to which the limit applies. **Note**: For budgets with no period, set this to `overall`. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportCampaignStores > String exportCampaignStores(applicationId, campaignId) Export stores Download a CSV file containing the stores linked to a specific campaign. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The CSV file contains the following column: - `store_integration_id`: The identifier of the store. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. apiInstance.exportCampaignStores(applicationId, campaignId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportCampaignValueMap > String exportCampaignValueMap(applicationId, campaignId, valueMapId) Export campaign value map Download a CSV file containing all the value map items in a campaign. If there are multiple versions of the value map, only the items of the current version are exported. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The generated file can contain the following columns: - `identifier`: The value of the attribute in the targeted item, for example, an item's SKU. - `value`: The value that is associated with the identifier, for example, the item's price. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let valueMapId = 789; // Number | The ID of the value map. apiInstance.exportCampaignValueMap(applicationId, campaignId, valueMapId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **valueMapId** | **Number**| The ID of the value map. | ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv, application/json ## exportCollectionItems > String exportCollectionItems(applicationId, campaignId, collectionId) Export campaign-level collection's items Download a CSV file containing items from a given campaign-level collection. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let collectionId = 789; // Number | The ID of the collection. You can get it with the [List collections in Application](#tag/Collections/operation/listCollectionsInApplication) endpoint. apiInstance.exportCollectionItems(applicationId, campaignId, collectionId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **collectionId** | **Number**| The ID of the collection. You can get it with the [List collections in Application](#tag/Collections/operation/listCollectionsInApplication) endpoint. | ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportCoupons > String exportCoupons(applicationId, opts) Export coupons Download a CSV file containing the coupons that match the given properties. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The CSV file can contain the following columns: - `accountid`: The ID of your deployment. - `applicationid`: The ID of the Application this coupon is related to. - `attributes`: A json object describing _custom_ referral attribute names and their values. - `batchid`: The ID of the batch this coupon is part of. - `campaignid`: The ID of the campaign this coupon is related to. - `counter`: The number of times this coupon has been redeemed. - `created`: The creation date in RFC3339 of the coupon code. - `deleted`: Whether the coupon code is deleted. - `deleted_changelogid`: The ID of the delete event in the logs. - `discount_counter`: The amount of discount given by this coupon. - `discount_limitval`: The maximum discount amount that can be given be this coupon. - `expirydate`: The end date in RFC3339 of the code redemption period. - `id`: The internal ID of the coupon code. - `importid`: The ID of the import job that created this coupon. - `is_reservation_mandatory`: Whether this coupon requires a reservation to be redeemed. - `limits`: The limits set on this coupon. - `limitval`: The maximum number of redemptions of this code. - `recipientintegrationid`: The integration ID of the recipient of the coupon. Only the customer with this integration ID can redeem this code. Available only for personal codes. - `referralid`: The ID of the referral code that triggered the creation of this coupon (create coupon effect). - `reservation`: Whether the coupon can be reserved for multiple customers. - `reservation_counter`: How many times this coupon has been reserved. - `reservation_limitval`: The maximum of number of reservations this coupon can have. - `startdate`: The start date in RFC3339 of the code redemption period. - `value`: The coupon code. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'campaignId': 3.4, // Number | Filter results by campaign ID. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'value': "value_example", // String | Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'valid': "valid_example", // String | Either \"expired\", \"validNow\", or \"validFuture\". The first option matches coupons in which the expiration date is set and in the past. The second matches coupons in which start date is null or in the past and expiration date is null or in the future, the third matches coupons in which start date is set and in the future. 'usable': "usable_example", // String | Either \"true\" or \"false\". If \"true\", only coupons where `usageCounter < usageLimit` will be returned, \"false\" will return only coupons where `usageCounter >= usageLimit`. 'referralId': 789, // Number | Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. 'recipientIntegrationId': "recipientIntegrationId_example", // String | Filter results by match with a profile id specified in the coupon's RecipientIntegrationId field. 'batchId': "batchId_example", // String | Filter results by batches of coupons 'exactMatch': false, // Boolean | Filter results to an exact case-insensitive matching against the coupon code. 'dateFormat': "dateFormat_example", // String | Determines the format of dates in the export document. 'campaignState': "campaignState_example", // String | Filter results by the state of the campaign. - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. 'valuesOnly': false, // Boolean | Filter results to only return the coupon codes (`value` column) without the associated coupon data. 'deletedBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Timestamp that filters the results to only contain coupons deleted before this date. Must be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally. **Note:** Only coupons deleted in the last 7 days will appear in the results. 'deletedAfter': new Date("2013-10-20T19:20:30+01:00") // Date | Timestamp that filters the results to only contain coupons deleted after this date. Must be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally. **Note:** Only coupons deleted in the last 7 days will appear in the results. }; apiInstance.exportCoupons(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| Filter results by campaign ID. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **value** | **String**| Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. | [optional] **createdBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **createdAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **valid** | **String**| Either \"expired\", \"validNow\", or \"validFuture\". The first option matches coupons in which the expiration date is set and in the past. The second matches coupons in which start date is null or in the past and expiration date is null or in the future, the third matches coupons in which start date is set and in the future. | [optional] **usable** | **String**| Either \"true\" or \"false\". If \"true\", only coupons where `usageCounter < usageLimit` will be returned, \"false\" will return only coupons where `usageCounter >= usageLimit`. | [optional] **referralId** | **Number**| Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. | [optional] **recipientIntegrationId** | **String**| Filter results by match with a profile id specified in the coupon's RecipientIntegrationId field. | [optional] **batchId** | **String**| Filter results by batches of coupons | [optional] **exactMatch** | **Boolean**| Filter results to an exact case-insensitive matching against the coupon code. | [optional] [default to false] **dateFormat** | **String**| Determines the format of dates in the export document. | [optional] **campaignState** | **String**| Filter results by the state of the campaign. - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. | [optional] **valuesOnly** | **Boolean**| Filter results to only return the coupon codes (`value` column) without the associated coupon data. | [optional] [default to false] **deletedBefore** | **Date**| Timestamp that filters the results to only contain coupons deleted before this date. Must be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally. **Note:** Only coupons deleted in the last 7 days will appear in the results. | [optional] **deletedAfter** | **Date**| Timestamp that filters the results to only contain coupons deleted after this date. Must be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally. **Note:** Only coupons deleted in the last 7 days will appear in the results. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportCustomerSessions > String exportCustomerSessions(applicationId, opts) Export customer sessions Download a CSV file containing the customer sessions that match the request. > [!important] Archived sessions cannot be exported. See the [retention > policy](https://docs.talon.one/docs/dev/server-infrastructure-and-data-retention). > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). - `id`: The internal ID of the session. - `firstsession`: Whether this is a first session. - `integrationid`: The integration ID of the session. - `applicationid`: The ID of the Application. - `profileid`: The internal ID of the customer profile. - `profileintegrationid`: The integration ID of the customer profile. - `created`: The timestamp when the session was created. - `state`: The [state](https://docs.talon.one/docs/dev/concepts/entities/customer-sessions#customer-session-states) of the session. - `cartitems`: The cart items in the session. - `discounts`: The discounts in the session. - `total`: The total value of cart items and additional costs in the session, before any discounts are applied. - `attributes`: The attributes set in the session. - `closedat`: Timestamp when the session was closed. - `cancelledat`: Timestamp when the session was cancelled. - `referral`: The referral code in the session. - `identifiers`: The identifiers in the session. - `additional_costs`: The [additional costs](https://docs.talon.one/docs/product/account/dev-tools/managing-additional-costs) in the session. - `updated`: Timestamp of the last session update. - `store_integration_id`: The integration ID of the store. - `coupons`: Coupon codes in the session. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. 'updatedBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. 'updatedAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. 'profileIntegrationId': "profileIntegrationId_example", // String | Only return sessions for the customer that matches this customer integration ID. 'dateFormat': "dateFormat_example", // String | Determines the format of dates in the export document. 'customerSessionState': "customerSessionState_example" // String | Filter results by state. }; apiInstance.exportCustomerSessions(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **createdBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. | [optional] **createdAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. | [optional] **updatedBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. | [optional] **updatedAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. | [optional] **profileIntegrationId** | **String**| Only return sessions for the customer that matches this customer integration ID. | [optional] **dateFormat** | **String**| Determines the format of dates in the export document. | [optional] **customerSessionState** | **String**| Filter results by state. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportCustomersTiers > String exportCustomersTiers(loyaltyProgramId, opts) Export customers' tier data Download a CSV file containing the tier information for customers of the specified loyalty program. The generated file contains the following columns: - `programid`: The identifier of the loyalty program. It is displayed in your Talon.One deployment URL. - `subledgerid`: The ID of the subledger associated with the loyalty program. This column is empty if the loyalty program has no subledger. In this case, refer to the export file name to get the ID of the loyalty program. - `customerprofileid`: The ID used to integrate customer profiles with the loyalty program. - `tiername`: The name of the tier. - `startdate`: The tier start date in RFC3339. - `expirydate`: The tier expiry date in RFC3339. You can filter the results by providing the following optional input parameters: - `subledgerIds` (optional): Filter results by an array of subledger IDs. If no value is provided, all subledger data for the specified loyalty program will be exported. - `tierNames` (optional): Filter results by an array of tier names. If no value is provided, all tier data for the specified loyalty program will be exported. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = "loyaltyProgramId_example"; // String | The identifier for the loyalty program. let opts = { 'subledgerIds': ["null"], // [String] | An array of subledgers IDs to filter the export by. 'tierNames': ["null"] // [String] | An array of tier names to filter the export by. }; apiInstance.exportCustomersTiers(loyaltyProgramId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **String**| The identifier for the loyalty program. | **subledgerIds** | [**[String]**](String.md)| An array of subledgers IDs to filter the export by. | [optional] **tierNames** | [**[String]**](String.md)| An array of tier names to filter the export by. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportEffects > String exportEffects(applicationId, opts) Export triggered effects Download a CSV file containing the triggered effects that match the given attributes. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The generated file can contain the following columns: - `applicationid`: The ID of the Application. - `campaignid`: The ID of the campaign. - `couponid`: The ID of the coupon, when applicable to the effect. - `created`: The timestamp of the effect. - `event_type`: The name of the event. See the [docs](https://docs.talon.one/docs/dev/concepts/entities/events). - `eventid`: The internal ID of the effect. - `name`: The effect name. See the [docs](https://docs.talon.one/docs/dev/integration-api/api-effects). - `profileintegrationid`: The ID of the customer profile, when applicable. - `props`: The [properties](https://docs.talon.one/docs/dev/integration-api/api-effects) of the effect. - `ruleindex`: The index of the rule. - `rulesetid`: The ID of the rule set. - `sessionid`: The internal ID of the session that triggered the effect. - `profileid`: The internal ID of the customer profile. - `sessionintegrationid`: The integration ID of the session. - `total_revenue`: The total revenue. - `store_integration_id`: The integration ID of the store. You choose this ID when you create a store. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'campaignId': 3.4, // Number | Filter results by campaign ID. 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally. 'dateFormat': "dateFormat_example" // String | Determines the format of dates in the export document. }; apiInstance.exportEffects(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| Filter results by campaign ID. | [optional] **createdBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **createdAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **dateFormat** | **String**| Determines the format of dates in the export document. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportLoyaltyBalance > String exportLoyaltyBalance(loyaltyProgramId, opts) Export customer loyalty balance to CSV To export customer loyalty balances to CSV, use the [Export customer loyalty balances to CSV](/management-api#tag/Loyalty/operation/exportLoyaltyBalances) endpoint. Download a CSV file containing the balance of each customer in the loyalty program. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = "loyaltyProgramId_example"; // String | The identifier for the loyalty program. let opts = { 'endDate': new Date("2013-10-20T19:20:30+01:00"), // Date | Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 'balances': "balances_example" // String | Filters which balance fields are included in the CSV export. `currentBalance` is always returned. By default, all balance fields are included. When this parameter is provided, only the listed fields contain values and the rest are returned empty. Accepted values: - `currentBalance` - `pendingBalance` - `expiredBalance` - `spentBalance` - `negativeBalance` Multiple values must be provided as a comma-separated list. }; apiInstance.exportLoyaltyBalance(loyaltyProgramId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **String**| The identifier for the loyalty program. | **endDate** | **Date**| Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | [optional] **balances** | **String**| Filters which balance fields are included in the CSV export. `currentBalance` is always returned. By default, all balance fields are included. When this parameter is provided, only the listed fields contain values and the rest are returned empty. Accepted values: - `currentBalance` - `pendingBalance` - `expiredBalance` - `spentBalance` - `negativeBalance` Multiple values must be provided as a comma-separated list. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportLoyaltyBalances > String exportLoyaltyBalances(loyaltyProgramId, opts) Export customer loyalty balances Download a CSV file containing the balance of each customer in the loyalty program. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The generated file can contain the following columns: - `loyaltyProgramID`: The ID of the loyalty program. - `loyaltySubledger`: The name of the subledger, when applicable. - `profileIntegrationID`: The integration ID of the customer profile. - `currentBalance`: The current point balance. - `pendingBalance`: The number of pending points. - `expiredBalance`: The number of expired points. - `spentBalance`: The number of spent points. - `currentTier`: The tier that the customer is in at the time of the export. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = "loyaltyProgramId_example"; // String | The identifier for the loyalty program. let opts = { 'endDate': new Date("2013-10-20T19:20:30+01:00"), // Date | Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. > - This parameter does not affect the `currentTier` field in the CSV file, which shows the customer's tier at the time of export. 'balances': "balances_example" // String | Filters which balance fields are included in the CSV export. `currentBalance` is always returned. By default, all balance fields are included. When this parameter is provided, only the listed fields contain values and the rest are returned empty. Accepted values: - `currentBalance` - `pendingBalance` - `expiredBalance` - `spentBalance` - `negativeBalance` Multiple values must be provided as a comma-separated list. }; apiInstance.exportLoyaltyBalances(loyaltyProgramId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **String**| The identifier for the loyalty program. | **endDate** | **Date**| Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. > - This parameter does not affect the `currentTier` field in the CSV file, which shows the customer's tier at the time of export. | [optional] **balances** | **String**| Filters which balance fields are included in the CSV export. `currentBalance` is always returned. By default, all balance fields are included. When this parameter is provided, only the listed fields contain values and the rest are returned empty. Accepted values: - `currentBalance` - `pendingBalance` - `expiredBalance` - `spentBalance` - `negativeBalance` Multiple values must be provided as a comma-separated list. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportLoyaltyCardBalances > String exportLoyaltyCardBalances(loyaltyProgramId, opts) Export all card transaction logs Download a CSV file containing the balances of all cards in the loyalty program. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The CSV file contains the following columns: - `loyaltyProgramID`: The ID of the loyalty program. - `loyaltySubledger`: The name of the subdleger, when applicatble. - `cardIdentifier`: The identifier of the loyalty card, which must match the regular expression `^[A-Za-z0-9._%+@-]+$`. - `cardState`:The state of the loyalty card. It can be `active` or `inactive`. - `currentBalance`: The current point balance. - `pendingBalance`: The number of pending points. - `expiredBalance`: The number of expired points. - `spentBalance`: The number of spent points. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let opts = { 'endDate': new Date("2013-10-20T19:20:30+01:00"), // Date | Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 'balances': "balances_example" // String | Filters which balance fields are included in the CSV export. By default, all balance fields are included. When this parameter is provided, only the listed fields contain values and the rest are returned empty. Accepted values: - `currentBalance` - `pendingBalance` - `expiredBalance` - `spentBalance` - `negativeBalance` Multiple values must be provided as a comma-separated list. **Note:** - The `negativeBalance` value is not supported for card balance exports. - Providing an unsupported or invalid value returns a `400 Bad Request` error. }; apiInstance.exportLoyaltyCardBalances(loyaltyProgramId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **endDate** | **Date**| Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | [optional] **balances** | **String**| Filters which balance fields are included in the CSV export. By default, all balance fields are included. When this parameter is provided, only the listed fields contain values and the rest are returned empty. Accepted values: - `currentBalance` - `pendingBalance` - `expiredBalance` - `spentBalance` - `negativeBalance` Multiple values must be provided as a comma-separated list. **Note:** - The `negativeBalance` value is not supported for card balance exports. - Providing an unsupported or invalid value returns a `400 Bad Request` error. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportLoyaltyCardLedger > String exportLoyaltyCardLedger(loyaltyProgramId, loyaltyCardId, rangeStart, rangeEnd, opts) Export card's ledger log Download a CSV file containing a loyalty card ledger log of the loyalty program. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let loyaltyCardId = "loyaltyCardId_example"; // String | Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. let rangeStart = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let rangeEnd = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let opts = { 'dateFormat': "dateFormat_example" // String | Determines the format of dates in the export document. }; apiInstance.exportLoyaltyCardLedger(loyaltyProgramId, loyaltyCardId, rangeStart, rangeEnd, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **loyaltyCardId** | **String**| Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. | **rangeStart** | **Date**| Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **rangeEnd** | **Date**| Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **dateFormat** | **String**| Determines the format of dates in the export document. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportLoyaltyCards > String exportLoyaltyCards(loyaltyProgramId, opts) Export loyalty cards Download a CSV file containing the loyalty cards from a specified loyalty program. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The CSV file contains the following columns: - `identifier`: The unique identifier of the loyalty card. - `created`: The date and time the loyalty card was created. - `status`: The status of the loyalty card. - `userpercardlimit`: The maximum number of customer profiles that can be linked to the card. - `customerprofileids`: Integration IDs of the customer profiles linked to the card. - `blockreason`: The reason for transferring and blocking the loyalty card. - `generated`: An indicator of whether the loyalty card was generated. - `batchid`: The ID of the batch the loyalty card is in. - `attributes`: The custom attributes of this loyalty card. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let opts = { 'batchId': "batchId_example", // String | Filter results by loyalty card batch ID. 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Only return loyalty cards created before this timestamp. **Note:** This must be an RFC3339 timestamp string. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Only return loyalty cards created after this timestamp. **Note:** This must be an RFC3339 timestamp string. 'dateFormat': "dateFormat_example" // String | Determines the format of dates in the export document. }; apiInstance.exportLoyaltyCards(loyaltyProgramId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **batchId** | **String**| Filter results by loyalty card batch ID. | [optional] **createdBefore** | **Date**| Only return loyalty cards created before this timestamp. **Note:** This must be an RFC3339 timestamp string. | [optional] **createdAfter** | **Date**| Only return loyalty cards created after this timestamp. **Note:** This must be an RFC3339 timestamp string. | [optional] **dateFormat** | **String**| Determines the format of dates in the export document. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportLoyaltyJoinDates > String exportLoyaltyJoinDates(loyaltyProgramId) Export customers' loyalty program join dates Download a CSV file containing the join dates of all customers in the loyalty program. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The generated file can contain the following columns: - `loyaltyProgramID`: The ID of the loyalty program. - `profileIntegrationID`: The integration ID of the customer profile. - `joinDate`: The customer's loyalty program join date in RFC3339 format. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = "loyaltyProgramId_example"; // String | The identifier of the loyalty program. apiInstance.exportLoyaltyJoinDates(loyaltyProgramId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **String**| The identifier of the loyalty program. | ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportLoyaltyLedger > String exportLoyaltyLedger(rangeStart, rangeEnd, loyaltyProgramId, integrationId, opts) Export customer's transaction logs Download a CSV file containing a customer's transaction logs in the loyalty program. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The generated file can contain the following columns: - `customerprofileid`: The ID of the profile. - `customersessionid`: The ID of the customer session. - `rulesetid`: The ID of the rule set. - `rulename`: The name of the rule. - `programid`: The ID of the loyalty program. - `type`: The transaction type, such as `addition` or `subtraction`. - `name`: The reason for the transaction. - `subledgerid`: The ID of the subledger, when applicable. - `startdate`: The start date of the program. - `expirydate`: The expiration date of the program. - `id`: The ID of the transaction. - `created`: The timestamp of the creation of the loyalty program. - `amount`: The number of points in that transaction. - `archived`: Whether the session related to the transaction is archived. - `campaignid`: The ID of the campaign. - `flags`: The flags of the transaction, when applicable. The `createsNegativeBalance` flag indicates whether the transaction results in a negative balance. - `transactionUUID`: Unique identifier of the transaction in the UUID format. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let rangeStart = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let rangeEnd = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let loyaltyProgramId = "loyaltyProgramId_example"; // String | The identifier for the loyalty program. let integrationId = "integrationId_example"; // String | The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. let opts = { 'dateFormat': "dateFormat_example" // String | Determines the format of dates in the export document. }; apiInstance.exportLoyaltyLedger(rangeStart, rangeEnd, loyaltyProgramId, integrationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **rangeStart** | **Date**| Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **rangeEnd** | **Date**| Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **loyaltyProgramId** | **String**| The identifier for the loyalty program. | **integrationId** | **String**| The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. | **dateFormat** | **String**| Determines the format of dates in the export document. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportPoolGiveaways > String exportPoolGiveaways(poolId, opts) Export giveaway codes of a giveaway pool Download a CSV file containing the giveaway codes of a specific giveaway pool. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The CSV file contains the following columns: - `id`: The internal ID of the giveaway. - `poolid`: The internal ID of the giveaway pool. - `code`: The giveaway code. - `startdate`: The validity start date in RFC3339 of the giveaway (can be empty). - `enddate`: The validity end date in RFC3339 of the giveaway (can be empty). - `attributes`: Any custom attributes associated with the giveaway code (can be empty). - `used`: An indication of whether the giveaway is already awarded. - `importid`: The ID of the import which created the giveaway. - `created`: The creation time of the giveaway code. - `profileintegrationid`: The third-party integration ID of the customer profile that was awarded the giveaway. Can be empty if the giveaway was not awarded. - `profileid`: The internal ID of the customer profile that was awarded the giveaway. Can be empty if the giveaway was not awarded or an internal ID does not exist. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let poolId = 789; // Number | The ID of the pool. You can find it in the Campaign Manager, in the **Giveaways** section. let opts = { 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Timestamp that filters the results to only contain giveaways created before this date. Must be an RFC3339 timestamp string. 'createdAfter': new Date("2013-10-20T19:20:30+01:00") // Date | Timestamp that filters the results to only contain giveaways created after this date. Must be an RFC3339 timestamp string. }; apiInstance.exportPoolGiveaways(poolId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **poolId** | **Number**| The ID of the pool. You can find it in the Campaign Manager, in the **Giveaways** section. | **createdBefore** | **Date**| Timestamp that filters the results to only contain giveaways created before this date. Must be an RFC3339 timestamp string. | [optional] **createdAfter** | **Date**| Timestamp that filters the results to only contain giveaways created after this date. Must be an RFC3339 timestamp string. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## exportReferrals > String exportReferrals(applicationId, opts) Export referrals Download a CSV file containing the referrals that match the given parameters. > [!tip] If the exported CSV file is too large to view, you can > [split it into multiple files](https://www.google.com/search?q=split+CSV+into+multiple+files). The CSV file contains the following columns: - `code`: The referral code. - `advocateprofileintegrationid`: The profile ID of the advocate. - `startdate`: The start date in RFC3339 of the code redemption period. - `expirydate`: The end date in RFC3339 of the code redemption period. - `limitval`: The maximum number of redemptions of this code. Defaults to `1` when left blank. - `attributes`: A json object describing _custom_ referral attribute names and their values. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'campaignId': 3.4, // Number | Filter results by campaign ID. 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the referral creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the referral creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'valid': "valid_example", // String | - `expired`: Matches referrals in which the expiration date is set and in the past. - `validNow`: Matches referrals in which start date is null or in the past and expiration date is null or in the future. - `validFuture`: Matches referrals in which start date is set and in the future. 'usable': "usable_example", // String | - `true`, only referrals where `usageCounter < usageLimit` will be returned. - `false`, only referrals where `usageCounter >= usageLimit` will be returned. 'batchId': "batchId_example", // String | Filter results by batches of referrals 'dateFormat': "dateFormat_example" // String | Determines the format of dates in the export document. }; apiInstance.exportReferrals(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| Filter results by campaign ID. | [optional] **createdBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the referral creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **createdAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the referral creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **valid** | **String**| - `expired`: Matches referrals in which the expiration date is set and in the past. - `validNow`: Matches referrals in which start date is null or in the past and expiration date is null or in the future. - `validFuture`: Matches referrals in which start date is set and in the future. | [optional] **usable** | **String**| - `true`, only referrals where `usageCounter < usageLimit` will be returned. - `false`, only referrals where `usageCounter >= usageLimit` will be returned. | [optional] **batchId** | **String**| Filter results by batches of referrals | [optional] **dateFormat** | **String**| Determines the format of dates in the export document. | [optional] ### Return type **String** ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/csv ## generateCouponRejections > InlineResponse20055 generateCouponRejections(sessionIntegrationId, opts) Summarize coupon redemption failures in session Create a summary of the reasons for coupon redemption failures in a given customer session. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let sessionIntegrationId = "sessionIntegrationId_example"; // String | The integration ID of the session to summarize. let opts = { 'applicationId': 3.4, // Number | Filter results by Application ID. 'language': "language_example", // String | The [ISO-639](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) code of the language in which the summary will be generated. 'couponCode': "couponCode_example" // String | The coupon code for which to get the rejection reason. }; apiInstance.generateCouponRejections(sessionIntegrationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **sessionIntegrationId** | **String**| The integration ID of the session to summarize. | **applicationId** | **Number**| Filter results by Application ID. | [optional] **language** | **String**| The [ISO-639](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) code of the language in which the summary will be generated. | [optional] **couponCode** | **String**| The coupon code for which to get the rejection reason. | [optional] ### Return type [**InlineResponse20055**](InlineResponse20055.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAccessLogsWithoutTotalCount > InlineResponse20024 getAccessLogsWithoutTotalCount(applicationId, rangeStart, rangeEnd, opts) Get access logs for Application Retrieve the list of API calls sent to the specified Application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let rangeStart = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let rangeEnd = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let opts = { 'path': "path_example", // String | Only return results where the request path matches the given regular expression. 'method': "method_example", // String | Only return results where the request method matches the given regular expression. 'status': "status_example", // String | Filter results by HTTP status codes. 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example" // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. }; apiInstance.getAccessLogsWithoutTotalCount(applicationId, rangeStart, rangeEnd, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **rangeStart** | **Date**| Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **rangeEnd** | **Date**| Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **path** | **String**| Only return results where the request path matches the given regular expression. | [optional] **method** | **String**| Only return results where the request method matches the given regular expression. | [optional] **status** | **String**| Filter results by HTTP status codes. | [optional] **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] ### Return type [**InlineResponse20024**](InlineResponse20024.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAccount > Account getAccount(accountId) Get account details Return the details of your companies Talon.One account. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let accountId = 789; // Number | The identifier of the account. Retrieve it via the [List users in account](https://docs.talon.one/management-api#tag/Accounts-and-users/operation/getUsers) endpoint in the `accountId` property. apiInstance.getAccount(accountId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **accountId** | **Number**| The identifier of the account. Retrieve it via the [List users in account](https://docs.talon.one/management-api#tag/Accounts-and-users/operation/getUsers) endpoint in the `accountId` property. | ### Return type [**Account**](Account.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAccountAnalytics > AccountAnalytics getAccountAnalytics(accountId) Get account analytics Return the analytics of your Talon.One account. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let accountId = 789; // Number | The identifier of the account. Retrieve it via the [List users in account](https://docs.talon.one/management-api#tag/Accounts-and-users/operation/getUsers) endpoint in the `accountId` property. apiInstance.getAccountAnalytics(accountId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **accountId** | **Number**| The identifier of the account. Retrieve it via the [List users in account](https://docs.talon.one/management-api#tag/Accounts-and-users/operation/getUsers) endpoint in the `accountId` property. | ### Return type [**AccountAnalytics**](AccountAnalytics.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAccountCollection > Collection getAccountCollection(collectionId) Get account-level collection Retrieve a given account-level collection. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let collectionId = 789; // Number | The ID of the collection. You can get it with the [List collections in account](#tag/Collections/operation/listAccountCollections) endpoint. apiInstance.getAccountCollection(collectionId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **collectionId** | **Number**| The ID of the collection. You can get it with the [List collections in account](#tag/Collections/operation/listAccountCollections) endpoint. | ### Return type [**Collection**](Collection.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAchievement > Achievement getAchievement(applicationId, campaignId, achievementId) Get achievement Get the details of a specific achievement. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let achievementId = 789; // Number | The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievements) endpoint. apiInstance.getAchievement(applicationId, campaignId, achievementId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **achievementId** | **Number**| The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievements) endpoint. | ### Return type [**Achievement**](Achievement.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAchievementV2 > AchievementV2 getAchievementV2(achievementId) Get achievement Retrieve the details of a specific achievement. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let achievementId = 789; // Number | The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievementsV2) endpoint. apiInstance.getAchievementV2(achievementId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **achievementId** | **Number**| The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievementsV2) endpoint. | ### Return type [**AchievementV2**](AchievementV2.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAdditionalCost > AccountAdditionalCost getAdditionalCost(additionalCostId) Get additional cost Returns the additional cost. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let additionalCostId = 789; // Number | The ID of the additional cost. You can find the ID the the Campaign Manager's URL when you display the details of the cost in **Account** > **Tools** > **Additional costs**. apiInstance.getAdditionalCost(additionalCostId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **additionalCostId** | **Number**| The ID of the additional cost. You can find the ID the the Campaign Manager's URL when you display the details of the cost in **Account** > **Tools** > **Additional costs**. | ### Return type [**AccountAdditionalCost**](AccountAdditionalCost.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAdditionalCosts > InlineResponse20041 getAdditionalCosts(opts) List additional costs Returns all the defined additional costs for the account. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example" // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. }; apiInstance.getAdditionalCosts(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] ### Return type [**InlineResponse20041**](InlineResponse20041.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getApplication > Application getApplication(applicationId) Get Application Get the Application specified by the ID. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. apiInstance.getApplication(applicationId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | ### Return type [**Application**](Application.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getApplicationApiHealth > ApplicationApiHealth getApplicationApiHealth(applicationId) Get Application health Display the health of the Application and show the last time the Application was used. You can also find this information in the Campaign Manager. In your Application, click **Settings** > **Integration API Keys**. See the [docs](https://docs.talon.one/docs/dev/tutorials/monitoring-integration-status). ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. apiInstance.getApplicationApiHealth(applicationId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | ### Return type [**ApplicationApiHealth**](ApplicationApiHealth.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getApplicationCartItemFilterExpression > ApplicationCIFExpression getApplicationCartItemFilterExpression(applicationId, cartItemFilterId, expressionId) Get Application cart item filter expression Get an Application cart item filter expression for a specific Application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let cartItemFilterId = 789; // Number | The ID of the Application cart item filter. You can get this ID with the [List Application cart item filters](https://docs.talon.one/management-api#tag/Applications/operation/listApplicationCartItemFilters) endpoint. let expressionId = 789; // Number | The ID of the Application cart item filter expression. apiInstance.getApplicationCartItemFilterExpression(applicationId, cartItemFilterId, expressionId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **cartItemFilterId** | **Number**| The ID of the Application cart item filter. You can get this ID with the [List Application cart item filters](https://docs.talon.one/management-api#tag/Applications/operation/listApplicationCartItemFilters) endpoint. | **expressionId** | **Number**| The ID of the Application cart item filter expression. | ### Return type [**ApplicationCIFExpression**](ApplicationCIFExpression.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getApplicationCustomer > ApplicationCustomer getApplicationCustomer(applicationId, customerId) Get application's customer Retrieve the customers of the specified application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let customerId = 789; // Number | The value of the `id` property of a customer profile. Get it with the [List Application's customers](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationCustomers) endpoint. apiInstance.getApplicationCustomer(applicationId, customerId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **customerId** | **Number**| The value of the `id` property of a customer profile. Get it with the [List Application's customers](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationCustomers) endpoint. | ### Return type [**ApplicationCustomer**](ApplicationCustomer.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getApplicationCustomerFriends > InlineResponse20038 getApplicationCustomerFriends(applicationId, integrationId, opts) List friends referred by customer profile List the friends referred by the specified customer profile in this Application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let integrationId = "integrationId_example"; // String | The Integration ID of the Advocate's Profile. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'withTotalResultSize': true // Boolean | When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. }; apiInstance.getApplicationCustomerFriends(applicationId, integrationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **integrationId** | **String**| The Integration ID of the Advocate's Profile. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **withTotalResultSize** | **Boolean**| When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. | [optional] ### Return type [**InlineResponse20038**](InlineResponse20038.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getApplicationCustomers > InlineResponse20026 getApplicationCustomers(applicationId, opts) List application's customers List all the customers of the specified application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'integrationId': "integrationId_example", // String | Filter results performing an exact matching against the profile integration identifier. 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'withTotalResultSize': true // Boolean | When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. }; apiInstance.getApplicationCustomers(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **integrationId** | **String**| Filter results performing an exact matching against the profile integration identifier. | [optional] **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **withTotalResultSize** | **Boolean**| When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. | [optional] ### Return type [**InlineResponse20026**](InlineResponse20026.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getApplicationCustomersByAttributes > InlineResponse20027 getApplicationCustomersByAttributes(applicationId, body, opts) List application customers matching the given attributes Get a list of the application customers matching the provided criteria. The match is successful if all the attributes of the request are found in a profile, even if the profile has more attributes that are not present on the request. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let body = new TalonOne.CustomerProfileSearchQuery(); // CustomerProfileSearchQuery | body let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'withTotalResultSize': true // Boolean | When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. }; apiInstance.getApplicationCustomersByAttributes(applicationId, body, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **body** | [**CustomerProfileSearchQuery**](CustomerProfileSearchQuery.md)| body | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **withTotalResultSize** | **Boolean**| When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. | [optional] ### Return type [**InlineResponse20027**](InlineResponse20027.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## getApplicationEventTypes > InlineResponse20034 getApplicationEventTypes(applicationId, opts) List Applications event types Get all of the distinct values of the Event `type` property for events recorded in the application. See also: [Track an event](https://docs.talon.one/integration-api#tag/Events/operation/trackEventV2) ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example" // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. }; apiInstance.getApplicationEventTypes(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] ### Return type [**InlineResponse20034**](InlineResponse20034.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getApplicationEventsWithoutTotalCount > InlineResponse20033 getApplicationEventsWithoutTotalCount(applicationId, opts) List Applications events Lists all events recorded for an application. Instead of having the total number of results in the response, this endpoint only mentions whether there are more results. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'type': "type_example", // String | Comma-separated list of types by which to filter events. Must be exact match(es). 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Only return events created before this date. You can use any time zone setting. Talon.One will convert to UTC internally. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Only return events created after this date. You can use any time zone setting. Talon.One will convert to UTC internally. 'session': "session_example", // String | Session integration ID filter for events. Must be exact match. 'profile': "profile_example", // String | Profile integration ID filter for events. Must be exact match. 'customerName': "customerName_example", // String | Customer name filter for events. Will match substrings case-insensitively. 'customerEmail': "customerEmail_example", // String | Customer e-mail address filter for events. Will match substrings case-insensitively. 'couponCode': "couponCode_example", // String | Coupon code 'referralCode': "referralCode_example", // String | Referral code 'ruleQuery': "ruleQuery_example", // String | Rule name filter for events 'campaignQuery': "campaignQuery_example", // String | Campaign name filter for events 'effectType': "effectType_example" // String | The type of effect that was triggered. See [API effects](https://docs.talon.one/docs/dev/integration-api/api-effects). }; apiInstance.getApplicationEventsWithoutTotalCount(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **type** | **String**| Comma-separated list of types by which to filter events. Must be exact match(es). | [optional] **createdBefore** | **Date**| Only return events created before this date. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **createdAfter** | **Date**| Only return events created after this date. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **session** | **String**| Session integration ID filter for events. Must be exact match. | [optional] **profile** | **String**| Profile integration ID filter for events. Must be exact match. | [optional] **customerName** | **String**| Customer name filter for events. Will match substrings case-insensitively. | [optional] **customerEmail** | **String**| Customer e-mail address filter for events. Will match substrings case-insensitively. | [optional] **couponCode** | **String**| Coupon code | [optional] **referralCode** | **String**| Referral code | [optional] **ruleQuery** | **String**| Rule name filter for events | [optional] **campaignQuery** | **String**| Campaign name filter for events | [optional] **effectType** | **String**| The type of effect that was triggered. See [API effects](https://docs.talon.one/docs/dev/integration-api/api-effects). | [optional] ### Return type [**InlineResponse20033**](InlineResponse20033.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getApplicationSession > ApplicationSession getApplicationSession(applicationId, sessionId) Get Application session Get the details of the given session. You can list the sessions with the [List Application sessions](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationSessions) endpoint. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let sessionId = 789; // Number | The **internal** ID of the session. You can get the ID with the [List Application sessions](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationSessions) endpoint. apiInstance.getApplicationSession(applicationId, sessionId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **sessionId** | **Number**| The **internal** ID of the session. You can get the ID with the [List Application sessions](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationSessions) endpoint. | ### Return type [**ApplicationSession**](ApplicationSession.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getApplicationSessions > InlineResponse20031 getApplicationSessions(applicationId, opts) List Application sessions List all the sessions of the specified Application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'partialMatch': false, // Boolean | Enables partial matching for a single text search field. When enabled, the search term matches anywhere within the field value (case-insensitive). Minimum 3 characters required for partial matches; shorter inputs automatically fall back to exact match. **Note:** Use with one of: `integrationId`, `profile`, `coupon`, `referral`, or `storeIntegrationId`. 'profile': "profile_example", // String | Filter by sessions with this profile integration ID. By default, requires exact match. Use `partialMatch=true` to search for partial matches (minimum 3 characters). 'state': "state_example", // String | Filter by sessions with this state. Must be exact match. 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Only return events created before this date. You can use any time zone setting. Talon.One will convert to UTC internally. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Only return events created after this date. You can use any time zone setting. Talon.One will convert to UTC internally. 'coupon': "coupon_example", // String | Filter by sessions with this coupon. By default, requires exact match. Use `partialMatch=true` to search for partial matches (minimum 3 characters). 'referral': "referral_example", // String | Filter by sessions with this referral. By default, requires exact match. Use `partialMatch=true` to search for partial matches (minimum 3 characters). 'integrationId': "integrationId_example", // String | Filter by sessions with this integration ID. By default, requires exact match. Use `partialMatch=true` to search for partial matches (minimum 3 characters). 'storeIntegrationId': "storeIntegrationId_example" // String | The integration ID of the store. You choose this ID when you create a store. By default, requires exact match. Use `partialMatch=true` to search for partial matches (minimum 3 characters). }; apiInstance.getApplicationSessions(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **partialMatch** | **Boolean**| Enables partial matching for a single text search field. When enabled, the search term matches anywhere within the field value (case-insensitive). Minimum 3 characters required for partial matches; shorter inputs automatically fall back to exact match. **Note:** Use with one of: `integrationId`, `profile`, `coupon`, `referral`, or `storeIntegrationId`. | [optional] [default to false] **profile** | **String**| Filter by sessions with this profile integration ID. By default, requires exact match. Use `partialMatch=true` to search for partial matches (minimum 3 characters). | [optional] **state** | **String**| Filter by sessions with this state. Must be exact match. | [optional] **createdBefore** | **Date**| Only return events created before this date. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **createdAfter** | **Date**| Only return events created after this date. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **coupon** | **String**| Filter by sessions with this coupon. By default, requires exact match. Use `partialMatch=true` to search for partial matches (minimum 3 characters). | [optional] **referral** | **String**| Filter by sessions with this referral. By default, requires exact match. Use `partialMatch=true` to search for partial matches (minimum 3 characters). | [optional] **integrationId** | **String**| Filter by sessions with this integration ID. By default, requires exact match. Use `partialMatch=true` to search for partial matches (minimum 3 characters). | [optional] **storeIntegrationId** | **String**| The integration ID of the store. You choose this ID when you create a store. By default, requires exact match. Use `partialMatch=true` to search for partial matches (minimum 3 characters). | [optional] ### Return type [**InlineResponse20031**](InlineResponse20031.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getApplicationSessionsByCustomerAttributes > InlineResponse20032 getApplicationSessionsByCustomerAttributes(applicationId, body, opts) List Application sessions matching the given customer attributes Get a list of the Application sessions matching the provided customer profile attributes. The match is successful if all the attributes of the request are found in a profile, even if the profile has more attributes that are not present on the request. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let body = new TalonOne.CustomerProfileSearchQuery(); // CustomerProfileSearchQuery | body let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'withTotalResultSize': true // Boolean | When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. }; apiInstance.getApplicationSessionsByCustomerAttributes(applicationId, body, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **body** | [**CustomerProfileSearchQuery**](CustomerProfileSearchQuery.md)| body | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **withTotalResultSize** | **Boolean**| When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. | [optional] ### Return type [**InlineResponse20032**](InlineResponse20032.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## getApplications > InlineResponse2008 getApplications(opts) List Applications List all the Applications in the current account. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example" // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. }; apiInstance.getApplications(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] ### Return type [**InlineResponse2008**](InlineResponse2008.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAttribute > Attribute getAttribute(attributeId) Get custom attribute Retrieve the specified custom attribute. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let attributeId = 789; // Number | The ID of the attribute. You can find the ID in the Campaign Manager's URL when you display the details of an attribute in **Account** > **Tools** > **Attributes**. apiInstance.getAttribute(attributeId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **attributeId** | **Number**| The ID of the attribute. You can find the ID in the Campaign Manager's URL when you display the details of an attribute in **Account** > **Tools** > **Attributes**. | ### Return type [**Attribute**](Attribute.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAttributes > InlineResponse20039 getAttributes(opts) List custom attributes Return all the custom attributes for the account. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'entity': "entity_example", // String | Returned attributes will be filtered by supplied entity. 'applicationIds': "applicationIds_example", // String | Returned attributes will be filtered by supplied application ids 'loyaltyProgramIds': "loyaltyProgramIds_example", // String | Returned attributes will be filtered by the specified loyalty program ids, separated by commas. You can only use this parameter when `entity` is `LoyaltyCard`. 'type': "type_example", // String | Returned attributes will be filtered by supplied type 'kind': "kind_example", // String | Returned attributes will be filtered by supplied kind (builtin or custom) 'search': "search_example" // String | Returned attributes will be filtered by searching case insensitive through Attribute name, description and type }; apiInstance.getAttributes(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **entity** | **String**| Returned attributes will be filtered by supplied entity. | [optional] **applicationIds** | **String**| Returned attributes will be filtered by supplied application ids | [optional] **loyaltyProgramIds** | **String**| Returned attributes will be filtered by the specified loyalty program ids, separated by commas. You can only use this parameter when `entity` is `LoyaltyCard`. | [optional] **type** | **String**| Returned attributes will be filtered by supplied type | [optional] **kind** | **String**| Returned attributes will be filtered by supplied kind (builtin or custom) | [optional] **search** | **String**| Returned attributes will be filtered by searching case insensitive through Attribute name, description and type | [optional] ### Return type [**InlineResponse20039**](InlineResponse20039.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAudienceMemberships > InlineResponse20037 getAudienceMemberships(audienceId, opts) List audience members Get a paginated list of the customer profiles in a given audience. A maximum of 1000 customer profiles per page is allowed. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let audienceId = 789; // Number | The ID of the audience. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'profileQuery': "profileQuery_example" // String | The filter to select a profile. }; apiInstance.getAudienceMemberships(audienceId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **audienceId** | **Number**| The ID of the audience. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **profileQuery** | **String**| The filter to select a profile. | [optional] ### Return type [**InlineResponse20037**](InlineResponse20037.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAudiences > InlineResponse20035 getAudiences(opts) List audiences Get all audiences created in the account. To create an audience, use [Create audience](https://docs.talon.one/integration-api#tag/Audiences/operation/createAudienceV2). ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'withTotalResultSize': true // Boolean | When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. }; apiInstance.getAudiences(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **withTotalResultSize** | **Boolean**| When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. | [optional] ### Return type [**InlineResponse20035**](InlineResponse20035.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getAudiencesAnalytics > InlineResponse20036 getAudiencesAnalytics(audienceIds, opts) List audience analytics Get a list of audience IDs and their member count. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let audienceIds = "audienceIds_example"; // String | The IDs of one or more audiences, separated by commas, by which to filter results. Do not provide more than 1000 audience IDs. let opts = { 'sort': "sort_example" // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. }; apiInstance.getAudiencesAnalytics(audienceIds, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **audienceIds** | **String**| The IDs of one or more audiences, separated by commas, by which to filter results. Do not provide more than 1000 audience IDs. | **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] ### Return type [**InlineResponse20036**](InlineResponse20036.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCampaign > Campaign getCampaign(applicationId, campaignId) Get campaign Retrieve the given campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. apiInstance.getCampaign(applicationId, campaignId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | ### Return type [**Campaign**](Campaign.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCampaignAnalytics > InlineResponse20025 getCampaignAnalytics(applicationId, campaignId, rangeStart, rangeEnd, opts) Get analytics of campaigns Retrieve statistical data about the performance of the given campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let rangeStart = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let rangeEnd = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let opts = { 'granularity': "granularity_example" // String | The time interval between the results in the returned time-series. }; apiInstance.getCampaignAnalytics(applicationId, campaignId, rangeStart, rangeEnd, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **rangeStart** | **Date**| Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **rangeEnd** | **Date**| Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **granularity** | **String**| The time interval between the results in the returned time-series. | [optional] ### Return type [**InlineResponse20025**](InlineResponse20025.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCampaignByAttributes > InlineResponse2009 getCampaignByAttributes(applicationId, body, opts) List campaigns that match the given attributes Get a list of all the campaigns that match a set of attributes. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let body = new TalonOne.CampaignSearch(); // CampaignSearch | body let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'campaignState': "campaignState_example" // String | Filter results by the state of the campaign. - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. }; apiInstance.getCampaignByAttributes(applicationId, body, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **body** | [**CampaignSearch**](CampaignSearch.md)| body | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **campaignState** | **String**| Filter results by the state of the campaign. - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. | [optional] ### Return type [**InlineResponse2009**](InlineResponse2009.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## getCampaignGroup > CampaignGroup getCampaignGroup(campaignGroupId) Get campaign access group Get a campaign access group specified by its ID. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let campaignGroupId = 789; // Number | The ID of the campaign access group. apiInstance.getCampaignGroup(campaignGroupId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **campaignGroupId** | **Number**| The ID of the campaign access group. | ### Return type [**CampaignGroup**](CampaignGroup.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCampaignGroups > InlineResponse20014 getCampaignGroups(opts) List campaign access groups List the campaign access groups in the current account. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example" // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. }; apiInstance.getCampaignGroups(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] ### Return type [**InlineResponse20014**](InlineResponse20014.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCampaignTemplates > InlineResponse20015 getCampaignTemplates(opts) List campaign templates Retrieve a list of campaign templates. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'state': "state_example", // String | Filter results by the state of the campaign template. 'name': "name_example", // String | Filter results performing case-insensitive matching against the name of the campaign template. 'tags': "tags_example", // String | Filter results performing case-insensitive matching against the tags of the campaign template. When used in conjunction with the \"name\" query parameter, a logical OR will be performed to search both tags and name for the provided values. 'userId': 789 // Number | Filter results by user ID. }; apiInstance.getCampaignTemplates(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **state** | **String**| Filter results by the state of the campaign template. | [optional] **name** | **String**| Filter results performing case-insensitive matching against the name of the campaign template. | [optional] **tags** | **String**| Filter results performing case-insensitive matching against the tags of the campaign template. When used in conjunction with the \"name\" query parameter, a logical OR will be performed to search both tags and name for the provided values. | [optional] **userId** | **Number**| Filter results by user ID. | [optional] ### Return type [**InlineResponse20015**](InlineResponse20015.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCampaigns > InlineResponse2009 getCampaigns(applicationId, opts) List campaigns List the campaigns of the specified application that match your filter criteria. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'campaignState': "campaignState_example", // String | Filter results by the state of the campaign. - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. 'name': "name_example", // String | Filter results performing case-insensitive matching against the name of the campaign. 'tags': ["null"], // [String] | Filter results performing case-insensitive matching against the tags of the campaign. 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'startBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign start time timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'startAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign start time timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'endBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign end time timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'endAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign end time timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'campaignGroupId': 789, // Number | Filter results to campaigns owned by the specified campaign access group ID. 'templateId': 789, // Number | The ID of the campaign template this campaign was created from. 'storeId': 789 // Number | Filter results to campaigns linked to the specified store ID. }; apiInstance.getCampaigns(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **campaignState** | **String**| Filter results by the state of the campaign. - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. | [optional] **name** | **String**| Filter results performing case-insensitive matching against the name of the campaign. | [optional] **tags** | [**[String]**](String.md)| Filter results performing case-insensitive matching against the tags of the campaign. | [optional] **createdBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **createdAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **startBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign start time timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **startAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign start time timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **endBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign end time timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **endAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the campaign end time timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **campaignGroupId** | **Number**| Filter results to campaigns owned by the specified campaign access group ID. | [optional] **templateId** | **Number**| The ID of the campaign template this campaign was created from. | [optional] **storeId** | **Number**| Filter results to campaigns linked to the specified store ID. | [optional] ### Return type [**InlineResponse2009**](InlineResponse2009.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getChanges > InlineResponse20045 getChanges(opts) Get audit logs for an account Retrieve the audit logs displayed in **Accounts > Audit logs**. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'applicationId': 3.4, // Number | Filter results by Application ID. 'entityPath': "entityPath_example", // String | Filter results on a case insensitive matching of the url path of the entity 'userId': 789, // Number | Filter results by user ID. 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the change creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the change creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'withTotalResultSize': true, // Boolean | When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. 'managementKeyId': 789, // Number | Filter results that match the given management key ID. 'includeOld': true // Boolean | When this flag is set to false, the state without the change will not be returned. The default value is true. }; apiInstance.getChanges(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **applicationId** | **Number**| Filter results by Application ID. | [optional] **entityPath** | **String**| Filter results on a case insensitive matching of the url path of the entity | [optional] **userId** | **Number**| Filter results by user ID. | [optional] **createdBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the change creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **createdAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the change creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **withTotalResultSize** | **Boolean**| When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. | [optional] **managementKeyId** | **Number**| Filter results that match the given management key ID. | [optional] **includeOld** | **Boolean**| When this flag is set to false, the state without the change will not be returned. The default value is true. | [optional] ### Return type [**InlineResponse20045**](InlineResponse20045.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCollection > Collection getCollection(applicationId, campaignId, collectionId) Get campaign-level collection Retrieve a given campaign-level collection. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let collectionId = 789; // Number | The ID of the collection. You can get it with the [List collections in Application](#tag/Collections/operation/listCollectionsInApplication) endpoint. apiInstance.getCollection(applicationId, campaignId, collectionId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **collectionId** | **Number**| The ID of the collection. You can get it with the [List collections in Application](#tag/Collections/operation/listCollectionsInApplication) endpoint. | ### Return type [**Collection**](Collection.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCollectionItems > InlineResponse20023 getCollectionItems(collectionId, opts) Get collection items Retrieve items from a given collection. You can retrieve items from both account-level collections and campaign-level collections using this endpoint. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let collectionId = 789; // Number | The ID of the collection. You can get it with the [List collections in account](#tag/Collections/operation/listAccountCollections) endpoint. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789 // Number | The number of items to skip when paging through large result sets. }; apiInstance.getCollectionItems(collectionId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **collectionId** | **Number**| The ID of the collection. You can get it with the [List collections in account](#tag/Collections/operation/listAccountCollections) endpoint. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] ### Return type [**InlineResponse20023**](InlineResponse20023.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCouponsWithoutTotalCount > InlineResponse20012 getCouponsWithoutTotalCount(applicationId, campaignId, opts) List coupons List all the coupons matching the specified criteria. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'value': "value_example", // String | Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'valid': "valid_example", // String | Either \"expired\", \"validNow\", or \"validFuture\". The first option matches coupons in which the expiration date is set and in the past. The second matches coupons in which start date is null or in the past and expiration date is null or in the future, the third matches coupons in which start date is set and in the future. 'usable': "usable_example", // String | Either \"true\" or \"false\". If \"true\", only coupons where `usageCounter < usageLimit` will be returned, \"false\" will return only coupons where `usageCounter >= usageLimit`. 'redeemed': "redeemed_example", // String | - `true`: only coupons where `usageCounter > 0` will be returned. - `false`: only coupons where `usageCounter = 0` will be returned. - This field cannot be used in conjunction with the `usable` query parameter. 'referralId': 789, // Number | Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. 'recipientIntegrationId': "recipientIntegrationId_example", // String | Filter results by match with a profile ID specified in the coupon's RecipientIntegrationId field. 'batchId': "batchId_example", // String | Filter results by batches of coupons 'exactMatch': false, // Boolean | Filter results to an exact case-insensitive matching against the coupon code. 'expiresBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon expiration date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'expiresAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon expiration date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'startsBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon start date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'startsAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon start date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'valuesOnly': false // Boolean | Filter results to only return the coupon codes (`value` column) without the associated coupon data. }; apiInstance.getCouponsWithoutTotalCount(applicationId, campaignId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **value** | **String**| Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. | [optional] **createdBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **createdAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **valid** | **String**| Either \"expired\", \"validNow\", or \"validFuture\". The first option matches coupons in which the expiration date is set and in the past. The second matches coupons in which start date is null or in the past and expiration date is null or in the future, the third matches coupons in which start date is set and in the future. | [optional] **usable** | **String**| Either \"true\" or \"false\". If \"true\", only coupons where `usageCounter < usageLimit` will be returned, \"false\" will return only coupons where `usageCounter >= usageLimit`. | [optional] **redeemed** | **String**| - `true`: only coupons where `usageCounter > 0` will be returned. - `false`: only coupons where `usageCounter = 0` will be returned. - This field cannot be used in conjunction with the `usable` query parameter. | [optional] **referralId** | **Number**| Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. | [optional] **recipientIntegrationId** | **String**| Filter results by match with a profile ID specified in the coupon's RecipientIntegrationId field. | [optional] **batchId** | **String**| Filter results by batches of coupons | [optional] **exactMatch** | **Boolean**| Filter results to an exact case-insensitive matching against the coupon code. | [optional] [default to false] **expiresBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon expiration date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **expiresAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon expiration date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **startsBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon start date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **startsAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon start date timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **valuesOnly** | **Boolean**| Filter results to only return the coupon codes (`value` column) without the associated coupon data. | [optional] [default to false] ### Return type [**InlineResponse20012**](InlineResponse20012.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCustomerActivityReport > CustomerActivityReport getCustomerActivityReport(rangeStart, rangeEnd, applicationId, customerId, opts) Get customer's activity report Fetch the summary report of a given customer in the given application, in a time range. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let rangeStart = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let rangeEnd = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let customerId = 789; // Number | The value of the `id` property of a customer profile. Get it with the [List Application's customers](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationCustomers) endpoint. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789 // Number | The number of items to skip when paging through large result sets. }; apiInstance.getCustomerActivityReport(rangeStart, rangeEnd, applicationId, customerId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **rangeStart** | **Date**| Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **rangeEnd** | **Date**| Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **customerId** | **Number**| The value of the `id` property of a customer profile. Get it with the [List Application's customers](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationCustomers) endpoint. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] ### Return type [**CustomerActivityReport**](CustomerActivityReport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCustomerActivityReportsWithoutTotalCount > InlineResponse20030 getCustomerActivityReportsWithoutTotalCount(rangeStart, rangeEnd, applicationId, opts) Get Activity Reports for Application Customers Fetch summary reports for all application customers based on a time range. Instead of having the total number of results in the response, this endpoint only mentions whether there are more results. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let rangeStart = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let rangeEnd = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'name': "name_example", // String | Only return reports matching the customer name. 'integrationId': "integrationId_example", // String | Filter results performing an exact matching against the profile integration identifier. 'campaignName': "campaignName_example", // String | Only return reports matching the campaign name. 'advocateName': "advocateName_example" // String | Only return reports matching the current customer referrer name. }; apiInstance.getCustomerActivityReportsWithoutTotalCount(rangeStart, rangeEnd, applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **rangeStart** | **Date**| Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **rangeEnd** | **Date**| Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **name** | **String**| Only return reports matching the customer name. | [optional] **integrationId** | **String**| Filter results performing an exact matching against the profile integration identifier. | [optional] **campaignName** | **String**| Only return reports matching the campaign name. | [optional] **advocateName** | **String**| Only return reports matching the current customer referrer name. | [optional] ### Return type [**InlineResponse20030**](InlineResponse20030.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCustomerAnalytics > CustomerAnalytics getCustomerAnalytics(applicationId, customerId, opts) Get customer's analytics report Fetch analytics for a given customer in the given application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let customerId = 789; // Number | The value of the `id` property of a customer profile. Get it with the [List Application's customers](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationCustomers) endpoint. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example" // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. }; apiInstance.getCustomerAnalytics(applicationId, customerId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **customerId** | **Number**| The value of the `id` property of a customer profile. Get it with the [List Application's customers](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationCustomers) endpoint. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] ### Return type [**CustomerAnalytics**](CustomerAnalytics.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCustomerProfile > CustomerProfile getCustomerProfile(customerId) Get customer profile Return the details of the specified customer profile. > [!note] > You can retrieve the same information via the Integration API, which can save you extra API requests. Consider these options: > - Request the customer profile to be part of the response content using > [Update Customer Session](https://docs.talon.one/integration-api#tag/Customer-sessions/operation/updateCustomerSessionV2). > - Send an empty update with the [Update Customer Profile](https://docs.talon.one/integration-api#tag/Customer-profiles/operation/updateCustomerProfileV2) endpoint with `runRuleEngine=false`. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let customerId = 789; // Number | The value of the `id` property of a customer profile. Get it with the [List Application's customers](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationCustomers) endpoint. apiInstance.getCustomerProfile(customerId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **customerId** | **Number**| The value of the `id` property of a customer profile. Get it with the [List Application's customers](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationCustomers) endpoint. | ### Return type [**CustomerProfile**](CustomerProfile.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCustomerProfileAchievementProgress > InlineResponse20054 getCustomerProfileAchievementProgress(applicationId, integrationId, opts) List customer achievements For the given customer profile, list all the achievements that match your filter criteria. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let integrationId = "integrationId_example"; // String | The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. let opts = { 'pageSize': 50, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'achievementId': 789, // Number | The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievements) endpoint. 'title': "title_example" // String | Filter results by the `title` of an achievement. }; apiInstance.getCustomerProfileAchievementProgress(applicationId, integrationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **integrationId** | **String**| The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 50] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **achievementId** | **Number**| The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievements) endpoint. | [optional] **title** | **String**| Filter results by the `title` of an achievement. | [optional] ### Return type [**InlineResponse20054**](InlineResponse20054.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCustomerProfiles > InlineResponse20029 getCustomerProfiles(opts) List customer profiles List all customer profiles. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sandbox': false // Boolean | Indicates whether you are pointing to a sandbox or live customer. }; apiInstance.getCustomerProfiles(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sandbox** | **Boolean**| Indicates whether you are pointing to a sandbox or live customer. | [optional] [default to false] ### Return type [**InlineResponse20029**](InlineResponse20029.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getCustomersByAttributes > InlineResponse20028 getCustomersByAttributes(body, opts) List customer profiles matching the given attributes Get a list of the customer profiles matching the provided criteria. The match is successful if all the attributes of the request are found in a profile, even if the profile has more attributes that are not present on the request. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.CustomerProfileSearchQuery(); // CustomerProfileSearchQuery | body let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sandbox': false // Boolean | Indicates whether you are pointing to a sandbox or live customer. }; apiInstance.getCustomersByAttributes(body, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**CustomerProfileSearchQuery**](CustomerProfileSearchQuery.md)| body | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sandbox** | **Boolean**| Indicates whether you are pointing to a sandbox or live customer. | [optional] [default to false] ### Return type [**InlineResponse20028**](InlineResponse20028.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## getDashboardStatistics > InlineResponse20018 getDashboardStatistics(loyaltyProgramId, rangeStart, rangeEnd, opts) Get statistics for loyalty dashboard Retrieve the statistics displayed on the specified loyalty program's dashboard, such as the total active points, pending points, spent points, and expired points. > [!important] The returned data does not include the current day. All statistics > are updated daily at 11:59 PM in the loyalty program time zone. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let rangeStart = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let rangeEnd = new Date("2013-10-20T19:20:30+01:00"); // Date | Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. let opts = { 'subledgerId': "subledgerId_example" // String | The ID of the subledger by which we filter the data. }; apiInstance.getDashboardStatistics(loyaltyProgramId, rangeStart, rangeEnd, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **rangeStart** | **Date**| Only return results from after this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **rangeEnd** | **Date**| Only return results from before this timestamp. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | **subledgerId** | **String**| The ID of the subledger by which we filter the data. | [optional] ### Return type [**InlineResponse20018**](InlineResponse20018.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getEventTypes > InlineResponse20043 getEventTypes(opts) List event types Fetch all event type definitions for your account. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'name': "name_example", // String | Filter results to event types with the given name. This parameter implies `includeOldVersions`. 'includeOldVersions': false, // Boolean | Include all versions of every event type. 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example" // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. }; apiInstance.getEventTypes(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **name** | **String**| Filter results to event types with the given name. This parameter implies `includeOldVersions`. | [optional] **includeOldVersions** | **Boolean**| Include all versions of every event type. | [optional] [default to false] **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] ### Return type [**InlineResponse20043**](InlineResponse20043.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getExperiment > Experiment getExperiment(applicationId, experimentId) Get experiment in Application Retrieve the given experiment associated with the Application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let experimentId = 789; // Number | The ID of the experiment. apiInstance.getExperiment(applicationId, experimentId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **experimentId** | **Number**| The ID of the experiment. | ### Return type [**Experiment**](Experiment.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getExports > InlineResponse20046 getExports(opts) Get exports List all past exports ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'applicationId': 3.4, // Number | Filter results by Application ID. 'campaignId': 789, // Number | Filter by the campaign ID on which the limit counters are used. 'entity': "entity_example" // String | The name of the entity type that was exported. }; apiInstance.getExports(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **applicationId** | **Number**| Filter results by Application ID. | [optional] **campaignId** | **Number**| Filter by the campaign ID on which the limit counters are used. | [optional] **entity** | **String**| The name of the entity type that was exported. | [optional] ### Return type [**InlineResponse20046**](InlineResponse20046.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getLoyaltyCard > LoyaltyCard getLoyaltyCard(loyaltyProgramId, loyaltyCardId) Get loyalty card Get the given loyalty card. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let loyaltyCardId = "loyaltyCardId_example"; // String | Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. apiInstance.getLoyaltyCard(loyaltyProgramId, loyaltyCardId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **loyaltyCardId** | **String**| Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. | ### Return type [**LoyaltyCard**](LoyaltyCard.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getLoyaltyCardTransactionLogs > InlineResponse20021 getLoyaltyCardTransactionLogs(loyaltyProgramId, loyaltyCardId, opts) List card's transactions (Management API) Retrieve the transaction logs for the given [loyalty card](https://docs.talon.one/docs/product/loyalty-programs/card-based/card-based-overview) within the specified [card-based loyalty program](https://docs.talon.one/docs/product/loyalty-programs/overview#loyalty-program-types) with filtering options applied. > [!note] For most use cases, especially real-time integrations, use the Integration API endpoint: > [List card's transactions](https://docs.talon.one/integration-api#tag/Loyalty-cards/operation/getLoyaltyCardTransactions). If no filtering options are applied, the last 50 loyalty transactions for the given loyalty card are returned. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let loyaltyCardId = "loyaltyCardId_example"; // String | Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. let opts = { 'startDate': new Date("2013-10-20T19:20:30+01:00"), // Date | Date and time from which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 'endDate': new Date("2013-10-20T19:20:30+01:00"), // Date | Date and time by which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'subledgerId': "subledgerId_example", // String | The ID of the subledger by which we filter the data. 'customerSessionIDs': ["null"], // [String] | Filter the results by a list of customer session IDs. To include multiple IDs, repeat the parameter for each one, for example, `?customerSessionIDs=id1&customerSessionIDs=id2`. The response contains only data associated with the specified sessions. 'transactionUUIDs': ["null"] // [String] | Filter the results by a list of transaction UUIDs. To include multiple IDs, repeat the parameter for each one, for example, `?transactionUUIDs=uuid1&transactionUUIDs=uuid2`. The response contains only data associated with the specified transactions. }; apiInstance.getLoyaltyCardTransactionLogs(loyaltyProgramId, loyaltyCardId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **loyaltyCardId** | **String**| Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. | **startDate** | **Date**| Date and time from which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | [optional] **endDate** | **Date**| Date and time by which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | [optional] **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **subledgerId** | **String**| The ID of the subledger by which we filter the data. | [optional] **customerSessionIDs** | [**[String]**](String.md)| Filter the results by a list of customer session IDs. To include multiple IDs, repeat the parameter for each one, for example, `?customerSessionIDs=id1&customerSessionIDs=id2`. The response contains only data associated with the specified sessions. | [optional] **transactionUUIDs** | [**[String]**](String.md)| Filter the results by a list of transaction UUIDs. To include multiple IDs, repeat the parameter for each one, for example, `?transactionUUIDs=uuid1&transactionUUIDs=uuid2`. The response contains only data associated with the specified transactions. | [optional] ### Return type [**InlineResponse20021**](InlineResponse20021.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getLoyaltyCards > InlineResponse20020 getLoyaltyCards(loyaltyProgramId, opts) List loyalty cards For the given card-based loyalty program, list the loyalty cards that match your filter criteria. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'identifier': "identifier_example", // String | The card code by which to filter loyalty cards in the response. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. 'profileId': 789, // Number | Filter results by customer profile ID. 'batchId': "batchId_example" // String | Filter results by loyalty card batch ID. }; apiInstance.getLoyaltyCards(loyaltyProgramId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **identifier** | **String**| The card code by which to filter loyalty cards in the response. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. | [optional] **profileId** | **Number**| Filter results by customer profile ID. | [optional] **batchId** | **String**| Filter results by loyalty card batch ID. | [optional] ### Return type [**InlineResponse20020**](InlineResponse20020.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getLoyaltyLedgerBalances > LoyaltyBalancesWithTiers getLoyaltyLedgerBalances(loyaltyProgramId, integrationId, opts) Get customer's loyalty balances (Management API) Retrieve loyalty ledger balances for the given Integration ID in the specified loyalty program. You can filter balances by date and subledger ID, and include tier-related information in the response. > [!note] **Note** > - For most use cases, especially real-time integrations, use the Integration API endpoint: [Get customer's loyalty balances](https://docs.talon.one/integration-api#tag/Loyalty/operation/getLoyaltyBalances). > - If no filtering options are applied, you retrieve all loyalty balances on the current date for the given integration ID. Loyalty balances are calculated when Talon.One receives your request using the points stored in our database, so retrieving a large number of balances at once can impact performance. For more information, see: - [Managing card-based loyalty program data](https://docs.talon.one/docs/product/loyalty-programs/card-based/managing-loyalty-cards) - [Managing profile-based loyalty program data](https://docs.talon.one/docs/product/loyalty-programs/profile-based/managing-pb-lp-data) ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the profile-based loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let integrationId = "integrationId_example"; // String | The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. let opts = { 'endDate': new Date("2013-10-20T19:20:30+01:00"), // Date | Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 'subledgerId': "subledgerId_example", // String | The ID of the subledger used to filter the data. Leave this value empty (\"\") to query the main ledger. 'includeTiers': false, // Boolean | Indicates whether tier information is included in the response. When set to `true`, the response includes information about the current tier and the number of points required to move to next tier. 'includeProjectedTier': false // Boolean | Indicates whether the customer's projected tier information is included in the response. When set to `true`, the response includes information about the customer's active points and the name of the projected tier. **Note** We recommend filtering by `subledgerId` for better performance. }; apiInstance.getLoyaltyLedgerBalances(loyaltyProgramId, integrationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the profile-based loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **integrationId** | **String**| The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. | **endDate** | **Date**| Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | [optional] **subledgerId** | **String**| The ID of the subledger used to filter the data. Leave this value empty (\"\") to query the main ledger. | [optional] **includeTiers** | **Boolean**| Indicates whether tier information is included in the response. When set to `true`, the response includes information about the current tier and the number of points required to move to next tier. | [optional] [default to false] **includeProjectedTier** | **Boolean**| Indicates whether the customer's projected tier information is included in the response. When set to `true`, the response includes information about the customer's active points and the name of the projected tier. **Note** We recommend filtering by `subledgerId` for better performance. | [optional] [default to false] ### Return type [**LoyaltyBalancesWithTiers**](LoyaltyBalancesWithTiers.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getLoyaltyPoints > LoyaltyLedger getLoyaltyPoints(loyaltyProgramId, integrationId) Get customer's full loyalty ledger Get the loyalty ledger for this profile integration ID. To get the `integrationId` of the profile from a `sessionId`, use the [Update customer session](https://docs.talon.one/integration-api#tag/Customer-sessions/operation/updateCustomerSessionV2) endpoint. **Important:** To get loyalty transaction logs for a given Integration ID in a loyalty program, we recommend using the Integration API's [Get customer's loyalty logs](https://docs.talon.one/integration-api#tag/Loyalty/operation/getLoyaltyProgramProfileTransactions). ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = "loyaltyProgramId_example"; // String | The identifier for the loyalty program. let integrationId = "integrationId_example"; // String | The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. apiInstance.getLoyaltyPoints(loyaltyProgramId, integrationId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **String**| The identifier for the loyalty program. | **integrationId** | **String**| The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. | ### Return type [**LoyaltyLedger**](LoyaltyLedger.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getLoyaltyProgram > LoyaltyProgram getLoyaltyProgram(loyaltyProgramId) Get loyalty program Get the specified [loyalty program](https://docs.talon.one/docs/product/loyalty-programs/overview). To list all loyalty programs in your Application, use [List loyalty programs](#tag/Loyalty/operation/getLoyaltyPrograms). To list the loyalty programs that a customer profile is part of, use [List customer data](https://docs.talon.one/integration-api#tag/Customer-profiles/operation/getCustomerInventory). ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. apiInstance.getLoyaltyProgram(loyaltyProgramId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | ### Return type [**LoyaltyProgram**](LoyaltyProgram.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getLoyaltyProgramProfileLedgerTransactions > InlineResponse2005 getLoyaltyProgramProfileLedgerTransactions(loyaltyProgramId, integrationId, opts) List customer's loyalty transactions (Management API) Retrieve paginated results of loyalty transaction logs for the given Integration ID in the specified loyalty program. You can filter transactions by date or by ledger (subledger or main ledger). If no filters are applied, the last 50 loyalty transactions for the given integration ID are returned. > [!note] **Note** > - For most use cases, especially real-time integrations, use the Integration API endpoint: > [List customer's loyalty transactions](https://docs.talon.one/integration-api#tag/Loyalty/operation/getLoyaltyProgramProfileTransactions). > - To retrieve all loyalty program transaction logs in a given loyalty program, use the > [List loyalty program transactions](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyProgramTransactions) endpoint. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the profile-based loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let integrationId = "integrationId_example"; // String | The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. let opts = { 'customerSessionIDs': ["null"], // [String] | Filter the results by a list of customer session IDs. To include multiple IDs, repeat the parameter for each one, for example, `?customerSessionIDs=id1&customerSessionIDs=id2`. The response contains only data associated with the specified sessions. 'transactionUUIDs': ["null"], // [String] | Filter the results by a list of transaction UUIDs. To include multiple IDs, repeat the parameter for each one, for example, `?transactionUUIDs=uuid1&transactionUUIDs=uuid2`. The response contains only data associated with the specified transactions. 'subledgerId': "subledgerId_example", // String | The ID of the subledger used to filter the data. Leave this value empty (\"\") to query the main ledger. 'loyaltyTransactionType': "loyaltyTransactionType_example", // String | Filter results by loyalty transaction type: - `manual`: Loyalty transaction that was done manually. - `session`: Loyalty transaction that resulted from a customer session. - `import`: Loyalty transaction that was imported from a CSV file. 'startDate': new Date("2013-10-20T19:20:30+01:00"), // Date | Date and time from which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 'endDate': new Date("2013-10-20T19:20:30+01:00"), // Date | Date and time by which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 'pageSize': 50, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'awaitsActivation': true // Boolean | If `true`: Filters results to include only point transactions that have action-based activation and have not expired. If `false`: Returns a `400` response. }; apiInstance.getLoyaltyProgramProfileLedgerTransactions(loyaltyProgramId, integrationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the profile-based loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **integrationId** | **String**| The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. | **customerSessionIDs** | [**[String]**](String.md)| Filter the results by a list of customer session IDs. To include multiple IDs, repeat the parameter for each one, for example, `?customerSessionIDs=id1&customerSessionIDs=id2`. The response contains only data associated with the specified sessions. | [optional] **transactionUUIDs** | [**[String]**](String.md)| Filter the results by a list of transaction UUIDs. To include multiple IDs, repeat the parameter for each one, for example, `?transactionUUIDs=uuid1&transactionUUIDs=uuid2`. The response contains only data associated with the specified transactions. | [optional] **subledgerId** | **String**| The ID of the subledger used to filter the data. Leave this value empty (\"\") to query the main ledger. | [optional] **loyaltyTransactionType** | **String**| Filter results by loyalty transaction type: - `manual`: Loyalty transaction that was done manually. - `session`: Loyalty transaction that resulted from a customer session. - `import`: Loyalty transaction that was imported from a CSV file. | [optional] **startDate** | **Date**| Date and time from which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | [optional] **endDate** | **Date**| Date and time by which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | [optional] **pageSize** | **Number**| The number of items in the response. | [optional] [default to 50] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **awaitsActivation** | **Boolean**| If `true`: Filters results to include only point transactions that have action-based activation and have not expired. If `false`: Returns a `400` response. | [optional] ### Return type [**InlineResponse2005**](InlineResponse2005.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getLoyaltyProgramTransactions > InlineResponse20019 getLoyaltyProgramTransactions(loyaltyProgramId, opts) List loyalty program transactions Retrieve loyalty program transaction logs in a given loyalty program with filtering options applied. Manual and imported transactions are also included. > [!note] **Note** > - If no filters are applied, the last 50 loyalty transactions for the given loyalty program are returned. > - To get loyalty transaction logs for a given Integration ID in > a loyalty program, we recommend using the Integration API's [Get customer's loyalty > logs](https://docs.talon.one/integration-api#tag/Loyalty/operation/getLoyaltyProgramProfileTransactions). ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let opts = { 'loyaltyTransactionType': "loyaltyTransactionType_example", // String | Filter results by loyalty transaction type: - `manual`: Loyalty transaction that was done manually. - `session`: Loyalty transaction that resulted from a customer session. - `import`: Loyalty transaction that was imported from a CSV file. 'subledgerId': "subledgerId_example", // String | The ID of the subledger by which we filter the data. 'customerSessionIDs': ["null"], // [String] | Filter the results by a list of customer session IDs. To include multiple IDs, repeat the parameter for each one, for example, `?customerSessionIDs=id1&customerSessionIDs=id2`. The response contains only data associated with the specified sessions. 'transactionUUIDs': ["null"], // [String] | Filter the results by a list of transaction UUIDs. To include multiple IDs, repeat the parameter for each one, for example, `?transactionUUIDs=uuid1&transactionUUIDs=uuid2`. The response contains only data associated with the specified transactions. 'startDate': new Date("2013-10-20T19:20:30+01:00"), // Date | Date and time from which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 'endDate': new Date("2013-10-20T19:20:30+01:00"), // Date | Date and time by which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 'pageSize': 50, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'awaitsActivation': true // Boolean | If `true`: Filters results to include only point transactions that have action-based activation and have not expired. If `false`: Returns a `400` response. }; apiInstance.getLoyaltyProgramTransactions(loyaltyProgramId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **loyaltyTransactionType** | **String**| Filter results by loyalty transaction type: - `manual`: Loyalty transaction that was done manually. - `session`: Loyalty transaction that resulted from a customer session. - `import`: Loyalty transaction that was imported from a CSV file. | [optional] **subledgerId** | **String**| The ID of the subledger by which we filter the data. | [optional] **customerSessionIDs** | [**[String]**](String.md)| Filter the results by a list of customer session IDs. To include multiple IDs, repeat the parameter for each one, for example, `?customerSessionIDs=id1&customerSessionIDs=id2`. The response contains only data associated with the specified sessions. | [optional] **transactionUUIDs** | [**[String]**](String.md)| Filter the results by a list of transaction UUIDs. To include multiple IDs, repeat the parameter for each one, for example, `?transactionUUIDs=uuid1&transactionUUIDs=uuid2`. The response contains only data associated with the specified transactions. | [optional] **startDate** | **Date**| Date and time from which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | [optional] **endDate** | **Date**| Date and time by which results are returned. Results are filtered by transaction creation date. > [!note] **Note** > - This must be an RFC3339 timestamp string. > - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting > considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. | [optional] **pageSize** | **Number**| The number of items in the response. | [optional] [default to 50] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **awaitsActivation** | **Boolean**| If `true`: Filters results to include only point transactions that have action-based activation and have not expired. If `false`: Returns a `400` response. | [optional] ### Return type [**InlineResponse20019**](InlineResponse20019.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getLoyaltyPrograms > InlineResponse20017 getLoyaltyPrograms() List loyalty programs List the loyalty programs of the account. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); apiInstance.getLoyaltyPrograms().then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters This endpoint does not need any parameter. ### Return type [**InlineResponse20017**](InlineResponse20017.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getLoyaltyStatistics > LoyaltyDashboardData getLoyaltyStatistics(loyaltyProgramId) Get loyalty program statistics > [!warning] This endpoint is deprecated. To retrieve statistics for a loyalty program, use the [Get statistics for loyalty dashboard](/management-api#tag/Loyalty/operation/getDashboardStatistics) endpoint. Retrieve the statistics of the specified loyalty program, such as the total active points, pending points, spent points, and expired points. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. apiInstance.getLoyaltyStatistics(loyaltyProgramId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | ### Return type [**LoyaltyDashboardData**](LoyaltyDashboardData.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getMessageLogs > MessageLogEntries getMessageLogs(entityType, opts) List message log entries Retrieve all message log entries. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let entityType = "entityType_example"; // String | The entity type the log is related to. let opts = { 'messageID': "messageID_example", // String | Filter results by message ID. 'changeType': "changeType_example", // String | Filter results by change type. 'notificationIDs': "notificationIDs_example", // String | Filter results by notification ID (include up to 30 values, separated by a comma). 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results where request and response times to return entries before parameter value, expected to be an RFC3339 timestamp string. Use UTC time. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results where request and response times to return entries after parameter value, expected to be an RFC3339 timestamp string. Use UTC time. 'cursor': null, // Blob | A specific unique value in the database. If this value is not given, the server fetches results starting with the first record. 'pageSize': 50, // Number | The maximum number of message log entries to return. 'period': "period_example", // String | Filter results by time period. Choose between the available relative time frames. 'isSuccessful': true, // Boolean | Indicates whether to return log entries with either successful or unsuccessful HTTP response codes. When set to`true`, only log entries with `2xx` response codes are returned. When set to `false`, only log entries with `4xx` and `5xx` response codes are returned. 'applicationId': 3.4, // Number | Filter results by Application ID. 'campaignId': 3.4, // Number | Filter results by campaign ID. 'loyaltyProgramId': 789, // Number | Identifier of the loyalty program. 'responseCode': 789, // Number | Filter results by response status code. 'webhookIDs': "webhookIDs_example" // String | Filter results by webhook ID (include up to 30 values, separated by a comma). }; apiInstance.getMessageLogs(entityType, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **entityType** | **String**| The entity type the log is related to. | **messageID** | **String**| Filter results by message ID. | [optional] **changeType** | **String**| Filter results by change type. | [optional] **notificationIDs** | **String**| Filter results by notification ID (include up to 30 values, separated by a comma). | [optional] **createdBefore** | **Date**| Filter results where request and response times to return entries before parameter value, expected to be an RFC3339 timestamp string. Use UTC time. | [optional] **createdAfter** | **Date**| Filter results where request and response times to return entries after parameter value, expected to be an RFC3339 timestamp string. Use UTC time. | [optional] **cursor** | **Blob**| A specific unique value in the database. If this value is not given, the server fetches results starting with the first record. | [optional] **pageSize** | **Number**| The maximum number of message log entries to return. | [optional] [default to 50] **period** | **String**| Filter results by time period. Choose between the available relative time frames. | [optional] **isSuccessful** | **Boolean**| Indicates whether to return log entries with either successful or unsuccessful HTTP response codes. When set to`true`, only log entries with `2xx` response codes are returned. When set to `false`, only log entries with `4xx` and `5xx` response codes are returned. | [optional] **applicationId** | **Number**| Filter results by Application ID. | [optional] **campaignId** | **Number**| Filter results by campaign ID. | [optional] **loyaltyProgramId** | **Number**| Identifier of the loyalty program. | [optional] **responseCode** | **Number**| Filter results by response status code. | [optional] **webhookIDs** | **String**| Filter results by webhook ID (include up to 30 values, separated by a comma). | [optional] ### Return type [**MessageLogEntries**](MessageLogEntries.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getReferralsWithoutTotalCount > InlineResponse20013 getReferralsWithoutTotalCount(applicationId, campaignId, opts) List referrals List all referrals of the specified campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'code': "code_example", // String | Filter results performing case-insensitive matching against the referral code. Both the code and the query are folded to remove all non-alpha-numeric characters. 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the referral creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the referral creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'valid': "valid_example", // String | Either \"expired\", \"validNow\", or \"validFuture\". The first option matches referrals in which the expiration date is set and in the past. The second matches referrals in which start date is null or in the past and expiration date is null or in the future, the third matches referrals in which start date is set and in the future. 'usable': "usable_example", // String | Either \"true\" or \"false\". If \"true\", only referrals where `usageCounter < usageLimit` will be returned, \"false\" will return only referrals where `usageCounter >= usageLimit`. 'advocate': "advocate_example" // String | Filter results by match with a profile ID specified in the referral's AdvocateProfileIntegrationId field. }; apiInstance.getReferralsWithoutTotalCount(applicationId, campaignId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **code** | **String**| Filter results performing case-insensitive matching against the referral code. Both the code and the query are folded to remove all non-alpha-numeric characters. | [optional] **createdBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the referral creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **createdAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the referral creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **valid** | **String**| Either \"expired\", \"validNow\", or \"validFuture\". The first option matches referrals in which the expiration date is set and in the past. The second matches referrals in which start date is null or in the past and expiration date is null or in the future, the third matches referrals in which start date is set and in the future. | [optional] **usable** | **String**| Either \"true\" or \"false\". If \"true\", only referrals where `usageCounter < usageLimit` will be returned, \"false\" will return only referrals where `usageCounter >= usageLimit`. | [optional] **advocate** | **String**| Filter results by match with a profile ID specified in the referral's AdvocateProfileIntegrationId field. | [optional] ### Return type [**InlineResponse20013**](InlineResponse20013.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getRoleV2 > RoleV2 getRoleV2(roleId) Get role Get the details of a specific role. To see all the roles, use the [List roles](/management-api#tag/Roles/operation/listAllRolesV2) endpoint. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let roleId = 789; // Number | The ID of role. **Note**: To find the ID of a role, use the [List roles](/management-api#tag/Roles/operation/listAllRolesV2) endpoint. apiInstance.getRoleV2(roleId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **roleId** | **Number**| The ID of role. **Note**: To find the ID of a role, use the [List roles](/management-api#tag/Roles/operation/listAllRolesV2) endpoint. | ### Return type [**RoleV2**](RoleV2.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getRuleset > Ruleset getRuleset(applicationId, campaignId, rulesetId) Get ruleset Retrieve the specified ruleset. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let rulesetId = 789; // Number | The ID of the ruleset. apiInstance.getRuleset(applicationId, campaignId, rulesetId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **rulesetId** | **Number**| The ID of the ruleset. | ### Return type [**Ruleset**](Ruleset.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getRulesetV2 > RulesetV2 getRulesetV2(applicationId, campaignId, rulesetId) Get ruleset (V2) Retrieve the specified ruleset as a JSON object. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let rulesetId = 789; // Number | The ID of the ruleset. apiInstance.getRulesetV2(applicationId, campaignId, rulesetId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **rulesetId** | **Number**| The ID of the ruleset. | ### Return type [**RulesetV2**](RulesetV2.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getRulesets > InlineResponse20010 getRulesets(applicationId, campaignId, opts) List campaign rulesets List all rulesets of this campaign. A ruleset is a revision of the rules of a campaign. **Important:** The response also includes deleted rules. You should only consider the latest revision of the returned rulesets. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example" // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. }; apiInstance.getRulesets(applicationId, campaignId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] ### Return type [**InlineResponse20010**](InlineResponse20010.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getStore > Store getStore(applicationId, storeId) Get store Get store details for a specific store ID. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let storeId = "storeId_example"; // String | The ID of the store. You can get this ID with the [List stores](#tag/Stores/operation/listStores) endpoint. apiInstance.getStore(applicationId, storeId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **storeId** | **String**| The ID of the store. You can get this ID with the [List stores](#tag/Stores/operation/listStores) endpoint. | ### Return type [**Store**](Store.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getUser > User getUser(userId) Get user Retrieve the data (including an invitation code) for a user. Non-admin users can only get their own profile. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let userId = 789; // Number | The ID of the user. apiInstance.getUser(userId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **userId** | **Number**| The ID of the user. | ### Return type [**User**](User.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getUsers > InlineResponse20044 getUsers(opts) List users in account Retrieve all users in your account. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example" // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. }; apiInstance.getUsers(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] ### Return type [**InlineResponse20044**](InlineResponse20044.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getWebhook > Webhook getWebhook(webhookId) Get webhook Returns a webhook by its id. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let webhookId = 789; // Number | The ID of the webhook. You can find the ID in the Campaign Manager's URL when you display the details of the webhook in **Account** > **Webhooks**. apiInstance.getWebhook(webhookId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **webhookId** | **Number**| The ID of the webhook. You can find the ID in the Campaign Manager's URL when you display the details of the webhook in **Account** > **Webhooks**. | ### Return type [**Webhook**](Webhook.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## getWebhooks > InlineResponse20042 getWebhooks(opts) List webhooks List all webhooks. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'applicationIds': "applicationIds_example", // String | Checks if the given catalog or its attributes are referenced in the specified Application ID. **Note**: If no Application ID is provided, we check for all connected Applications. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'creationType': "creationType_example", // String | Filter results by creation type. 'visibility': "visibility_example", // String | Filter results by visibility. 'outgoingIntegrationsTypeId': 789, // Number | Filter results by outgoing integration type ID. 'title': "title_example" // String | Filter results performing case-insensitive matching against the webhook title. }; apiInstance.getWebhooks(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationIds** | **String**| Checks if the given catalog or its attributes are referenced in the specified Application ID. **Note**: If no Application ID is provided, we check for all connected Applications. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **creationType** | **String**| Filter results by creation type. | [optional] **visibility** | **String**| Filter results by visibility. | [optional] **outgoingIntegrationsTypeId** | **Number**| Filter results by outgoing integration type ID. | [optional] **title** | **String**| Filter results performing case-insensitive matching against the webhook title. | [optional] ### Return type [**InlineResponse20042**](InlineResponse20042.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## importAccountCollection > ModelImport importAccountCollection(collectionId, opts) Import data into existing account-level collection Upload a CSV file containing the collection of string values that should be attached as payload for collection. The file should be sent as multipart data. The import **replaces** the initial content of the collection. The CSV file **must** only contain the following column: - `item`: the values in your collection. A collection is limited to 500,000 items. ## Example ``` item Adidas Nike Asics ``` > [!note] Before sending a request to this endpoint, ensure the data in the > CSV to import is different from the data currently stored in the collection. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let collectionId = 789; // Number | The ID of the collection. You can get it with the [List collections in account](#tag/Collections/operation/listAccountCollections) endpoint. let opts = { 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importAccountCollection(collectionId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **collectionId** | **Number**| The ID of the collection. You can get it with the [List collections in account](#tag/Collections/operation/listAccountCollections) endpoint. | **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## importAllowedList > ModelImport importAllowedList(attributeId, opts) Import allowed values for attribute Upload a CSV file containing a list of [picklist values](https://docs.talon.one/docs/product/account/dev-tools/managing-attributes#picklist-values) for the specified attribute. The file should be sent as multipart data. The import **replaces** the previous list of allowed values for this attribute, if any. The CSV file **must** only contain the following column: - `item`: The values in your allowed list, for example a list of SKUs. An allowed list is limited to 500,000 items. ## Example ```text item CS-VG-04032021-UP-50D-10 CS-DV-04042021-UP-49D-12 CS-DG-02082021-UP-50G-07 ``` ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let attributeId = 789; // Number | The ID of the attribute. You can find the ID in the Campaign Manager's URL when you display the details of an attribute in **Account** > **Tools** > **Attributes**. let opts = { 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importAllowedList(attributeId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **attributeId** | **Number**| The ID of the attribute. You can find the ID in the Campaign Manager's URL when you display the details of an attribute in **Account** > **Tools** > **Attributes**. | **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## importAudiencesMemberships > ModelImport importAudiencesMemberships(audienceId, opts) Import audience members Upload a CSV file containing the integration IDs of the members you want to add to an audience. The file should be sent as multipart data and should contain only the following column (required): - `profileintegrationid`: The integration ID of the customer profile. The import **replaces** the previous list of audience members. > [!note] We recommend limiting your file size to 500 MB. ## Example ```text profileintegrationid charles alexa ``` ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let audienceId = 789; // Number | The ID of the audience. let opts = { 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importAudiencesMemberships(audienceId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **audienceId** | **Number**| The ID of the audience. | **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## importCampaignStoreBudget > ModelImport importCampaignStoreBudget(applicationId, campaignId, opts) Import campaign store budgets Upload a CSV file containing store budgets for a given campaign. Send the file as multipart data. The CSV file **must** only contain the following columns: - `store_integration_id`: The identifier of the store. - `limit`: The budget limit for the store. The import **replaces** the previous list of store budgets. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'action': "action_example", // String | The action that this budget is limiting. 'period': "period_example", // String | The period to which the limit applies. **Note**: For budgets with no period, set this to `overall`. 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importCampaignStoreBudget(applicationId, campaignId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **action** | **String**| The action that this budget is limiting. | [optional] **period** | **String**| The period to which the limit applies. **Note**: For budgets with no period, set this to `overall`. | [optional] **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## importCampaignStores > ModelImport importCampaignStores(applicationId, campaignId, opts) Import stores Upload a CSV file containing the stores you want to link to a specific campaign. Send the file as multipart data. The CSV file **must** only contain the following column: - `store_integration_id`: The identifier of the store. The import **replaces** the previous list of stores linked to the campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importCampaignStores(applicationId, campaignId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## importCollection > ModelImport importCollection(applicationId, campaignId, collectionId, opts) Import data into existing campaign-level collection Upload a CSV file containing the collection of string values that should be attached as payload for collection. The file should be sent as multipart data. The import **replaces** the initial content of the collection. The CSV file **must** only contain the following column: - `item`: the values in your collection. A collection is limited to 500,000 items. ## Example ``` item Adidas Nike Asics ``` > [!note] Before sending a request to this endpoint, ensure the data in the > CSV to import is different from the data currently stored in the collection. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let collectionId = 789; // Number | The ID of the collection. You can get it with the [List collections in Application](#tag/Collections/operation/listCollectionsInApplication) endpoint. let opts = { 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importCollection(applicationId, campaignId, collectionId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **collectionId** | **Number**| The ID of the collection. You can get it with the [List collections in Application](#tag/Collections/operation/listCollectionsInApplication) endpoint. | **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## importCoupons > ModelImport importCoupons(applicationId, campaignId, opts) Import coupons Upload a CSV file containing the coupons that should be created. The file should be sent as multipart data. The CSV file contains the following columns: - `value` (required): The coupon code. Must be at least 3 characters long. We recommend using alphanumeric characters. There is no maximum length but limiting the code to 30 characters ensures it is fully readable in the Campaign Manager. The code should be unique unless you set `skipDuplicates` to `true`. - `expirydate`: The end date in RFC3339 of the code redemption period. - `startdate`: The start date in RFC3339 of the code redemption period. - `recipientintegrationid`: The integration ID of the recipient of the coupon. Only the customer with this integration ID can redeem this code. Available only for personal codes. - `limitval`: The maximum number of redemptions of this code. For unlimited redemptions, use `0`. Defaults to `1` when not provided. - `discountlimit`: The total discount value that the code can give. This is typically used to represent a gift card value. - `attributes`: A JSON object describing _custom_ coupon attribute names and their values, enclosed with double quotation marks.<br /> For example, if you created a [custom attribute](https://docs.talon.one/docs/dev/concepts/attributes#custom-attributes) called `category` associated with the coupon entity, the object in the CSV file, when opened in a text editor, must be: `\"{\"category\": \"10_off\"}\"`. You can use the time zone of your choice. It is converted to UTC internally by Talon.One. > [!note] We recommend limiting your file size to 500 MB. ## Example ```text \"value\",\"expirydate\",\"startdate\",\"recipientintegrationid\",\"limitval\",\"attributes\",\"discountlimit\" COUP1,2018-07-01T04:00:00Z,2018-05-01T04:00:00Z,cust123,1,\"{\"\"Category\"\": \"\"10_off\"\"}\",2.4 ``` Once imported, you can find the `batchId` in the Campaign Manager or by using [List coupons](#tag/Coupons/operation/getCouponsWithoutTotalCount). ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'skipDuplicates': true, // Boolean | An indicator of whether to skip duplicate coupon values instead of causing an error. Duplicate values are ignored when `skipDuplicates=true`. 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importCoupons(applicationId, campaignId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **skipDuplicates** | **Boolean**| An indicator of whether to skip duplicate coupon values instead of causing an error. Duplicate values are ignored when `skipDuplicates=true`. | [optional] **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## importLoyaltyCards > ModelImport importLoyaltyCards(loyaltyProgramId, opts) Import loyalty cards Upload a CSV file containing the loyalty cards that you want to use in your card-based loyalty program. Send the file as multipart data. It contains the following columns for each card: - `identifier` (required): The identifier of the loyalty card, which must match the regular expression `^[A-Za-z0-9._%+@-]+$`. - `state` (required): The state of the loyalty card. It can be `active` or `inactive`. - `customerprofileids` (optional): An array of strings representing the identifiers of the customer profiles linked to the loyalty card. The identifiers should be separated with a semicolon (;). - `attributes` (optional): A JSON object that contains the loyalty card's custom attributes and their values. These attributes must be created and connected to this loyalty program before they can be assigned to the cards through this endpoint. > [!note] Your CSV file must contain less than 500,000 rows. Requests time out after 30 seconds. ## Example ```csv identifier,state,customerprofileids,attributes 123-456-789AT,active,Alexa001;UserA,'{\"\"my_attributes\"\": \"\"10_off\"\"}\" ``` ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let opts = { 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importLoyaltyCards(loyaltyProgramId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## importLoyaltyCustomersTiers > ModelImport importLoyaltyCustomersTiers(loyaltyProgramId, opts) Import customers into loyalty tiers Upload a CSV file containing existing customers to be assigned to existing tiers. Send the file as multipart data. > [!important] This endpoint only works with loyalty programs with advanced > tiers (with expiration and downgrade policy) feature enabled. The CSV file should contain the following columns: - `subledgerid` (optional): The ID of the subledger. If this field is empty, the main ledger will be used. - `customerprofileid`: The integration ID of the customer profile to whom the tier should be assigned. - `tiername`: The name of an existing tier to assign to the customer. - `expirydate`: The expiry date of the tier when the tier is reevaluated. It should be a future date. About customer assignment to a tier: - If the customer isn't already in a tier, the customer is assigned to the specified tier during the tier import. - If the customer is already in the tier that's specified in the CSV file, only the expiry date is updated. > [!note] We recommend importing customers into the tier that matches their > current balance. If a customer is imported into a lower tier, any session > or points update automatically upgrades them to the tier they qualify for. To update a customer's tier, you can [add](/management-api#tag/Loyalty/operation/addLoyaltyPoints) or [deduct](/management-api#tag/Loyalty/operation/removeLoyaltyPoints) their loyalty points. You can use the time zone of your choice. It is converted to UTC internally by Talon.One. > [!note] We recommend limiting your file size to 500 MB. ## Example ```csv subledgerid,customerprofileid,tiername,expirydate SUB1,alexa,Gold,2024-03-21T07:32:14Z ,george,Silver,2025-04-16T21:12:37Z SUB2,avocado,Bronze,2026-05-03T11:47:01Z ``` ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let opts = { 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importLoyaltyCustomersTiers(loyaltyProgramId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## importLoyaltyJoinDates > ModelImport importLoyaltyJoinDates(loyaltyProgramId, opts) Import join dates for a loyalty program Upload a CSV file containing customer profile IDs and their join dates for the specified loyalty program. Send the file as multipart data. > [!important] This endpoint only works with profile-based loyalty programs. The CSV file **must** contain the following columns: - `customerprofileid`: The integration ID of the customer profile whose join date you want to update. - `newjoindate`: The new join date for the customer in RFC3339 format. You can use the time zone of your choice. It is converted to UTC internally by Talon.One. **Note**: - Customer profiles must already exist. If a referenced profile does not exist, the import fails with a `400` error. - If a join date already exists for a profile, the uploaded date replaces it. > [!note] We recommend limiting your file size to 500 MB. ## Example ```csv customerprofileid,newjoindate customer1,2024-03-21T07:32:14Z customer2,2025-04-16T21:12:37Z customer3,2026-05-03T11:47:01Z ``` ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the profile-based loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let opts = { 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importLoyaltyJoinDates(loyaltyProgramId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the profile-based loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## importLoyaltyPoints > ModelImport importLoyaltyPoints(loyaltyProgramId, opts) Import loyalty points Upload a CSV file containing the loyalty points you want to import into a given loyalty program. Send the file as multipart data. Depending on the type of loyalty program, you can import points into a given customer profile or loyalty card. The CSV file contains the following columns: - `customerprofileid` (optional): For profile-based loyalty programs, the integration ID of the customer profile where the loyalty points are imported. **Note**: If the customer profile does not exist, it will be created. The profile will not be visible in any Application until a session or profile update is received for that profile. - `identifier` (optional): For card-based loyalty programs, the identifier of the loyalty card where the loyalty points are imported. - `amount`: The amount of points to award to the customer profile. - `startdate` (optional): The earliest date when the points can be redeemed. The points are `active` from this date until the expiration date. This parameter accepts one of the following values: - A timestamp string in RFC3339 format. - `immediate` - `on_action` **Note**: Empty or missing values default to `immediate`. - `expirydate` (optional): The latest date when the points can be redeemed. The points are `expired` after this date. **Note**: It must be an RFC3339 timestamp string or string `unlimited`. Empty or missing values are considered `unlimited`. If passed, `validityDuration` should be omitted. - `validityDuration` (optional): The duration for which the points remain active, relative to the activation date. The time format is an **integer** followed by one letter indicating the time unit.<br /> Examples: `30s`, `40m`, `1h`, `5D`, `7W`, `10M`, `15Y`. Available units: - `s`: seconds - `m`: minutes - `h`: hours - `D`: days - `W`: weeks - `M`: months - `Y`: years You can round certain units up or down: - `_D` for rounding down days only. Signifies the start of the day. - `_U` for rounding up days, weeks, months and years. Signifies the end of the day, week, month or year. If passed, `expirydate` should be omitted. - `subledgerid` (optional): The ID of the subledger that should received the points. - `reason` (optional): The reason why these points are awarded. You can use the time zone of your choice. It is converted to UTC internally by Talon.One. > [!note] For existing customer profiles and loyalty cards, the imported > points are added to any previous active or pending points, depending on the > value provided for `startdate`. If `startdate` matches the current date, the > imported points are _active_. If it is later, the points are _pending_ until > the date provided for `startdate` is reached. > [!note] We recommend limiting your file size to 500 MB. ## Example for profile-based programs ```text customerprofileid,amount,startdate,expirydate,subledgerid,reason URNGV8294NV,100,2009-11-10T23:00:00Z,2009-11-11T23:00:00Z,subledger1,appeasement ``` ## Example for card-based programs ```text identifier,amount,startdate,expirydate,subledgerid,reason summer-loyalty-card-0543,100,2009-11-10T23:00:00Z,2009-11-11T23:00:00Z,subledger1,appeasement ``` ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let opts = { 'notificationsEnabled': true, // Boolean | Indicates whether the points import triggers notifications about its effects. For example, a notification is sent if the import upgrades a customer's tier or offsets their negative points balance. This parameter is optional and defaults to `true`. 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importLoyaltyPoints(loyaltyProgramId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **notificationsEnabled** | **Boolean**| Indicates whether the points import triggers notifications about its effects. For example, a notification is sent if the import upgrades a customer's tier or offsets their negative points balance. This parameter is optional and defaults to `true`. | [optional] **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## importPoolGiveaways > ModelImport importPoolGiveaways(poolId, opts) Import giveaway codes into a giveaway pool Upload a CSV file containing the giveaway codes that should be created. Send the file as multipart data. The CSV file contains the following columns: - `code` (required): The code of your giveaway, for instance, a gift card redemption code. - `startdate`: The start date in RFC3339 of the code redemption period. - `enddate`: The last date in RFC3339 of the code redemption period. - `attributes`: A JSON object describing _custom_ giveaway attribute names and their values, enclosed with double quotation marks.<br /> For example, if you created a [custom attribute](https://docs.talon.one/docs/dev/concepts/attributes#custom-attributes) called `provider` associated with the giveaway entity, the object in the CSV file, when opened in a text editor, must be: `\"{\"provider\": \"myPartnerCompany\"}\"`. The `startdate` and `enddate` have nothing to do with the _validity_ of the codes. They are only used by the Rule Engine to award the codes or not. You can use the time zone setting of your choice. The values are converted to UTC internally by Talon.One. > [!note] **Note** > - We recommend limiting your file size to 500MB. > - You can import the same code multiple times. Duplicate codes are treated and distributed to customers as unique codes. ## Example ```text code,startdate,enddate,attributes GIVEAWAY1,2020-11-10T23:00:00Z,2022-11-11T23:00:00Z,\"{\"\"provider\"\": \"\"Amazon\"\"}\" GIVEAWAY2,2020-11-10T23:00:00Z,2022-11-11T23:00:00Z,\"{\"\"provider\"\": \"\"Amazon\"\"}\" GIVEAWAY3,2021-01-10T23:00:00Z,2022-11-11T23:00:00Z,\"{\"\"provider\"\": \"\"Aliexpress\"\"}\" ``` ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let poolId = 789; // Number | The ID of the pool. You can find it in the Campaign Manager, in the **Giveaways** section. let opts = { 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importPoolGiveaways(poolId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **poolId** | **Number**| The ID of the pool. You can find it in the Campaign Manager, in the **Giveaways** section. | **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## importReferrals > ModelImport importReferrals(applicationId, campaignId, opts) Import referrals Upload a CSV file containing the referrals that should be created. The file should be sent as multipart data. The CSV file contains the following columns: - `code` (required): The referral code. - `advocateprofileintegrationid` (required): The profile ID of the advocate. - `startdate`: The start date in RFC3339 of the code redemption period. - `expirydate`: The end date in RFC3339 of the code redemption period. - `limitval`: The maximum number of redemptions of this code. Defaults to `1` when left blank. - `attributes`: A JSON object describing _custom_ referral attribute names and their values, enclosed with double quotation marks.<br /> For example, if you created a [custom attribute](https://docs.talon.one/docs/dev/concepts/attributes#custom-attributes) called `category` associated with the referral entity, the object in the CSV file, when opened in a text editor, must be: `\"{\"category\": \"10_off\"}\"`. You can use the time zone of your choice. It is converted to UTC internally by Talon.One. > [!important] When you import a CSV file with referrals, > a [customer profile](https://docs.talon.one/docs/dev/concepts/entities/customer-profiles) > is **not** automatically created for each `advocateprofileintegrationid` > column value. Use the [Update customer profile](https://docs.talon.one/integration-api#tag/Customer-profiles/operation/updateCustomerProfileV2) > endpoint or the [Update multiple customer profiles](https://docs.talon.one/integration-api#tag/Customer-profiles/operation/updateCustomerProfilesV2) > endpoint to create the customer profiles. > [!note] We recommend limiting your file size to 500 MB. ## Example ```text code,startdate,expirydate,advocateprofileintegrationid,limitval,attributes REFERRAL_CODE1,2020-11-10T23:00:00Z,2021-11-11T23:00:00Z,integid_4,1,\"{\"\"my_attribute\"\": \"\"10_off\"\"}\" REFERRAL_CODE2,2020-11-10T23:00:00Z,2021-11-11T23:00:00Z,integid1,1,\"{\"\"my_attribute\"\": \"\"20_off\"\"}\" ``` ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'upFile': "/path/to/file" // File | The CSV file containing the data that is being imported. }; apiInstance.importReferrals(applicationId, campaignId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **upFile** | **File**| The CSV file containing the data that is being imported. | [optional] ### Return type [**ModelImport**](ModelImport.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ## inviteUserExternal > inviteUserExternal(body) Invite user from identity provider [Invite a user](https://docs.talon.one/docs/product/account/account-settings/managing-users#inviting-a-user) from an external identity provider to Talon.One by sending an invitation to their email address. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.NewExternalInvitation(); // NewExternalInvitation | body apiInstance.inviteUserExternal(body).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**NewExternalInvitation**](NewExternalInvitation.md)| body | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: Not defined ## listAccountCollections > InlineResponse20022 listAccountCollections(opts) List collections in account List account-level collections in the account. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'withTotalResultSize': true, // Boolean | When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. 'name': "name_example" // String | Filter by collection name. }; apiInstance.listAccountCollections(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **withTotalResultSize** | **Boolean**| When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. | [optional] **name** | **String**| Filter by collection name. | [optional] ### Return type [**InlineResponse20022**](InlineResponse20022.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## listAchievements > InlineResponse20052 listAchievements(applicationId, campaignId, opts) List achievements List all the achievements for a specific campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 50, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'title': "title_example" // String | Filter by the display name for the achievement in the campaign manager. **Note**: If no `title` is provided, all the achievements from the campaign are returned. }; apiInstance.listAchievements(applicationId, campaignId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 50] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **title** | **String**| Filter by the display name for the achievement in the campaign manager. **Note**: If no `title` is provided, all the achievements from the campaign are returned. | [optional] ### Return type [**InlineResponse20052**](InlineResponse20052.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## listAchievementsV2 > InlineResponse20053 listAchievementsV2(opts) List achievements List all achievements. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let opts = { 'pageSize': 50, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'title': "title_example", // String | Filter by the display name of the achievement. 'applicationId': 789 // Number | Filter by the ID of an Application connected to the achievement. }; apiInstance.listAchievementsV2(opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pageSize** | **Number**| The number of items in the response. | [optional] [default to 50] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **title** | **String**| Filter by the display name of the achievement. | [optional] **applicationId** | **Number**| Filter by the ID of an Application connected to the achievement. | [optional] ### Return type [**InlineResponse20053**](InlineResponse20053.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## listAllRolesV2 > InlineResponse20047 listAllRolesV2() List roles List all roles. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); apiInstance.listAllRolesV2().then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters This endpoint does not need any parameter. ### Return type [**InlineResponse20047**](InlineResponse20047.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## listApplicationCartItemFilters > InlineResponse20049 listApplicationCartItemFilters(applicationId, opts) List Application cart item filters Return all the Application cart item filters for a specific Application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 50, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'name': "name_example" // String | Filter by the display name of the Application cart item filter in the Application. **Note**: If no `name` is provided, all the Application cart item filters in the Application are returned. }; apiInstance.listApplicationCartItemFilters(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 50] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **name** | **String**| Filter by the display name of the Application cart item filter in the Application. **Note**: If no `name` is provided, all the Application cart item filters in the Application are returned. | [optional] ### Return type [**InlineResponse20049**](InlineResponse20049.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## listCampaignStoreBudgetLimits > InlineResponse20050 listCampaignStoreBudgetLimits(applicationId, campaignId, opts) List campaign store budget limits Return the store budget limits for a given campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'action': "action_example", // String | The action that this budget is limiting. 'period': "period_example" // String | The period to which the limit applies. **Note**: For budgets with no period, set this to `overall`. }; apiInstance.listCampaignStoreBudgetLimits(applicationId, campaignId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **action** | **String**| The action that this budget is limiting. | [optional] **period** | **String**| The period to which the limit applies. **Note**: For budgets with no period, set this to `overall`. | [optional] ### Return type [**InlineResponse20050**](InlineResponse20050.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## listCatalogItems > InlineResponse20040 listCatalogItems(catalogId, opts) List items in a catalog Return a paginated list of cart items in the given catalog. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let catalogId = 789; // Number | The ID of the catalog. You can find the ID in the Campaign Manager in **Account** > **Tools** > **Cart item catalogs**. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'withTotalResultSize': true, // Boolean | When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. 'sku': ["null"], // [String] | Filter results by one or more SKUs. Must be exact match. 'productNames': ["null"] // [String] | Filter results by one or more product names. Must be exact match. }; apiInstance.listCatalogItems(catalogId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **catalogId** | **Number**| The ID of the catalog. You can find the ID in the Campaign Manager in **Account** > **Tools** > **Cart item catalogs**. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **withTotalResultSize** | **Boolean**| When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. | [optional] **sku** | [**[String]**](String.md)| Filter results by one or more SKUs. Must be exact match. | [optional] **productNames** | [**[String]**](String.md)| Filter results by one or more product names. Must be exact match. | [optional] ### Return type [**InlineResponse20040**](InlineResponse20040.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## listCollections > InlineResponse20022 listCollections(applicationId, campaignId, opts) List collections in campaign List collections in a given campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'withTotalResultSize': true, // Boolean | When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. 'name': "name_example" // String | Filter by collection name. }; apiInstance.listCollections(applicationId, campaignId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **withTotalResultSize** | **Boolean**| When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. | [optional] **name** | **String**| Filter by collection name. | [optional] ### Return type [**InlineResponse20022**](InlineResponse20022.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## listCollectionsInApplication > InlineResponse20022 listCollectionsInApplication(applicationId, opts) List collections in Application List campaign-level collections from all campaigns in a given Application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'withTotalResultSize': true, // Boolean | When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. 'name': "name_example" // String | Filter by collection name. }; apiInstance.listCollectionsInApplication(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **withTotalResultSize** | **Boolean**| When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. | [optional] **name** | **String**| Filter by collection name. | [optional] ### Return type [**InlineResponse20022**](InlineResponse20022.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## listExperiments > InlineResponse20016 listExperiments(applicationId, opts) List experiments List all experiments of the specified Application that match your filter criteria. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example" // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. }; apiInstance.listExperiments(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] ### Return type [**InlineResponse20016**](InlineResponse20016.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## listStores > InlineResponse20048 listStores(applicationId, opts) List stores List all stores for a specific Application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'withTotalResultSize': true, // Boolean | When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. 'campaignId': 3.4, // Number | Filter results by campaign ID. 'name': "name_example", // String | The name of the store. 'integrationId': "integrationId_example", // String | The integration ID of the store. 'query': "query_example" // String | Filter results by `name` or `integrationId`. }; apiInstance.listStores(applicationId, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **withTotalResultSize** | **Boolean**| When this flag is set, the result includes the total number of results for this query. This might decrease performance on large data sets. - When `true`: `totalResultSize` contains the total number of results for this query. - When `false`: Only `hasMore` is returned, and it is set to `true` when there are more results than shown on the page. | [optional] **campaignId** | **Number**| Filter results by campaign ID. | [optional] **name** | **String**| The name of the store. | [optional] **integrationId** | **String**| The integration ID of the store. | [optional] **query** | **String**| Filter results by `name` or `integrationId`. | [optional] ### Return type [**InlineResponse20048**](InlineResponse20048.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## oktaEventHandlerChallenge > oktaEventHandlerChallenge() Validate Okta API ownership Validate the ownership of the API through a challenge-response mechanism. This challenger endpoint is used by Okta to confirm that communication between Talon.One and Okta is correctly configured and accessible for provisioning and deprovisioning of Talon.One users, and that only Talon.One can receive and respond to events from Okta. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); apiInstance.oktaEventHandlerChallenge().then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters This endpoint does not need any parameter. ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: Not defined ## priceHistory > PriceHistoryResponse priceHistory(applicationId, body) Get summary of price history Fetch the historical price data for a given SKU within a defined timeframe. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let body = new TalonOne.PriceHistoryRequest(); // PriceHistoryRequest | body apiInstance.priceHistory(applicationId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **body** | [**PriceHistoryRequest**](PriceHistoryRequest.md)| body | ### Return type [**PriceHistoryResponse**](PriceHistoryResponse.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## removeLoyaltyPoints > removeLoyaltyPoints(loyaltyProgramId, integrationId, body) Deduct points from customer profile Deduct points from the specified loyalty program and specified customer profile. > [!note] **Note** > - Only active points can be deducted. > - Only pending points are rolled back when a session is cancelled or reopened. To get the `integrationId` of the profile from a `sessionId`, use the [Update customer session](https://docs.talon.one/integration-api#tag/Customer-sessions/operation/updateCustomerSessionV2) endpoint. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = "loyaltyProgramId_example"; // String | The identifier for the loyalty program. let integrationId = "integrationId_example"; // String | The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. let body = new TalonOne.DeductLoyaltyPoints(); // DeductLoyaltyPoints | body apiInstance.removeLoyaltyPoints(loyaltyProgramId, integrationId, body).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **String**| The identifier for the loyalty program. | **integrationId** | **String**| The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID. Once set, you cannot update this identifier. | **body** | [**DeductLoyaltyPoints**](DeductLoyaltyPoints.md)| body | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## resetPassword > NewPassword resetPassword(body) Reset password Consumes the supplied password reset token and updates the password for the associated account. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.NewPassword(); // NewPassword | body apiInstance.resetPassword(body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**NewPassword**](NewPassword.md)| body | ### Return type [**NewPassword**](NewPassword.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## scimCreateGroup > ScimGroup scimCreateGroup(body) Create SCIM group Create a new Talon.One group using the SCIM Group provisioning protocol with an identity provider, for example, Microsoft Entra ID, and assign members from the payload to the new group. In Talon.One, a `Group` corresponds to a [role](https://docs.talon.one/docs/product/account/account-settings/managing-roles), and `members` are the [users](https://docs.talon.one/docs/product/account/account-settings/managing-users) assigned to that role. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.ScimBaseGroup(); // ScimBaseGroup | body apiInstance.scimCreateGroup(body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**ScimBaseGroup**](ScimBaseGroup.md)| body | ### Return type [**ScimGroup**](ScimGroup.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## scimCreateUser > ScimUser scimCreateUser(body) Create SCIM user Create a new Talon.One user using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let body = new TalonOne.ScimNewUser(); // ScimNewUser | body apiInstance.scimCreateUser(body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **body** | [**ScimNewUser**](ScimNewUser.md)| body | ### Return type [**ScimUser**](ScimUser.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## scimDeleteGroup > scimDeleteGroup(groupId) Delete SCIM group Delete a specific group created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. In Talon.One, a `Group` corresponds to a [role](https://docs.talon.one/docs/product/account/account-settings/managing-roles), and `members` are the [users](https://docs.talon.one/docs/product/account/account-settings/managing-users) assigned to that role. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let groupId = 789; // Number | The ID of the group. apiInstance.scimDeleteGroup(groupId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **groupId** | **Number**| The ID of the group. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: Not defined ## scimDeleteUser > scimDeleteUser(userId) Delete SCIM user Delete a specific Talon.One user created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let userId = 789; // Number | The ID of the user. apiInstance.scimDeleteUser(userId).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **userId** | **Number**| The ID of the user. | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: Not defined ## scimGetGroup > ScimGroup scimGetGroup(groupId) Get SCIM group Retrieve data for a specific group created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. In Talon.One, a `Group` corresponds to a [role](https://docs.talon.one/docs/product/account/account-settings/managing-roles), and `members` are the [users](https://docs.talon.one/docs/product/account/account-settings/managing-users) assigned to that role. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let groupId = 789; // Number | The ID of the group. apiInstance.scimGetGroup(groupId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **groupId** | **Number**| The ID of the group. | ### Return type [**ScimGroup**](ScimGroup.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## scimGetGroups > ScimGroupsListResponse scimGetGroups() List SCIM groups Retrieve a paginated list of groups created using the SCIM protocol with an identity provider, for example, Microsoft Entra ID. In Talon.One, a `Group` corresponds to a [role](https://docs.talon.one/docs/product/account/account-settings/managing-roles), and `members` are the [users](https://docs.talon.one/docs/product/account/account-settings/managing-users) assigned to that role. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); apiInstance.scimGetGroups().then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters This endpoint does not need any parameter. ### Return type [**ScimGroupsListResponse**](ScimGroupsListResponse.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## scimGetResourceTypes > ScimResourceTypesListResponse scimGetResourceTypes() List supported SCIM resource types Retrieve a list of resource types supported by the SCIM provisioning protocol. Resource types define the various kinds of resources that can be managed via the SCIM API, such as users, groups, or custom-defined resources. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); apiInstance.scimGetResourceTypes().then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters This endpoint does not need any parameter. ### Return type [**ScimResourceTypesListResponse**](ScimResourceTypesListResponse.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## scimGetSchemas > ScimSchemasListResponse scimGetSchemas() List supported SCIM schemas Retrieve a list of schemas supported by the SCIM provisioning protocol. Schemas define the structure and attributes of the different resources that can be managed via the SCIM API, such as users, groups, and any custom-defined resources. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); apiInstance.scimGetSchemas().then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters This endpoint does not need any parameter. ### Return type [**ScimSchemasListResponse**](ScimSchemasListResponse.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## scimGetServiceProviderConfig > ScimServiceProviderConfigResponse scimGetServiceProviderConfig() Get SCIM service provider configuration Retrieve the configuration settings of the SCIM service provider. It provides details about the features and capabilities supported by the SCIM API, such as the different operation settings. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); apiInstance.scimGetServiceProviderConfig().then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters This endpoint does not need any parameter. ### Return type [**ScimServiceProviderConfigResponse**](ScimServiceProviderConfigResponse.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## scimGetUser > ScimUser scimGetUser(userId) Get SCIM user Retrieve data for a specific Talon.One user created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let userId = 789; // Number | The ID of the user. apiInstance.scimGetUser(userId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **userId** | **Number**| The ID of the user. | ### Return type [**ScimUser**](ScimUser.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## scimGetUsers > ScimUsersListResponse scimGetUsers() List SCIM users Retrieve a paginated list of users that have been provisioned using the SCIM protocol with an identity provider, for example, Microsoft Entra ID. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); apiInstance.scimGetUsers().then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters This endpoint does not need any parameter. ### Return type [**ScimUsersListResponse**](ScimUsersListResponse.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## scimPatchGroup > ScimGroup scimPatchGroup(groupId, body) Update SCIM group attributes Update certain attributes of a group created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. This endpoint allows for selective adding, removing, or replacing of specific group attributes while other attributes remain unchanged. In Talon.One, a `Group` corresponds to a [role](https://docs.talon.one/docs/product/account/account-settings/managing-roles), and `members` are the [users](https://docs.talon.one/docs/product/account/account-settings/managing-users) assigned to that role. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let groupId = 789; // Number | The ID of the group. let body = new TalonOne.ScimPatchRequest(); // ScimPatchRequest | body apiInstance.scimPatchGroup(groupId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **groupId** | **Number**| The ID of the group. | **body** | [**ScimPatchRequest**](ScimPatchRequest.md)| body | ### Return type [**ScimGroup**](ScimGroup.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## scimPatchUser > ScimUser scimPatchUser(userId, body) Update SCIM user attributes Update certain attributes of a specific Talon.One user created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. This endpoint allows for selective adding, removing, or replacing specific attributes while leaving other attributes unchanged. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let userId = 789; // Number | The ID of the user. let body = new TalonOne.ScimPatchRequest(); // ScimPatchRequest | body apiInstance.scimPatchUser(userId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **userId** | **Number**| The ID of the user. | **body** | [**ScimPatchRequest**](ScimPatchRequest.md)| body | ### Return type [**ScimUser**](ScimUser.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## scimReplaceGroupAttributes > ScimGroup scimReplaceGroupAttributes(groupId, body) Update SCIM group Update the details of a specific group created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. This endpoint replaces all attributes of the given group with the attributes provided in the request payload. In Talon.One, a `Group` corresponds to a [role](https://docs.talon.one/docs/product/account/account-settings/managing-roles), and `members` are the [users](https://docs.talon.one/docs/product/account/account-settings/managing-users) assigned to that role. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let groupId = 789; // Number | The ID of the group. let body = new TalonOne.ScimBaseGroup(); // ScimBaseGroup | body apiInstance.scimReplaceGroupAttributes(groupId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **groupId** | **Number**| The ID of the group. | **body** | [**ScimBaseGroup**](ScimBaseGroup.md)| body | ### Return type [**ScimGroup**](ScimGroup.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## scimReplaceUserAttributes > ScimUser scimReplaceUserAttributes(userId, body) Update SCIM user Update the details of a specific Talon.One user created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. This endpoint replaces all attributes of the specific user with the attributes provided in the request payload. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let userId = 789; // Number | The ID of the user. let body = new TalonOne.ScimNewUser(); // ScimNewUser | body apiInstance.scimReplaceUserAttributes(userId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **userId** | **Number**| The ID of the user. | **body** | [**ScimNewUser**](ScimNewUser.md)| body | ### Return type [**ScimUser**](ScimUser.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## searchCouponsAdvancedApplicationWideWithoutTotalCount > InlineResponse20012 searchCouponsAdvancedApplicationWideWithoutTotalCount(applicationId, body, opts) List coupons that match the given attributes (without total count) List the coupons whose attributes match the query criteria in all the campaigns of the given Application. The match is successful if all the attributes of the request are found in a coupon, even if the coupon has more attributes that are not present on the request. > [!note] The total count is not included in the response. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let body = null; // Object | body let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'value': "value_example", // String | Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'valid': "valid_example", // String | Either \"expired\", \"validNow\", or \"validFuture\". The first option matches coupons in which the expiration date is set and in the past. The second matches coupons in which start date is null or in the past and expiration date is null or in the future, the third matches coupons in which start date is set and in the future. 'usable': "usable_example", // String | Either \"true\" or \"false\". If \"true\", only coupons where `usageCounter < usageLimit` will be returned, \"false\" will return only coupons where `usageCounter >= usageLimit`. 'referralId': 789, // Number | Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. 'recipientIntegrationId': "recipientIntegrationId_example", // String | Filter results by match with a profile ID specified in the coupon's RecipientIntegrationId field. 'batchId': "batchId_example", // String | Filter results by batches of coupons 'exactMatch': false, // Boolean | Filter results to an exact case-insensitive matching against the coupon code. 'campaignState': "campaignState_example" // String | Filter results by the state of the campaign. - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. }; apiInstance.searchCouponsAdvancedApplicationWideWithoutTotalCount(applicationId, body, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **body** | **Object**| body | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **value** | **String**| Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. | [optional] **createdBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **createdAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **valid** | **String**| Either \"expired\", \"validNow\", or \"validFuture\". The first option matches coupons in which the expiration date is set and in the past. The second matches coupons in which start date is null or in the past and expiration date is null or in the future, the third matches coupons in which start date is set and in the future. | [optional] **usable** | **String**| Either \"true\" or \"false\". If \"true\", only coupons where `usageCounter < usageLimit` will be returned, \"false\" will return only coupons where `usageCounter >= usageLimit`. | [optional] **referralId** | **Number**| Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. | [optional] **recipientIntegrationId** | **String**| Filter results by match with a profile ID specified in the coupon's RecipientIntegrationId field. | [optional] **batchId** | **String**| Filter results by batches of coupons | [optional] **exactMatch** | **Boolean**| Filter results to an exact case-insensitive matching against the coupon code. | [optional] [default to false] **campaignState** | **String**| Filter results by the state of the campaign. - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. | [optional] ### Return type [**InlineResponse20012**](InlineResponse20012.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## searchCouponsAdvancedWithoutTotalCount > InlineResponse20012 searchCouponsAdvancedWithoutTotalCount(applicationId, campaignId, body, opts) List coupons that match the given attributes in campaign (without total count) List the coupons whose attributes match the query criteria in the given campaign. The match is successful if all the attributes of the request are found in a coupon, even if the coupon has more attributes that are not present on the request. > [!note] The total count is not included in the response. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let body = null; // Object | body let opts = { 'pageSize': 1000, // Number | The number of items in the response. 'skip': 789, // Number | The number of items to skip when paging through large result sets. 'sort': "sort_example", // String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 'value': "value_example", // String | Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. 'createdBefore': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'createdAfter': new Date("2013-10-20T19:20:30+01:00"), // Date | Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. 'valid': "valid_example", // String | Either \"expired\", \"validNow\", or \"validFuture\". The first option matches coupons in which the expiration date is set and in the past. The second matches coupons in which start date is null or in the past and expiration date is null or in the future, the third matches coupons in which start date is set and in the future. 'usable': "usable_example", // String | Either \"true\" or \"false\". If \"true\", only coupons where `usageCounter < usageLimit` will be returned, \"false\" will return only coupons where `usageCounter >= usageLimit`. 'referralId': 789, // Number | Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. 'recipientIntegrationId': "recipientIntegrationId_example", // String | Filter results by match with a profile ID specified in the coupon's RecipientIntegrationId field. 'exactMatch': false, // Boolean | Filter results to an exact case-insensitive matching against the coupon code. 'batchId': "batchId_example" // String | Filter results by batches of coupons }; apiInstance.searchCouponsAdvancedWithoutTotalCount(applicationId, campaignId, body, opts).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **body** | **Object**| body | **pageSize** | **Number**| The number of items in the response. | [optional] [default to 1000] **skip** | **Number**| The number of items to skip when paging through large result sets. | [optional] **sort** | **String**| The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`. **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. | [optional] **value** | **String**| Filter results performing case-insensitive matching against the coupon code. Both the code and the query are folded to remove all non-alpha-numeric characters. | [optional] **createdBefore** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **createdAfter** | **Date**| Filter results comparing the parameter value, expected to be an RFC3339 timestamp string, to the coupon creation timestamp. You can use any time zone setting. Talon.One will convert to UTC internally. | [optional] **valid** | **String**| Either \"expired\", \"validNow\", or \"validFuture\". The first option matches coupons in which the expiration date is set and in the past. The second matches coupons in which start date is null or in the past and expiration date is null or in the future, the third matches coupons in which start date is set and in the future. | [optional] **usable** | **String**| Either \"true\" or \"false\". If \"true\", only coupons where `usageCounter < usageLimit` will be returned, \"false\" will return only coupons where `usageCounter >= usageLimit`. | [optional] **referralId** | **Number**| Filter the results by matching them with the ID of a referral. This filter shows the coupons created by redeeming a referral code. | [optional] **recipientIntegrationId** | **String**| Filter results by match with a profile ID specified in the coupon's RecipientIntegrationId field. | [optional] **exactMatch** | **Boolean**| Filter results to an exact case-insensitive matching against the coupon code. | [optional] [default to false] **batchId** | **String**| Filter results by batches of coupons | [optional] ### Return type [**InlineResponse20012**](InlineResponse20012.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## summarizeCampaignStoreBudget > InlineResponse20051 summarizeCampaignStoreBudget(applicationId, campaignId) Get summary of campaign store budgets Fetch a summary of all store budget information for a given campaign. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. apiInstance.summarizeCampaignStoreBudget(applicationId, campaignId).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | ### Return type [**InlineResponse20051**](InlineResponse20051.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ## transferLoyaltyCard > transferLoyaltyCard(loyaltyProgramId, loyaltyCardId, body) Transfer card data Transfer loyalty card data, such as linked customers, loyalty balances and transactions, from a given loyalty card to a new, automatically created loyalty card. > [!important] **Note** > - The original card is automatically blocked once the new card is created, and it cannot be activated again. > - The default status of the new card is _active_. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let loyaltyCardId = "loyaltyCardId_example"; // String | Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. let body = new TalonOne.TransferLoyaltyCard(); // TransferLoyaltyCard | body apiInstance.transferLoyaltyCard(loyaltyProgramId, loyaltyCardId, body).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **loyaltyCardId** | **String**| Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. | **body** | [**TransferLoyaltyCard**](TransferLoyaltyCard.md)| body | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateAccountCollection > Collection updateAccountCollection(collectionId, body) Update account-level collection Edit the description of a given account-level collection and enable or disable the collection in the specified Applications. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let collectionId = 789; // Number | The ID of the collection. You can get it with the [List collections in account](#tag/Collections/operation/listAccountCollections) endpoint. let body = new TalonOne.UpdateCollection(); // UpdateCollection | body apiInstance.updateAccountCollection(collectionId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **collectionId** | **Number**| The ID of the collection. You can get it with the [List collections in account](#tag/Collections/operation/listAccountCollections) endpoint. | **body** | [**UpdateCollection**](UpdateCollection.md)| body | ### Return type [**Collection**](Collection.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateAchievement > Achievement updateAchievement(applicationId, campaignId, achievementId, body) Update achievement Update the details of a specific achievement. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let achievementId = 789; // Number | The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievements) endpoint. let body = new TalonOne.UpdateAchievement(); // UpdateAchievement | body apiInstance.updateAchievement(applicationId, campaignId, achievementId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **achievementId** | **Number**| The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievements) endpoint. | **body** | [**UpdateAchievement**](UpdateAchievement.md)| body | ### Return type [**Achievement**](Achievement.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateAchievementV2 > AchievementV2 updateAchievementV2(achievementId, body) Update achievement Update the details of a specific achievement. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let achievementId = 789; // Number | The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievementsV2) endpoint. let body = new TalonOne.UpdateAchievementV2(); // UpdateAchievementV2 | body apiInstance.updateAchievementV2(achievementId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **achievementId** | **Number**| The ID of the achievement. You can get this ID with the [List achievement](https://docs.talon.one/management-api#tag/Achievements/operation/listAchievementsV2) endpoint. | **body** | [**UpdateAchievementV2**](UpdateAchievementV2.md)| body | ### Return type [**AchievementV2**](AchievementV2.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateAdditionalCost > AccountAdditionalCost updateAdditionalCost(additionalCostId, body) Update additional cost Updates an existing additional cost. Once created, the only property of an additional cost that cannot be changed is the `name` property (or **API name** in the Campaign Manager). This restriction is in place to prevent accidentally breaking live integrations. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let additionalCostId = 789; // Number | The ID of the additional cost. You can find the ID the the Campaign Manager's URL when you display the details of the cost in **Account** > **Tools** > **Additional costs**. let body = new TalonOne.NewAdditionalCost(); // NewAdditionalCost | body apiInstance.updateAdditionalCost(additionalCostId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **additionalCostId** | **Number**| The ID of the additional cost. You can find the ID the the Campaign Manager's URL when you display the details of the cost in **Account** > **Tools** > **Additional costs**. | **body** | [**NewAdditionalCost**](NewAdditionalCost.md)| body | ### Return type [**AccountAdditionalCost**](AccountAdditionalCost.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateAttribute > Attribute updateAttribute(attributeId, body) Update custom attribute Update an existing custom attribute. Once created, the only property of a custom attribute that can be changed is the description. To change the `type` or `name` property of a custom attribute, create a new attribute and update any relevant integrations and rules to use the new attribute. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let attributeId = 789; // Number | The ID of the attribute. You can find the ID in the Campaign Manager's URL when you display the details of an attribute in **Account** > **Tools** > **Attributes**. let body = new TalonOne.NewAttribute(); // NewAttribute | body apiInstance.updateAttribute(attributeId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **attributeId** | **Number**| The ID of the attribute. You can find the ID in the Campaign Manager's URL when you display the details of an attribute in **Account** > **Tools** > **Attributes**. | **body** | [**NewAttribute**](NewAttribute.md)| body | ### Return type [**Attribute**](Attribute.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateCampaign > Campaign updateCampaign(applicationId, campaignId, body) Update campaign Update the given campaign. > [!important] You cannot use this endpoint to update campaigns if [campaign staging and > revisions](https://docs.talon.one/docs/product/applications/managing-general-settings#campaign-staging-and-revisions) > is enabled for your Application. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let body = new TalonOne.UpdateCampaign(); // UpdateCampaign | body apiInstance.updateCampaign(applicationId, campaignId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **body** | [**UpdateCampaign**](UpdateCampaign.md)| body | ### Return type [**Campaign**](Campaign.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateCollection > Collection updateCollection(applicationId, campaignId, collectionId, body) Update campaign-level collection's description Edit the description of a given campaign-level collection. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let collectionId = 789; // Number | The ID of the collection. You can get it with the [List collections in Application](#tag/Collections/operation/listCollectionsInApplication) endpoint. let body = new TalonOne.UpdateCampaignCollection(); // UpdateCampaignCollection | body apiInstance.updateCollection(applicationId, campaignId, collectionId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **collectionId** | **Number**| The ID of the collection. You can get it with the [List collections in Application](#tag/Collections/operation/listCollectionsInApplication) endpoint. | **body** | [**UpdateCampaignCollection**](UpdateCampaignCollection.md)| body | ### Return type [**Collection**](Collection.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateCoupon > Coupon updateCoupon(applicationId, campaignId, couponId, body) Update coupon Update the specified coupon. > [!note] > With this `PUT` endpoint, if you do not explicitly set a value for the `startDate`, `expiryDate`, > and `recipientIntegrationId` properties in your request, it is automatically set to `null`. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let couponId = "couponId_example"; // String | The internal ID of the coupon code. You can find this value in the `id` property from the [List coupons](https://docs.talon.one/management-api#tag/Coupons/operation/getCouponsWithoutTotalCount) endpoint response. let body = new TalonOne.UpdateCoupon(); // UpdateCoupon | body apiInstance.updateCoupon(applicationId, campaignId, couponId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **couponId** | **String**| The internal ID of the coupon code. You can find this value in the `id` property from the [List coupons](https://docs.talon.one/management-api#tag/Coupons/operation/getCouponsWithoutTotalCount) endpoint response. | **body** | [**UpdateCoupon**](UpdateCoupon.md)| body | ### Return type [**Coupon**](Coupon.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateCouponBatch > updateCouponBatch(applicationId, campaignId, body) Update coupons Update all coupons or a specific batch of coupons in the given campaign. You can find the `batchId` on the **Coupons** page of your campaign in the Campaign Manager, or you can use [List coupons](#tag/Coupons/operation/getCouponsWithoutTotalCount). > [!note] **Note** > - Only send sequential requests to this endpoint. > - Requests to this endpoint time out after 30 minutes. If you hit a timeout, contact our support team. > - With this `PUT` endpoint, if you do not explicitly set a value for the `startDate` and `expiryDate` properties in your request, it is automatically set to `null`. To update a specific coupon, use [Update coupon](#tag/Coupons/operation/updateCoupon). ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let body = new TalonOne.UpdateCouponBatch(); // UpdateCouponBatch | body apiInstance.updateCouponBatch(applicationId, campaignId, body).then(() => { console.log('API called successfully.'); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **body** | [**UpdateCouponBatch**](UpdateCouponBatch.md)| body | ### Return type null (empty response body) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: Not defined ## updateLoyaltyCard > LoyaltyCard updateLoyaltyCard(loyaltyProgramId, loyaltyCardId, body) Update loyalty card Update the details of a specific loyalty card. You can set the card's status to `active` or `inactive` through this endpoint. At least one of `status` or `attributes` must be provided. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let loyaltyProgramId = 789; // Number | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. let loyaltyCardId = "loyaltyCardId_example"; // String | Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. let body = new TalonOne.UpdateLoyaltyCardRequest(); // UpdateLoyaltyCardRequest | body apiInstance.updateLoyaltyCard(loyaltyProgramId, loyaltyCardId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **loyaltyProgramId** | **Number**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. | **loyaltyCardId** | **String**| Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. **Important**: The loyalty card ID requires [URL encoding](https://www.w3schools.com/tags//ref_urlencode.asp) if it contains special characters. For example, you must encode `NewCard2026%` as `NewCard2026%25`. | **body** | [**UpdateLoyaltyCardRequest**](UpdateLoyaltyCardRequest.md)| body | ### Return type [**LoyaltyCard**](LoyaltyCard.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateReferral > Referral updateReferral(applicationId, campaignId, referralId, body) Update referral Update the specified referral. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let campaignId = 789; // Number | The ID of the campaign. It is displayed in your Talon.One deployment URL. let referralId = "referralId_example"; // String | The ID of the referral code. let body = new TalonOne.UpdateReferral(); // UpdateReferral | body apiInstance.updateReferral(applicationId, campaignId, referralId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **campaignId** | **Number**| The ID of the campaign. It is displayed in your Talon.One deployment URL. | **referralId** | **String**| The ID of the referral code. | **body** | [**UpdateReferral**](UpdateReferral.md)| body | ### Return type [**Referral**](Referral.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateRoleV2 > RoleV2 updateRoleV2(roleId, body) Update role Update a specific role. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let roleId = 789; // Number | The ID of role. **Note**: To find the ID of a role, use the [List roles](/management-api#tag/Roles/operation/listAllRolesV2) endpoint. let body = new TalonOne.RoleV2Base(); // RoleV2Base | body apiInstance.updateRoleV2(roleId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **roleId** | **Number**| The ID of role. **Note**: To find the ID of a role, use the [List roles](/management-api#tag/Roles/operation/listAllRolesV2) endpoint. | **body** | [**RoleV2Base**](RoleV2Base.md)| body | ### Return type [**RoleV2**](RoleV2.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateStore > Store updateStore(applicationId, storeId, body) Update store Update store details for a specific store ID. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let applicationId = 789; // Number | The ID of the Application. It is displayed in your Talon.One deployment URL. let storeId = "storeId_example"; // String | The ID of the store. You can get this ID with the [List stores](#tag/Stores/operation/listStores) endpoint. let body = new TalonOne.NewStore(); // NewStore | body apiInstance.updateStore(applicationId, storeId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **applicationId** | **Number**| The ID of the Application. It is displayed in your Talon.One deployment URL. | **storeId** | **String**| The ID of the store. You can get this ID with the [List stores](#tag/Stores/operation/listStores) endpoint. | **body** | [**NewStore**](NewStore.md)| body | ### Return type [**Store**](Store.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ## updateUser > User updateUser(userId, body) Update user Update the details of a specific user. ### Example ```javascript import TalonOne from 'talon_one'; let defaultClient = TalonOne.ApiClient.instance; // Configure API key authorization: api_key_v1 let api_key_v1 = defaultClient.authentications['api_key_v1']; api_key_v1.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //api_key_v1.apiKeyPrefix = 'Token'; // Configure API key authorization: management_key let management_key = defaultClient.authentications['management_key']; management_key.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //management_key.apiKeyPrefix = 'Token'; // Configure API key authorization: manager_auth let manager_auth = defaultClient.authentications['manager_auth']; manager_auth.apiKey = 'YOUR API KEY'; // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null) //manager_auth.apiKeyPrefix = 'Token'; let apiInstance = new TalonOne.ManagementApi(); let userId = 789; // Number | The ID of the user. let body = new TalonOne.UpdateUser(); // UpdateUser | body apiInstance.updateUser(userId, body).then((data) => { console.log('API called successfully. Returned data: ' + data); }, (error) => { console.error(error); }); ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **userId** | **Number**| The ID of the user. | **body** | [**UpdateUser**](UpdateUser.md)| body | ### Return type [**User**](User.md) ### Authorization [api_key_v1](../README.md#api_key_v1), [management_key](../README.md#management_key), [manager_auth](../README.md#manager_auth) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json