talon_one_sdk 26.10.0 → 26.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a336bbbe1183f35e30562723e3d0e9c2c3483878223d6119e7168718f72abaa
-  data.tar.gz: 0b70417abe3379c783c590dd93896176de15f21d25220a45123133fca80c8be8
+  metadata.gz: 85d4694d2c1de4a455fee9a76e0b529939dfbcb2fa6175fd213d99a39c7253f7
+  data.tar.gz: e6841d21f623fb87a72cdd5ae800e1a4f4ded1fe7a94b350fb2dc999fd8c00fe
 SHA512:
-  metadata.gz: 5b52be179397d4c2c26c0dfd21083241386b98ad3adc85d7b16990c33dc574fc6319aad3bc01e52a087d0d0881e47ac3596b2a653dc573381f94fbdcaf20455b
-  data.tar.gz: 2319fb5d63bc1f80cf094a9ef2721db509f632003d9c4d1ff0b4046bc0edea2d46324f6c00024bbfaf04ade88be835bc96782e348d63d7c4ed7874620923428f
+  metadata.gz: 45884e4e34a1954bce59b4a79ed58f0e64f21342bf093a388053dd12bdfeb7943ca8fc451bc621a9fa4a6946d6cc7b36d0d9452ab44f5059a9f2b060bf81ca76
+  data.tar.gz: a2da07dcc84447cdb22293ddb2dcb48fd5b13ec55a0fd8e292c42f98a8a356246b0220ba787f8f8034f0b797040dd491b679803597ddf3cf30d0ac4d798e8413

data/README.md

@@ -16,7 +16,7 @@ See our [migration guide](MIGRATION.md).
 Add this to the Gemfile:
 
 ```shell
-gem 'talon_one_sdk', '~> 26.10.0'
+gem 'talon_one_sdk', '~> 26.11.0'
 ```
 
 ### Build a gem
@@ -32,10 +32,10 @@ gem build talon_one_sdk.gemspec
 To install the gem locally:
 
 ```shell
-gem install ./talon_one_sdk-26.10.0.gem
+gem install ./talon_one_sdk-26.11.0.gem
 ```
 
-For development, run `gem install --dev ./talon_one_sdk-26.10.0.gem` to install the development dependencies.
+For development, run `gem install --dev ./talon_one_sdk-26.11.0.gem` to install the development dependencies.
 
 ### RubyGems
 
@@ -557,6 +557,7 @@ Class | Method | HTTP request | Description
 - [TalonOne::CartItem](docs/CartItem.md)
 - [TalonOne::CartItemFilterTemplate](docs/CartItemFilterTemplate.md)
 - [TalonOne::Catalog](docs/Catalog.md)
+- [TalonOne::CatalogAction](docs/CatalogAction.md)
 - [TalonOne::CatalogActionFilter](docs/CatalogActionFilter.md)
 - [TalonOne::CatalogItem](docs/CatalogItem.md)
 - [TalonOne::CatalogRule](docs/CatalogRule.md)
@@ -636,6 +637,9 @@ Class | Method | HTTP request | Description
 - [TalonOne::EventType](docs/EventType.md)
 - [TalonOne::EventV2](docs/EventV2.md)
 - [TalonOne::EventV3](docs/EventV3.md)
+- [TalonOne::EventV3Connections](docs/EventV3Connections.md)
+- [TalonOne::EventV3Entity](docs/EventV3Entity.md)
+- [TalonOne::EventV3RequestEntity](docs/EventV3RequestEntity.md)
 - [TalonOne::Experiment](docs/Experiment.md)
 - [TalonOne::ExperimentCampaignCopy](docs/ExperimentCampaignCopy.md)
 - [TalonOne::ExperimentCopy](docs/ExperimentCopy.md)
@@ -760,6 +764,7 @@ Class | Method | HTTP request | Description
 - [TalonOne::IntegrationHubEventPayloadLoyaltyProfileBasedTierDowngradeNotification](docs/IntegrationHubEventPayloadLoyaltyProfileBasedTierDowngradeNotification.md)
 - [TalonOne::IntegrationHubEventPayloadLoyaltyProfileBasedTierUpgradeNotification](docs/IntegrationHubEventPayloadLoyaltyProfileBasedTierUpgradeNotification.md)
 - [TalonOne::IntegrationHubEventRecord](docs/IntegrationHubEventRecord.md)
+- [TalonOne::IntegrationHubEventStatusUpdate](docs/IntegrationHubEventStatusUpdate.md)
 - [TalonOne::IntegrationHubFlow](docs/IntegrationHubFlow.md)
 - [TalonOne::IntegrationHubFlowConfig](docs/IntegrationHubFlowConfig.md)
 - [TalonOne::IntegrationHubFlowConfigResponse](docs/IntegrationHubFlowConfigResponse.md)
@@ -874,6 +879,7 @@ Class | Method | HTTP request | Description
 - [TalonOne::NewCustomerSessionV2](docs/NewCustomerSessionV2.md)
 - [TalonOne::NewEvent](docs/NewEvent.md)
 - [TalonOne::NewEventType](docs/NewEventType.md)
+- [TalonOne::NewEventV3Entity](docs/NewEventV3Entity.md)
 - [TalonOne::NewExperiment](docs/NewExperiment.md)
 - [TalonOne::NewExperimentVariant](docs/NewExperimentVariant.md)
 - [TalonOne::NewExperimentVariantArray](docs/NewExperimentVariantArray.md)
@@ -969,6 +975,7 @@ Class | Method | HTTP request | Description
 - [TalonOne::RevisionActivationRequest](docs/RevisionActivationRequest.md)
 - [TalonOne::RevisionVersion](docs/RevisionVersion.md)
 - [TalonOne::Reward](docs/Reward.md)
+- [TalonOne::RewardPointsRequired](docs/RewardPointsRequired.md)
 - [TalonOne::RiskNotification](docs/RiskNotification.md)
 - [TalonOne::Role](docs/Role.md)
 - [TalonOne::RoleAssign](docs/RoleAssign.md)
@@ -1043,6 +1050,8 @@ Class | Method | HTTP request | Description
 - [TalonOne::StrikethroughTrigger](docs/StrikethroughTrigger.md)
 - [TalonOne::SummarizeCampaignStoreBudget200Response](docs/SummarizeCampaignStoreBudget200Response.md)
 - [TalonOne::SummaryCampaignStoreBudget](docs/SummaryCampaignStoreBudget.md)
+- [TalonOne::SupportRequest](docs/SupportRequest.md)
+- [TalonOne::SupportRequestInput](docs/SupportRequestInput.md)
 - [TalonOne::TalangAttribute](docs/TalangAttribute.md)
 - [TalonOne::TalangAttributeVisibility](docs/TalangAttributeVisibility.md)
 - [TalonOne::TemplateArgDef](docs/TemplateArgDef.md)
@@ -1100,6 +1109,7 @@ Class | Method | HTTP request | Description
 - [TalonOne::UpdateReward](docs/UpdateReward.md)
 - [TalonOne::UpdateRole](docs/UpdateRole.md)
 - [TalonOne::UpdateStore](docs/UpdateStore.md)
+- [TalonOne::UpdateSupportRequest](docs/UpdateSupportRequest.md)
 - [TalonOne::UpdateUser](docs/UpdateUser.md)
 - [TalonOne::User](docs/User.md)
 - [TalonOne::UserEntity](docs/UserEntity.md)

data/docs/AchievementBaseV2.md

@@ -14,9 +14,7 @@
 | **fixed_start_date** | **Time** | The achievement's start date when `activationPolicy` is set to `fixed_schedule`.  **Note:** It must be an RFC3339 timestamp string.  | [optional] |
 | **end_date** | **Time** | The achievement's end date. If defined, customers cannot participate in the achievement after this date.  **Note:** It must be an RFC3339 timestamp string.  | [optional] |
 | **allow_rollback_after_completion** | **Boolean** | When `true`, customer progress can be rolled back in completed achievements. | [optional] |
-| **sandbox** | **Boolean** | Indicates if this achievement is a live or sandbox achievement. Achievements of a given type can only be connected to Applications of the same type. | [optional] |
 | **subscribed_applications** | **Array<Integer>** | A list containing the IDs of all applications that are subscribed to A list containing the IDs of all Applications that are connected to this achievement. | [optional] |
-| **timezone** | **String** | A string containing an IANA timezone descriptor. | [optional] |
 
 ## Example
 
@@ -34,9 +32,7 @@ instance = TalonOne::AchievementBaseV2.new(
   fixed_start_date: 2024-01-15T15:04:05+07:00,
   end_date: 2024-01-15T15:04:05+07:00,
   allow_rollback_after_completion: false,
-  sandbox: true,
-  subscribed_applications: [132, 97],
-  timezone: Europe/Berlin
+  subscribed_applications: [132, 97]
 )
 ```
 

data/docs/AchievementV2.md

@@ -16,13 +16,13 @@
 | **fixed_start_date** | **Time** | The achievement's start date when `activationPolicy` is set to `fixed_schedule`.  **Note:** It must be an RFC3339 timestamp string.  | [optional] |
 | **end_date** | **Time** | The achievement's end date. If defined, customers cannot participate in the achievement after this date.  **Note:** It must be an RFC3339 timestamp string.  | [optional] |
 | **allow_rollback_after_completion** | **Boolean** | When `true`, customer progress can be rolled back in completed achievements. | [optional] |
-| **sandbox** | **Boolean** | Indicates if this achievement is a live or sandbox achievement. Achievements of a given type can only be connected to Applications of the same type. |  |
 | **subscribed_applications** | **Array<Integer>** | A list containing the IDs of all applications that are subscribed to A list containing the IDs of all Applications that are connected to this achievement. |  |
-| **timezone** | **String** | A string containing an IANA timezone descriptor. |  |
 | **user_id** | **Integer** | The ID of the user that created this achievement. |  |
 | **created_by** | **String** | Name of the user that created the achievement.  **Note**: This is not available if the user has been deleted.  | [optional] |
 | **has_progress** | **Boolean** | Indicates if a customer has made progress in the achievement. | [optional] |
 | **status** | **String** | The status of the achievement. | [optional] |
+| **sandbox** | **Boolean** | Indicates if this achievement is a live or sandbox achievement. Achievements of a given type can only be connected to Applications of the same type. |  |
+| **timezone** | **String** | A string containing an IANA timezone descriptor. |  |
 
 ## Example
 
@@ -42,13 +42,13 @@ instance = TalonOne::AchievementV2.new(
   fixed_start_date: 2024-01-15T15:04:05+07:00,
   end_date: 2024-01-15T15:04:05+07:00,
   allow_rollback_after_completion: false,
-  sandbox: true,
   subscribed_applications: [132, 97],
-  timezone: Europe/Berlin,
   user_id: 1234,
   created_by: John Doe,
   has_progress: null,
-  status: inprogress
+  status: inprogress,
+  sandbox: true,
+  timezone: Europe/Berlin
 )
 ```
 

data/docs/ApplicationEvent.md

@@ -10,8 +10,9 @@
 | **profile_id** | **Integer** | The globally unique Talon.One ID of the customer that created this entity. | [optional] |
 | **store_id** | **Integer** | The ID of the store. | [optional] |
 | **store_integration_id** | **String** | The integration ID of the store. You choose this ID when you create a store. | [optional] |
+| **integration_id** | **String** | The unique ID of the event. Only one event with this ID can be registered.  | [optional] |
 | **session_id** | **Integer** | The globally unique Talon.One ID of the session that contains this event. | [optional] |
-| **type** | **String** | A string representing the event. Must not be a reserved event name. |  |
+| **type** | **String** | The name of the event. Must be a [custom event](https://docs.talon.one/docs/dev/concepts/entities/events#custom-events), not a built-in event. |  |
 | **attributes** | **Object** | Additional JSON serialized data associated with the event. |  |
 | **effects** | [**Array<Effect>**](Effect.md) | An array containing the effects that were applied as a result of this event. |  |
 | **rule_failure_reasons** | [**Array<RuleFailureReason>**](RuleFailureReason.md) | An array containing the rule failure reasons which happened during this event. | [optional] |
@@ -28,6 +29,7 @@ instance = TalonOne::ApplicationEvent.new(
   profile_id: 138,
   store_id: null,
   store_integration_id: STORE-001,
+  integration_id: 175KJPS947296,
   session_id: null,
   type: null,
   attributes: null,

data/docs/BestPriorPrice.md

@@ -7,7 +7,8 @@
 | **id** | **Integer** | The ID of the historical price. |  |
 | **sku** | **String** | sku |  |
 | **observed_at** | **Time** | The date and time when the price was observed. |  |
-| **context_id** | **String** | The context ID of the context active at the time of observation.  |  |
+| **context_ids** | **Array<String>** | The identifiers of the relevant context at the time the price was observed. Includes the context IDs of any price adjustments and of the campaigns that influenced the final price.  |  |
+| **context_id** | **String** | This property is **deprecated**. Use `contextIds` instead. Defaults to an empty string.  | [optional][default to ''] |
 | **price** | **Float** | Price of the item. |  |
 | **metadata** | [**BestPriorPriceMetadata**](BestPriorPriceMetadata.md) |  |  |
 | **target** | **Object** |  |  |
@@ -20,8 +21,9 @@ require 'talon_one_sdk'
 instance = TalonOne::BestPriorPrice.new(
   id: 1,
   sku: NVR-GN-GV-UUP,
-  observed_at: 2020-11-10T23:00:00Z,
-  context_id: Summer Sale 2025,
+  observed_at: 2025-11-10T23:00:00Z,
+  context_ids: [SpringSale, SummerSale2025],
+  context_id: ,
   price: 99.99,
   metadata: null,
   target: null

data/docs/CatalogAction.md

@@ -0,0 +1,20 @@
+# TalonOne::CatalogAction
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **type** | **String** | The type of sync action. |  |
+| **payload** | **Object** |  |  |
+
+## Example
+
+```ruby
+require 'talon_one_sdk'
+
+instance = TalonOne::CatalogAction.new(
+  type: ADD,
+  payload: null
+)
+```
+

data/docs/CatalogSyncRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **actions** | **Array<Object>** |  |  |
+| **actions** | [**Array<CatalogAction>**](CatalogAction.md) |  |  |
 | **version** | **Integer** | The version number of the catalog to apply the actions on. | [optional] |
 
 ## Example

data/docs/CreateAchievementV2.md

@@ -14,8 +14,8 @@
 | **fixed_start_date** | **Time** | The achievement's start date when `activationPolicy` is set to `fixed_schedule`.  **Note:** It must be an RFC3339 timestamp string.  | [optional] |
 | **end_date** | **Time** | The achievement's end date. If defined, customers cannot participate in the achievement after this date.  **Note:** It must be an RFC3339 timestamp string.  | [optional] |
 | **allow_rollback_after_completion** | **Boolean** | When `true`, customer progress can be rolled back in completed achievements. | [optional] |
-| **sandbox** | **Boolean** | Indicates if this achievement is a live or sandbox achievement. Achievements of a given type can only be connected to Applications of the same type. |  |
 | **subscribed_applications** | **Array<Integer>** | A list containing the IDs of all applications that are subscribed to A list containing the IDs of all Applications that are connected to this achievement. | [optional] |
+| **sandbox** | **Boolean** | Indicates if this achievement is a live or sandbox achievement. Achievements of a given type can only be connected to Applications of the same type. |  |
 | **timezone** | **String** | A string containing an IANA timezone descriptor. |  |
 
 ## Example
@@ -34,8 +34,8 @@ instance = TalonOne::CreateAchievementV2.new(
   fixed_start_date: 2024-01-15T15:04:05+07:00,
   end_date: 2024-01-15T15:04:05+07:00,
   allow_rollback_after_completion: false,
-  sandbox: true,
   subscribed_applications: [132, 97],
+  sandbox: true,
   timezone: Europe/Berlin
 )
 ```

data/docs/CustomerSessionV2.md

@@ -25,6 +25,7 @@
 | **total** | **Float** | The total value of cart items and additional costs in the session, before any discounts are applied. |  |
 | **cart_item_total** | **Float** | The total value of cart items, before any discounts are applied. |  |
 | **additional_cost_total** | **Float** | The total value of additional costs, before any discounts are applied. |  |
+| **cart_item_additional_cost_total** | **Float** | The total value of additional costs applied to individual items, before any discounts are applied. | [readonly] |
 | **updated** | **Time** | Timestamp of the most recent event received on this session. |  |
 
 ## Example
@@ -51,9 +52,10 @@ instance = TalonOne::CustomerSessionV2.new(
   attributes: {ShippingCity=Berlin},
   first_session: true,
   update_count: 3,
-  total: 119.99,
+  total: 134.99,
   cart_item_total: 99.99,
   additional_cost_total: 20,
+  cart_item_additional_cost_total: 15,
   updated: 2020-02-08T14:15:22Z
 )
 ```

data/docs/Event.md

@@ -9,8 +9,9 @@
 | **application_id** | **Integer** | The ID of the Application that owns this entity. |  |
 | **profile_id** | **String** | ID of the customer profile set by your integration layer.  **Note:** If the customer does not yet have a known `profileId`, we recommend you use a guest `profileId`.  | [optional] |
 | **store_integration_id** | **String** | The integration ID of the store. You choose this ID when you create a store. | [optional] |
-| **type** | **String** | A string representing the event. Must not be a reserved event name. |  |
+| **type** | **String** | The name of the event. Must be a [custom event](https://docs.talon.one/docs/dev/concepts/entities/events#custom-events), not a built-in event. |  |
 | **attributes** | **Object** | Arbitrary additional JSON data associated with the event. |  |
+| **integration_id** | **String** | The unique ID of the event. Only one event with this ID can be registered.  | [optional] |
 | **session_id** | **String** | The ID of the session that this event occurred in. | [optional] |
 | **effects** | **Array<Object>** | An array of effects generated by the rules of the enabled campaigns of the Application.  You decide how to apply them in your system. See the list of [API effects](https://docs.talon.one/docs/dev/integration-api/api-effects).  |  |
 | **ledger_entries** | [**Array<LedgerEntry>**](LedgerEntry.md) | Ledger entries for the event. | [optional] |
@@ -29,6 +30,7 @@ instance = TalonOne::Event.new(
   store_integration_id: STORE-001,
   type: pageViewed,
   attributes: {myAttribute=myValue},
+  integration_id: 175KJPS947296,
   session_id: 175KJPS947296,
   effects: null,
   ledger_entries: null,

data/docs/EventAttributesEntity.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **type** | **String** | A string representing the event name. Must not be a reserved event name. You create this value when you [create an attribute](https://docs.talon.one/docs/dev/concepts/entities/events#creating-a-custom-event) of type `event` in the Campaign Manager.  |  |
+| **type** | **String** | The name of the event. Must be a [custom event](https://docs.talon.one/docs/dev/concepts/entities/events#custom-events), not a built-in event. |  |
 | **attributes** | **Object** | Arbitrary additional JSON properties associated with the event. They must be created in the Campaign Manager before setting them with this property. See [creating custom attributes](https://docs.talon.one/docs/product/account/dev-tools/managing-attributes#creating-a-custom-attribute). | [optional] |
 
 ## Example

data/docs/EventV2.md

@@ -7,7 +7,7 @@
 | **profile_id** | **String** | ID of the customer profile set by your integration layer.  **Note:** If the customer does not yet have a known `profileId`, we recommend you use a guest `profileId`.  | [optional] |
 | **store_integration_id** | **String** | The integration ID of the store. You choose this ID when you create a store. | [optional] |
 | **evaluable_campaign_ids** | **Array<Integer>** | When using the `dry` query parameter, use this property to list the campaign to be evaluated by the Rule Engine.  These campaigns will be evaluated, even if they are disabled, allowing you to test specific campaigns before activating them.  | [optional] |
-| **type** | **String** | A string representing the event name. Must not be a reserved event name. You create this value when you [create an attribute](https://docs.talon.one/docs/dev/concepts/entities/events#creating-a-custom-event) of type `event` in the Campaign Manager.  |  |
+| **type** | **String** | The name of the event. Must be a [custom event](https://docs.talon.one/docs/dev/concepts/entities/events#custom-events), not a built-in event. |  |
 | **attributes** | **Object** | Arbitrary additional JSON properties associated with the event. They must be created in the Campaign Manager before setting them with this property. See [creating custom attributes](https://docs.talon.one/docs/product/account/dev-tools/managing-attributes#creating-a-custom-attribute). | [optional] |
 
 ## Example

data/docs/EventV3.md

@@ -4,14 +4,16 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **profile_id** | **String** | ID of the customer profile set by your integration layer.  **Note:** If the customer does not yet have a known `profileId`, we recommend you use a guest `profileId`.  |  |
+| **connected_session_id** | **String** | The ID of the session to reference. The session must be in `closed` state. Otherwise, the API call will fail. | [optional] |
+| **id** | **Integer** | The internal ID of this entity. |  |
+| **created** | **Time** | The time this entity was created. |  |
+| **application_id** | **Integer** | The ID of the Application that owns this entity. |  |
+| **profile_id** | **String** | ID of the customer profile set by your integration layer.  **Note:** If the customer does not yet have a known `profileId`, we recommend you use a guest `profileId`.  | [optional] |
 | **store_integration_id** | **String** | The integration ID of the store. You choose this ID when you create a store. | [optional] |
-| **evaluable_campaign_ids** | **Array<Integer>** | When using the `dry` query parameter, use this property to list the campaign to be evaluated by the Rule Engine.  These campaigns will be evaluated, even if they are disabled, allowing you to test specific campaigns before activating them.  | [optional] |
-| **integration_id** | **String** | The unique ID of the current event. Only one event with this ID could be activated, duplicated events are forbidden.  |  |
-| **type** | **String** | A string representing the event name. Must not be a reserved event name. You create this value when you [create an attribute](https://docs.talon.one/docs/dev/concepts/entities/events#creating-a-custom-event) of type `event` in the Campaign Manager.  |  |
-| **attributes** | **Object** | Arbitrary additional JSON properties associated with the event. They must be created in the Campaign Manager before setting them with this property. See [creating custom attributes](https://docs.talon.one/docs/product/account/dev-tools/managing-attributes#creating-a-custom-attribute). | [optional] |
-| **connected_session_id** | **String** | The ID of the session that happened in the past. | [optional] |
-| **previous_event_id** | **String** | The unique identifier of the event that happened in the past. | [optional] |
+| **type** | **String** | The name of the event. Must be a [custom event](https://docs.talon.one/docs/dev/concepts/entities/events#custom-events), not a built-in event. |  |
+| **attributes** | **Object** | Arbitrary additional JSON data associated with the event. |  |
+| **integration_id** | **String** | The unique ID of the event. Only one event with this ID can be registered.  | [optional] |
+| **effects** | **Array<Object>** | An array of effects generated by the rules of the enabled campaigns of the Application.  You decide how to apply them in your system. See the list of [API effects](https://docs.talon.one/docs/dev/integration-api/api-effects).  |  |
 
 ## Example
 
@@ -19,14 +21,16 @@
 require 'talon_one_sdk'
 
 instance = TalonOne::EventV3.new(
+  connected_session_id: 175KJPS947296,
+  id: 6,
+  created: 2020-06-10T09:05:27.993483Z,
+  application_id: 322,
   profile_id: URNGV8294NV,
   store_integration_id: STORE-001,
-  evaluable_campaign_ids: [10, 12],
-  integration_id: 175KJPS947296,
   type: pageViewed,
   attributes: {myAttribute=myValue},
-  connected_session_id: 175KJPS947296,
-  previous_event_id: 175KJPS947296
+  integration_id: 175KJPS947296,
+  effects: null
 )
 ```
 

data/docs/EventV3Connections.md

@@ -0,0 +1,18 @@
+# TalonOne::EventV3Connections
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **connected_session_id** | **String** | The ID of the session to reference. The session must be in `closed` state. Otherwise, the API call will fail. | [optional] |
+
+## Example
+
+```ruby
+require 'talon_one_sdk'
+
+instance = TalonOne::EventV3Connections.new(
+  connected_session_id: 175KJPS947296
+)
+```
+

data/docs/EventV3Entity.md

@@ -0,0 +1,18 @@
+# TalonOne::EventV3Entity
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **integration_id** | **String** | The unique ID of the event. Only one event with this ID can be registered.  | [optional] |
+
+## Example
+
+```ruby
+require 'talon_one_sdk'
+
+instance = TalonOne::EventV3Entity.new(
+  integration_id: 175KJPS947296
+)
+```
+

data/docs/EventV3RequestEntity.md

@@ -0,0 +1,30 @@
+# TalonOne::EventV3RequestEntity
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **profile_id** | **String** | ID of the customer profile set by your integration layer.  **Note:** If the customer does not yet have a known `profileId`, we recommend you use a guest `profileId`.  |  |
+| **store_integration_id** | **String** | The integration ID of the store. You choose this ID when you create a store. | [optional] |
+| **evaluable_campaign_ids** | **Array<Integer>** | When using the `dry` query parameter, use this property to list the campaign to be evaluated by the Rule Engine.  These campaigns will be evaluated, even if they are disabled, allowing you to test specific campaigns before activating them.  | [optional] |
+| **type** | **String** | The name of the event. Must be a [custom event](https://docs.talon.one/docs/dev/concepts/entities/events#custom-events), not a built-in event. |  |
+| **attributes** | **Object** | Arbitrary additional JSON properties associated with the event. They must be created in the Campaign Manager before setting them with this property. See [creating custom attributes](https://docs.talon.one/docs/product/account/dev-tools/managing-attributes#creating-a-custom-attribute). | [optional] |
+| **integration_id** | **String** | The unique ID of the event. Only one event with this ID can be registered.  |  |
+| **connected_session_id** | **String** | The ID of the session to reference. The session must be in `closed` state. Otherwise, the API call will fail. | [optional] |
+
+## Example
+
+```ruby
+require 'talon_one_sdk'
+
+instance = TalonOne::EventV3RequestEntity.new(
+  profile_id: URNGV8294NV,
+  store_integration_id: STORE-001,
+  evaluable_campaign_ids: [10, 12],
+  type: pageViewed,
+  attributes: {myAttribute=myValue},
+  integration_id: 175KJPS947296,
+  connected_session_id: 175KJPS947296
+)
+```
+

data/docs/ExperimentCopyExperiment.md

@@ -6,6 +6,8 @@
 | ---- | ---- | ----------- | ----- |
 | **is_variant_assignment_external** | **Boolean** | The source of the assignment. - false - The variant assignment is handled internally by Talon.One. - true - The variant assignment is handled externally.  |  |
 | **campaign** | [**ExperimentCampaignCopy**](ExperimentCampaignCopy.md) |  |  |
+| **goal_type** | **String** | The goal of the experiment. Determines which single metric is used to decide the winning variant. When set to `other`, multiple metrics are used. If omitted, the value from the source experiment is used.  | [optional] |
+| **goal_description** | **String** | A description of the experiment goal. Provides context for the AI summary and helps it interpret the outcome of the experiment against the stated goal. If omitted, the value from the source experiment is used.  | [optional] |
 
 ## Example
 
@@ -14,7 +16,9 @@ require 'talon_one_sdk'
 
 instance = TalonOne::ExperimentCopyExperiment.new(
   is_variant_assignment_external: null,
-  campaign: null
+  campaign: null,
+  goal_type: null,
+  goal_description: null
 )
 ```
 

data/docs/History.md

@@ -6,7 +6,8 @@
 | ---- | ---- | ----------- | ----- |
 | **id** | **Integer** | The ID of the historical price. |  |
 | **observed_at** | **Time** | The date and time when the price was observed. |  |
-| **context_id** | **String** | Identifier of the relevant context at the time the price was observed (e.g. summer sale).  |  |
+| **context_ids** | **Array<String>** | The identifiers of the relevant context at the time the price was observed. Includes the context IDs of any price adjustments and of the campaigns that influenced the final price.  |  |
+| **context_id** | **String** | This property is **deprecated**. Use `contextIds` instead. Defaults to an empty string.  | [optional][default to ''] |
 | **price** | **Float** | Price of the item. |  |
 | **metadata** | [**BestPriorPriceMetadata**](BestPriorPriceMetadata.md) |  |  |
 | **target** | **Object** |  |  |
@@ -18,8 +19,9 @@ require 'talon_one_sdk'
 
 instance = TalonOne::History.new(
   id: 1,
-  observed_at: 2020-11-10T23:00:00Z,
-  context_id: Summer Sale 2025,
+  observed_at: 2025-11-10T23:00:00Z,
+  context_ids: [SpringSale, SummerSale2025],
+  context_id: ,
   price: 99.99,
   metadata: null,
   target: null

data/docs/IntegrationApi.md

@@ -2161,7 +2161,7 @@ end
 
 api_instance = TalonOne::IntegrationApi.new
 catalog_id = 789 # Integer | The ID of the catalog. You can find the ID in the Campaign Manager in **Account** > **Tools** > **Cart item catalogs**.
-catalog_sync_request = TalonOne::CatalogSyncRequest.new({actions: [3.56]}) # CatalogSyncRequest | body
+catalog_sync_request = TalonOne::CatalogSyncRequest.new({actions: [TalonOne::CatalogAction.new({type: 'ADD', payload: 3.56})]}) # CatalogSyncRequest | body
 
 begin
   # Sync cart item catalog
@@ -2217,7 +2217,7 @@ end
 
 Track event
 
-Triggers a custom event.  To use this endpoint:  1. Define a [custom event](https://docs.talon.one/docs/dev/concepts/entities/events#creating-a-custom-event) in the Campaign Manager. 1. Update or create a rule to check for this event. 1. Trigger the event with this endpoint. After you have successfully sent an event to Talon.One, you can list the received events in the **Events** view in the Campaign Manager.  Talon.One also offers a set of [built-in events](https://docs.talon.one/docs/dev/concepts/entities/events). Ensure you do not create a custom event when you can use a built-in event.  For example, use this endpoint to trigger an event when a customer shares a link to a product.  See the [tutorial](https://docs.talon.one/docs/product/tutorials/referrals/incentivizing-product-link-sharing).  > [!note] **Note** > - `profileId` is required even though the schema does not specify it. > - If the customer profile ID is new, a new profile is automatically created but the `customer_profile_created` [built-in event ](https://docs.talon.one/docs/dev/concepts/entities/events) is **not** triggered. > - We recommend sending requests sequentially. See [Managing parallel requests](https://docs.talon.one/docs/dev/getting-started/integration-tutorial#managing-parallel-requests). > - [Archived campaigns](https://docs.talon.one/docs/product/campaigns/managing-campaigns#archiving-a-campaign) are not considered in rule evaluation. 
+Triggers a custom event.  To use this endpoint:  1. [Create a custom event](https://docs.talon.one/docs/dev/concepts/entities/events#creating-a-custom-event) in the Campaign Manager. 1. In a rule, add the **Check for event types** [condition](https://docs.talon.one/docs/dev/concepts/entities/events#use-an-event-in-a-rule) and select the event you created. 1. Trigger the event with this endpoint.  You can [list](https://docs.talon.one/docs/product/applications/display-events#list-events) the received events in the **Events** view of the Campaign Manager.  For example, you can use this endpoint to trigger an event when a customer shares a link to a product. See our [tutorial](https://docs.talon.one/docs/product/tutorials/referrals/incentivizing-product-link-sharing).  > [!note] **Note** > - `profileId` is required even though the schema does not specify it. > - If the customer profile ID is new, a new profile is automatically created but the `customer_profile_created` [built-in event ](https://docs.talon.one/docs/dev/concepts/entities/events) is **not** triggered. > - We recommend sending requests sequentially. See [Managing parallel requests](https://docs.talon.one/docs/dev/getting-started/integration-tutorial#managing-parallel-requests). > - [Archived campaigns](https://docs.talon.one/docs/product/campaigns/managing-campaigns#archiving-a-campaign) are not considered in rule evaluation. 
 
 ### Examples
 

data/docs/IntegrationEvent.md

@@ -6,7 +6,7 @@
 | ---- | ---- | ----------- | ----- |
 | **profile_id** | **String** | ID of the customer profile set by your integration layer.  **Note:** If the customer does not yet have a known `profileId`, we recommend you use a guest `profileId`.  | [optional] |
 | **store_integration_id** | **String** | The integration ID of the store. You choose this ID when you create a store. | [optional] |
-| **type** | **String** | A string representing the event. Must not be a reserved event name. |  |
+| **type** | **String** | The name of the event. Must be a [custom event](https://docs.talon.one/docs/dev/concepts/entities/events#custom-events), not a built-in event. |  |
 | **attributes** | **Object** | Arbitrary additional JSON data associated with the event. |  |
 
 ## Example

data/docs/IntegrationEventV2Request.md

@@ -7,7 +7,7 @@
 | **profile_id** | **String** | ID of the customer profile set by your integration layer.  **Note:** If the customer does not yet have a known `profileId`, we recommend you use a guest `profileId`.  | [optional] |
 | **store_integration_id** | **String** | The integration ID of the store. You choose this ID when you create a store. | [optional] |
 | **evaluable_campaign_ids** | **Array<Integer>** | When using the `dry` query parameter, use this property to list the campaign to be evaluated by the Rule Engine.  These campaigns will be evaluated, even if they are disabled, allowing you to test specific campaigns before activating them.  | [optional] |
-| **type** | **String** | A string representing the event name. Must not be a reserved event name. You create this value when you [create an attribute](https://docs.talon.one/docs/dev/concepts/entities/events#creating-a-custom-event) of type `event` in the Campaign Manager.  |  |
+| **type** | **String** | The name of the event. Must be a [custom event](https://docs.talon.one/docs/dev/concepts/entities/events#custom-events), not a built-in event. |  |
 | **attributes** | **Object** | Arbitrary additional JSON properties associated with the event. They must be created in the Campaign Manager before setting them with this property. See [creating custom attributes](https://docs.talon.one/docs/product/account/dev-tools/managing-attributes#creating-a-custom-attribute). | [optional] |
 | **response_content** | **Array<String>** | Extends the response with the chosen data entities. Use this property to get as much data back as needed from one request instead of sending extra requests to other endpoints.  | [optional] |
 | **loyalty_cards** | **Array<String>** | Identifiers of the loyalty cards used during this event. | [optional] |

data/docs/IntegrationEventV3Request.md

@@ -7,11 +7,10 @@
 | **profile_id** | **String** | ID of the customer profile set by your integration layer.  **Note:** If the customer does not yet have a known `profileId`, we recommend you use a guest `profileId`.  |  |
 | **store_integration_id** | **String** | The integration ID of the store. You choose this ID when you create a store. | [optional] |
 | **evaluable_campaign_ids** | **Array<Integer>** | When using the `dry` query parameter, use this property to list the campaign to be evaluated by the Rule Engine.  These campaigns will be evaluated, even if they are disabled, allowing you to test specific campaigns before activating them.  | [optional] |
-| **integration_id** | **String** | The unique ID of the current event. Only one event with this ID could be activated, duplicated events are forbidden.  |  |
-| **type** | **String** | A string representing the event name. Must not be a reserved event name. You create this value when you [create an attribute](https://docs.talon.one/docs/dev/concepts/entities/events#creating-a-custom-event) of type `event` in the Campaign Manager.  |  |
+| **type** | **String** | The name of the event. Must be a [custom event](https://docs.talon.one/docs/dev/concepts/entities/events#custom-events), not a built-in event. |  |
 | **attributes** | **Object** | Arbitrary additional JSON properties associated with the event. They must be created in the Campaign Manager before setting them with this property. See [creating custom attributes](https://docs.talon.one/docs/product/account/dev-tools/managing-attributes#creating-a-custom-attribute). | [optional] |
-| **connected_session_id** | **String** | The ID of the session that happened in the past. | [optional] |
-| **previous_event_id** | **String** | The unique identifier of the event that happened in the past. | [optional] |
+| **integration_id** | **String** | The unique ID of the event. Only one event with this ID can be registered.  |  |
+| **connected_session_id** | **String** | The ID of the session to reference. The session must be in `closed` state. Otherwise, the API call will fail. | [optional] |
 | **loyalty_cards** | **Array<String>** | Identifiers of the loyalty cards used during this event. | [optional] |
 | **response_content** | **Array<String>** | Optional list of requested information to be present on the response related to the tracking custom event.  | [optional] |
 
@@ -24,11 +23,10 @@ instance = TalonOne::IntegrationEventV3Request.new(
   profile_id: URNGV8294NV,
   store_integration_id: STORE-001,
   evaluable_campaign_ids: [10, 12],
-  integration_id: 175KJPS947296,
   type: pageViewed,
   attributes: {myAttribute=myValue},
+  integration_id: 175KJPS947296,
   connected_session_id: 175KJPS947296,
-  previous_event_id: 175KJPS947296,
   loyalty_cards: [loyalty-card-1],
   response_content: [triggeredCampaigns, customerProfile]
 )

data/docs/IntegrationHubEventPayloadLoyaltyProfileBasedNotification.md

@@ -6,14 +6,15 @@
 | ---- | ---- | ----------- | ----- |
 | **profile_integration_id** | **String** |  |  |
 | **loyalty_program_id** | **Integer** |  |  |
+| **loyalty_program_name** | **String** | The name of the loyalty program. |  |
 | **subledger_id** | **String** |  |  |
 | **source_of_event** | **String** |  |  |
+| **current_tier** | **String** | The name of the customer's current tier. |  |
 | **employee_name** | **String** |  | [optional] |
 | **user_id** | **Integer** |  | [optional] |
 | **current_points** | **Float** |  |  |
 | **actions** | [**Array<IntegrationHubEventPayloadLoyaltyProfileBasedPointsChangedNotificationAction>**](IntegrationHubEventPayloadLoyaltyProfileBasedPointsChangedNotificationAction.md) |  | [optional] |
 | **published_at** | **Time** | Timestamp when the event was published. |  |
-| **current_tier** | **String** |  | [optional] |
 | **old_tier** | **String** |  | [optional] |
 | **tier_expiration_date** | **Time** |  | [optional] |
 | **timestamp_of_tier_change** | **Time** |  | [optional] |
@@ -28,14 +29,15 @@ require 'talon_one_sdk'
 instance = TalonOne::IntegrationHubEventPayloadLoyaltyProfileBasedNotification.new(
   profile_integration_id: null,
   loyalty_program_id: null,
+  loyalty_program_name: null,
   subledger_id: null,
   source_of_event: null,
+  current_tier: null,
   employee_name: null,
   user_id: null,
   current_points: null,
   actions: null,
   published_at: null,
-  current_tier: null,
   old_tier: null,
   tier_expiration_date: null,
   timestamp_of_tier_change: null,

data/docs/IntegrationHubEventPayloadLoyaltyProfileBasedPointsChangedNotification.md

@@ -6,8 +6,10 @@
 | ---- | ---- | ----------- | ----- |
 | **profile_integration_id** | **String** |  |  |
 | **loyalty_program_id** | **Integer** |  |  |
+| **loyalty_program_name** | **String** | The name of the loyalty program. |  |
 | **subledger_id** | **String** |  |  |
 | **source_of_event** | **String** |  |  |
+| **current_tier** | **String** | The name of the customer's current tier. |  |
 | **employee_name** | **String** |  | [optional] |
 | **user_id** | **Integer** |  | [optional] |
 | **current_points** | **Float** |  |  |
@@ -22,8 +24,10 @@ require 'talon_one_sdk'
 instance = TalonOne::IntegrationHubEventPayloadLoyaltyProfileBasedPointsChangedNotification.new(
   profile_integration_id: null,
   loyalty_program_id: null,
+  loyalty_program_name: null,
   subledger_id: null,
   source_of_event: null,
+  current_tier: null,
   employee_name: null,
   user_id: null,
   current_points: null,

data/docs/IntegrationHubEventPayloadLoyaltyProfileBasedTierDowngradeNotification.md

@@ -6,9 +6,10 @@
 | ---- | ---- | ----------- | ----- |
 | **profile_integration_id** | **String** |  |  |
 | **loyalty_program_id** | **Integer** |  |  |
+| **loyalty_program_name** | **String** | The name of the loyalty program. |  |
 | **subledger_id** | **String** |  |  |
 | **source_of_event** | **String** |  |  |
-| **current_tier** | **String** |  | [optional] |
+| **current_tier** | **String** | The name of the customer's current tier, or null if the customer was downgraded below all tiers. | [optional] |
 | **current_points** | **Float** |  |  |
 | **old_tier** | **String** |  | [optional] |
 | **tier_expiration_date** | **Time** |  | [optional] |
@@ -23,6 +24,7 @@ require 'talon_one_sdk'
 instance = TalonOne::IntegrationHubEventPayloadLoyaltyProfileBasedTierDowngradeNotification.new(
   profile_integration_id: null,
   loyalty_program_id: null,
+  loyalty_program_name: null,
   subledger_id: null,
   source_of_event: null,
   current_tier: null,