trophy_api_client 1.0.30 → 1.0.32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c25a821fcf1f05012a279bf8ad031328a32bf4e485600e4b6f1db1484de8daa8
-  data.tar.gz: b2b975f8d431ec31f8ddec8bb2f73803dee6a45ebcbb4b92103ea904b7f5ae6b
+  metadata.gz: 2e8eb5e832f3fed9bedb450cff8e7b9871c1a0abc5c05acfc83afd154a92c9a3
+  data.tar.gz: 9b7e52702a6d4b009e995c06b5e6cf46bd663c9dc03380047827cf765cc49f6c
 SHA512:
-  metadata.gz: 33c5da328d9511d8a1f0231d1697ebf671b9463b426fcf575a9be4037f5963f5a23347e358e38ef12a05fbc9da9a6c27f2ad36b134a07d07887605ae8d44c86a
-  data.tar.gz: 01dbb928522b7d992d4788e3112f058455a143f870215824a2c1336cb165ace1bb5a5469ec4cbfade09c31cc49987931119156b05efb1ad2c9ebeb8b97339a0a
+  metadata.gz: a0bd2b1d3ee672308e7bcdca87092c30ec5173b1ef0c31219968aa9c20e53a93857cb76b0d1da3a9fe9ce05fb58c0bbc3304df5f4e263a59aad85aaf7e167ccd
+  data.tar.gz: 42d1f56df6f7c37ba0d06a85a211b434b5215f14c8bbf869f6d2dc21644bd3e21abed4e986b343d2a4a35ef7ebec5ceaa732168f74c8d1f660bc8a340e2b517f

data/lib/gemconfig.rb

@@ -2,7 +2,7 @@
 
 module TrophyApiClient
   module Gemconfig
-    VERSION = "1.0.30"
+    VERSION = "1.0.32"
     AUTHORS = ["Trophy Labs, Inc"].freeze
     EMAIL = ""
     SUMMARY = "Ruby library for the Trophy API."

data/lib/trophy_api_client/achievements/client.rb

@@ -20,6 +20,9 @@ module TrophyApiClient
 
     # Get all achievements and their completion stats.
     #
+    # @param user_attributes [String] Optional colon-delimited user attributes in the format
+    #  attribute:value,attribute:value. Only achievements accessible to a user with the
+    #  provided attributes will be returned.
     # @param request_options [TrophyApiClient::RequestOptions]
     # @return [Array<TrophyApiClient::AchievementWithStatsResponse>]
     # @example
@@ -28,8 +31,8 @@ module TrophyApiClient
     #    environment: TrophyApiClient::Environment::PRODUCTION,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.achievements.all
-    def all(request_options: nil)
+    #  api.achievements.all(user_attributes: "plan-type:premium,region:us-east")
+    def all(user_attributes: nil, request_options: nil)
       response = @request_client.conn.get do |req|
         req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
         req.headers["X-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
@@ -38,9 +41,10 @@ module TrophyApiClient
       **@request_client.get_headers,
       **(request_options&.additional_headers || {})
         }.compact
-        unless request_options.nil? || request_options&.additional_query_parameters.nil?
-          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
-        end
+        req.params = {
+          **(request_options&.additional_query_parameters || {}),
+          "userAttributes": user_attributes
+        }.compact
         unless request_options.nil? || request_options&.additional_body_parameters.nil?
           req.body = { **(request_options&.additional_body_parameters || {}) }.compact
         end
@@ -72,7 +76,7 @@ module TrophyApiClient
     #    environment: TrophyApiClient::Environment::PRODUCTION,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.achievements.complete(key: "finish-onboarding", user: { email: "user@example.com", name: "User", tz: "Europe/London", device_tokens: ["token1", "token2"], subscribe_to_emails: true, attributes: { "department": "engineering", "role": "developer" }, id: "user-id" })
+    #  api.achievements.complete(key: "finish-onboarding", user: { email: "user@example.com", tz: "Europe/London", id: "user-id" })
     def complete(key:, user:, request_options: nil)
       response = @request_client.conn.post do |req|
         req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -105,6 +109,9 @@ module TrophyApiClient
 
     # Get all achievements and their completion stats.
     #
+    # @param user_attributes [String] Optional colon-delimited user attributes in the format
+    #  attribute:value,attribute:value. Only achievements accessible to a user with the
+    #  provided attributes will be returned.
     # @param request_options [TrophyApiClient::RequestOptions]
     # @return [Array<TrophyApiClient::AchievementWithStatsResponse>]
     # @example
@@ -113,8 +120,8 @@ module TrophyApiClient
     #    environment: TrophyApiClient::Environment::PRODUCTION,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.achievements.all
-    def all(request_options: nil)
+    #  api.achievements.all(user_attributes: "plan-type:premium,region:us-east")
+    def all(user_attributes: nil, request_options: nil)
       Async do
         response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -124,9 +131,10 @@ module TrophyApiClient
         **@request_client.get_headers,
         **(request_options&.additional_headers || {})
           }.compact
-          unless request_options.nil? || request_options&.additional_query_parameters.nil?
-            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
-          end
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "userAttributes": user_attributes
+          }.compact
           unless request_options.nil? || request_options&.additional_body_parameters.nil?
             req.body = { **(request_options&.additional_body_parameters || {}) }.compact
           end
@@ -159,7 +167,7 @@ module TrophyApiClient
     #    environment: TrophyApiClient::Environment::PRODUCTION,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.achievements.complete(key: "finish-onboarding", user: { email: "user@example.com", name: "User", tz: "Europe/London", device_tokens: ["token1", "token2"], subscribe_to_emails: true, attributes: { "department": "engineering", "role": "developer" }, id: "user-id" })
+    #  api.achievements.complete(key: "finish-onboarding", user: { email: "user@example.com", tz: "Europe/London", id: "user-id" })
     def complete(key:, user:, request_options: nil)
       Async do
         response = @request_client.conn.post do |req|

data/lib/trophy_api_client/leaderboards/client.rb

@@ -56,11 +56,15 @@ module TrophyApiClient
     #
     # @param key [String] Unique key of the leaderboard as set when created.
     # @param offset [Integer] Number of rankings to skip for pagination.
-    # @param limit [Integer] Maximum number of rankings to return.
+    # @param limit [Integer] Maximum number of rankings to return. Cannot be greater than the size of the
+    #  leaderboard.
     # @param run [String] Specific run date in YYYY-MM-DD format. If not provided, returns the current
     #  run.
     # @param user_id [String] When provided, offset is relative to this user's position on the leaderboard. If
     #  the user is not found in the leaderboard, returns empty rankings array.
+    # @param user_attributes [String] Attribute key and value to filter the rankings by, separated by a colon. For
+    #  example, `city:London`. This parameter is required, and only valid for
+    #  leaderboards with a breakdown attribute.
     # @param request_options [TrophyApiClient::RequestOptions]
     # @return [TrophyApiClient::LeaderboardResponseWithRankings]
     # @example
@@ -74,9 +78,10 @@ module TrophyApiClient
     #    offset: 1,
     #    limit: 1,
     #    run: "2025-01-15",
-    #    user_id: "user-123"
+    #    user_id: "user-123",
+    #    user_attributes: "city:London"
     #  )
-    def get(key:, offset: nil, limit: nil, run: nil, user_id: nil, request_options: nil)
+    def get(key:, offset: nil, limit: nil, run: nil, user_id: nil, user_attributes: nil, request_options: nil)
       response = @request_client.conn.get do |req|
         req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
         req.headers["X-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
@@ -90,7 +95,8 @@ module TrophyApiClient
           "offset": offset,
           "limit": limit,
           "run": run,
-          "userId": user_id
+          "userId": user_id,
+          "userAttributes": user_attributes
         }.compact
         unless request_options.nil? || request_options&.additional_body_parameters.nil?
           req.body = { **(request_options&.additional_body_parameters || {}) }.compact
@@ -152,11 +158,15 @@ module TrophyApiClient
     #
     # @param key [String] Unique key of the leaderboard as set when created.
     # @param offset [Integer] Number of rankings to skip for pagination.
-    # @param limit [Integer] Maximum number of rankings to return.
+    # @param limit [Integer] Maximum number of rankings to return. Cannot be greater than the size of the
+    #  leaderboard.
     # @param run [String] Specific run date in YYYY-MM-DD format. If not provided, returns the current
     #  run.
     # @param user_id [String] When provided, offset is relative to this user's position on the leaderboard. If
     #  the user is not found in the leaderboard, returns empty rankings array.
+    # @param user_attributes [String] Attribute key and value to filter the rankings by, separated by a colon. For
+    #  example, `city:London`. This parameter is required, and only valid for
+    #  leaderboards with a breakdown attribute.
     # @param request_options [TrophyApiClient::RequestOptions]
     # @return [TrophyApiClient::LeaderboardResponseWithRankings]
     # @example
@@ -170,9 +180,10 @@ module TrophyApiClient
     #    offset: 1,
     #    limit: 1,
     #    run: "2025-01-15",
-    #    user_id: "user-123"
+    #    user_id: "user-123",
+    #    user_attributes: "city:London"
     #  )
-    def get(key:, offset: nil, limit: nil, run: nil, user_id: nil, request_options: nil)
+    def get(key:, offset: nil, limit: nil, run: nil, user_id: nil, user_attributes: nil, request_options: nil)
       Async do
         response = @request_client.conn.get do |req|
           req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -187,7 +198,8 @@ module TrophyApiClient
             "offset": offset,
             "limit": limit,
             "run": run,
-            "userId": user_id
+            "userId": user_id,
+            "userAttributes": user_attributes
           }.compact
           unless request_options.nil? || request_options&.additional_body_parameters.nil?
             req.body = { **(request_options&.additional_body_parameters || {}) }.compact

data/lib/trophy_api_client/leaderboards/types/leaderboards_all_response_item.rb

@@ -19,6 +19,8 @@ module TrophyApiClient
       attr_reader :key
       # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
       attr_reader :rank_by
+      # @return [String] The key of the attribute to break down this leaderboard by.
+      attr_reader :breakdown_attribute
       # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
       attr_reader :metric_key
       # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -55,6 +57,7 @@ module TrophyApiClient
       # @param name [String] The user-facing name of the leaderboard.
       # @param key [String] The unique key used to reference the leaderboard in APIs.
       # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+      # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
       # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
       # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
       # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -70,13 +73,14 @@ module TrophyApiClient
       #  type.
       # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
       # @return [TrophyApiClient::Leaderboards::LeaderboardsAllResponseItem]
-      def initialize(status:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT,
-                     points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
+      def initialize(status:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, breakdown_attribute: OMIT, metric_key: OMIT,
+                     metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
         @status = status
         @id = id
         @name = name
         @key = key
         @rank_by = rank_by
+        @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
         @metric_key = metric_key if metric_key != OMIT
         @metric_name = metric_name if metric_name != OMIT
         @points_system_key = points_system_key if points_system_key != OMIT
@@ -94,6 +98,7 @@ module TrophyApiClient
           "name": name,
           "key": key,
           "rankBy": rank_by,
+          "breakdownAttribute": breakdown_attribute,
           "metricKey": metric_key,
           "metricName": metric_name,
           "pointsSystemKey": points_system_key,
@@ -121,6 +126,7 @@ module TrophyApiClient
         name = parsed_json["name"]
         key = parsed_json["key"]
         rank_by = parsed_json["rankBy"]
+        breakdown_attribute = parsed_json["breakdownAttribute"]
         metric_key = parsed_json["metricKey"]
         metric_name = parsed_json["metricName"]
         points_system_key = parsed_json["pointsSystemKey"]
@@ -137,6 +143,7 @@ module TrophyApiClient
           name: name,
           key: key,
           rank_by: rank_by,
+          breakdown_attribute: breakdown_attribute,
           metric_key: metric_key,
           metric_name: metric_name,
           points_system_key: points_system_key,
@@ -170,6 +177,7 @@ module TrophyApiClient
         obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
         obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
         obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+        obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
         obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
         obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
         obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/metrics/client.rb

@@ -42,7 +42,7 @@ module TrophyApiClient
     #  api.metrics.event(
     #    idempotency_key: "e4296e4b-8493-4bd1-9c30-5a1a9ac4d78f",
     #    key: "words-written",
-    #    user: { email: "user@example.com", name: "User", tz: "Europe/London", device_tokens: ["token1", "token2"], subscribe_to_emails: true, attributes: { "department": "engineering", "role": "developer" }, id: "18" },
+    #    user: { email: "user@example.com", tz: "Europe/London", attributes: { "department": "engineering", "role": "developer" }, id: "18" },
     #    value: 750,
     #    attributes: { "category": "writing", "source": "mobile-app" }
     #  )
@@ -107,7 +107,7 @@ module TrophyApiClient
     #  api.metrics.event(
     #    idempotency_key: "e4296e4b-8493-4bd1-9c30-5a1a9ac4d78f",
     #    key: "words-written",
-    #    user: { email: "user@example.com", name: "User", tz: "Europe/London", device_tokens: ["token1", "token2"], subscribe_to_emails: true, attributes: { "department": "engineering", "role": "developer" }, id: "18" },
+    #    user: { email: "user@example.com", tz: "Europe/London", attributes: { "department": "engineering", "role": "developer" }, id: "18" },
     #    value: 750,
     #    attributes: { "category": "writing", "source": "mobile-app" }
     #  )

data/lib/trophy_api_client/points/client.rb

@@ -21,8 +21,8 @@ module TrophyApiClient
     #
     # @param key [String] Key of the points system.
     # @param user_attributes [String] Optional colon-delimited user attribute filters in the format
-    #  attributeKey:value,attributeKey:value. Only users matching ALL specified
-    #  attributes will be included in the points breakdown.
+    #  attribute:value,attribute:value. Only users matching ALL specified attributes
+    #  will be included in the points breakdown.
     # @param request_options [TrophyApiClient::RequestOptions]
     # @return [TrophyApiClient::POINTS_SUMMARY_RESPONSE]
     # @example
@@ -104,8 +104,8 @@ module TrophyApiClient
     #
     # @param key [String] Key of the points system.
     # @param user_attributes [String] Optional colon-delimited user attribute filters in the format
-    #  attributeKey:value,attributeKey:value. Only users matching ALL specified
-    #  attributes will be included in the points breakdown.
+    #  attribute:value,attribute:value. Only users matching ALL specified attributes
+    #  will be included in the points breakdown.
     # @param request_options [TrophyApiClient::RequestOptions]
     # @return [TrophyApiClient::POINTS_SUMMARY_RESPONSE]
     # @example

data/lib/trophy_api_client/types/leaderboard_response.rb

@@ -16,6 +16,8 @@ module TrophyApiClient
     attr_reader :key
     # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
     attr_reader :rank_by
+    # @return [String] The key of the attribute to break down this leaderboard by.
+    attr_reader :breakdown_attribute
     # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
     attr_reader :metric_key
     # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -51,6 +53,7 @@ module TrophyApiClient
     # @param name [String] The user-facing name of the leaderboard.
     # @param key [String] The unique key used to reference the leaderboard in APIs.
     # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+    # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
     # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
     # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
     # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -66,12 +69,13 @@ module TrophyApiClient
     #  type.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::LeaderboardResponse]
-    def initialize(id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT,
-                   points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
+    def initialize(id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, breakdown_attribute: OMIT, metric_key: OMIT, metric_name: OMIT,
+                   points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
       @id = id
       @name = name
       @key = key
       @rank_by = rank_by
+      @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
       @metric_key = metric_key if metric_key != OMIT
       @metric_name = metric_name if metric_name != OMIT
       @points_system_key = points_system_key if points_system_key != OMIT
@@ -88,6 +92,7 @@ module TrophyApiClient
         "name": name,
         "key": key,
         "rankBy": rank_by,
+        "breakdownAttribute": breakdown_attribute,
         "metricKey": metric_key,
         "metricName": metric_name,
         "pointsSystemKey": points_system_key,
@@ -114,6 +119,7 @@ module TrophyApiClient
       name = parsed_json["name"]
       key = parsed_json["key"]
       rank_by = parsed_json["rankBy"]
+      breakdown_attribute = parsed_json["breakdownAttribute"]
       metric_key = parsed_json["metricKey"]
       metric_name = parsed_json["metricName"]
       points_system_key = parsed_json["pointsSystemKey"]
@@ -129,6 +135,7 @@ module TrophyApiClient
         name: name,
         key: key,
         rank_by: rank_by,
+        breakdown_attribute: breakdown_attribute,
         metric_key: metric_key,
         metric_name: metric_name,
         points_system_key: points_system_key,
@@ -161,6 +168,7 @@ module TrophyApiClient
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
       obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+      obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
       obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
       obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
       obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/types/leaderboard_response_with_rankings.rb

@@ -21,6 +21,8 @@ module TrophyApiClient
     attr_reader :key
     # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
     attr_reader :rank_by
+    # @return [String] The key of the attribute to break down this leaderboard by.
+    attr_reader :breakdown_attribute
     # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
     attr_reader :metric_key
     # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -58,6 +60,7 @@ module TrophyApiClient
     # @param name [String] The user-facing name of the leaderboard.
     # @param key [String] The unique key used to reference the leaderboard in APIs.
     # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+    # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
     # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
     # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
     # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -73,14 +76,15 @@ module TrophyApiClient
     #  type.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::LeaderboardResponseWithRankings]
-    def initialize(status:, rankings:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, metric_key: OMIT, metric_name: OMIT,
-                   points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
+    def initialize(status:, rankings:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, breakdown_attribute: OMIT, metric_key: OMIT,
+                   metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
       @status = status
       @rankings = rankings
       @id = id
       @name = name
       @key = key
       @rank_by = rank_by
+      @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
       @metric_key = metric_key if metric_key != OMIT
       @metric_name = metric_name if metric_name != OMIT
       @points_system_key = points_system_key if points_system_key != OMIT
@@ -99,6 +103,7 @@ module TrophyApiClient
         "name": name,
         "key": key,
         "rankBy": rank_by,
+        "breakdownAttribute": breakdown_attribute,
         "metricKey": metric_key,
         "metricName": metric_name,
         "pointsSystemKey": points_system_key,
@@ -130,6 +135,7 @@ module TrophyApiClient
       name = parsed_json["name"]
       key = parsed_json["key"]
       rank_by = parsed_json["rankBy"]
+      breakdown_attribute = parsed_json["breakdownAttribute"]
       metric_key = parsed_json["metricKey"]
       metric_name = parsed_json["metricName"]
       points_system_key = parsed_json["pointsSystemKey"]
@@ -147,6 +153,7 @@ module TrophyApiClient
         name: name,
         key: key,
         rank_by: rank_by,
+        breakdown_attribute: breakdown_attribute,
         metric_key: metric_key,
         metric_name: metric_name,
         points_system_key: points_system_key,
@@ -181,6 +188,7 @@ module TrophyApiClient
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
       obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+      obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
       obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
       obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
       obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/types/metric_event_leaderboard_response.rb

@@ -19,6 +19,9 @@ module TrophyApiClient
     # @return [Integer] The minimum value required to enter the leaderboard according to its current
     #  rankings.
     attr_reader :threshold
+    # @return [String] For leaderboards with a breakdown attribute, the value of the attribute for the
+    #  user.
+    attr_reader :breakdown_attribute_value
     # @return [String] The unique ID of the leaderboard.
     attr_reader :id
     # @return [String] The user-facing name of the leaderboard.
@@ -27,6 +30,8 @@ module TrophyApiClient
     attr_reader :key
     # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
     attr_reader :rank_by
+    # @return [String] The key of the attribute to break down this leaderboard by.
+    attr_reader :breakdown_attribute
     # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
     attr_reader :metric_key
     # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -63,10 +68,13 @@ module TrophyApiClient
     #  on the leaderboard before the event.
     # @param threshold [Integer] The minimum value required to enter the leaderboard according to its current
     #  rankings.
+    # @param breakdown_attribute_value [String] For leaderboards with a breakdown attribute, the value of the attribute for the
+    #  user.
     # @param id [String] The unique ID of the leaderboard.
     # @param name [String] The user-facing name of the leaderboard.
     # @param key [String] The unique key used to reference the leaderboard in APIs.
     # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+    # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
     # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
     # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
     # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -80,16 +88,18 @@ module TrophyApiClient
     #  type.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::MetricEventLeaderboardResponse]
-    def initialize(threshold:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, end_: OMIT, rank: OMIT, previous_rank: OMIT,
-                   metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, run_unit: OMIT, additional_properties: nil)
+    def initialize(threshold:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:,
+                   end_: OMIT, rank: OMIT, previous_rank: OMIT, breakdown_attribute_value: OMIT, breakdown_attribute: OMIT, metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, run_unit: OMIT, additional_properties: nil)
       @end_ = end_ if end_ != OMIT
       @rank = rank if rank != OMIT
       @previous_rank = previous_rank if previous_rank != OMIT
       @threshold = threshold
+      @breakdown_attribute_value = breakdown_attribute_value if breakdown_attribute_value != OMIT
       @id = id
       @name = name
       @key = key
       @rank_by = rank_by
+      @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
       @metric_key = metric_key if metric_key != OMIT
       @metric_name = metric_name if metric_name != OMIT
       @points_system_key = points_system_key if points_system_key != OMIT
@@ -105,10 +115,12 @@ module TrophyApiClient
         "rank": rank,
         "previousRank": previous_rank,
         "threshold": threshold,
+        "breakdownAttributeValue": breakdown_attribute_value,
         "id": id,
         "name": name,
         "key": key,
         "rankBy": rank_by,
+        "breakdownAttribute": breakdown_attribute,
         "metricKey": metric_key,
         "metricName": metric_name,
         "pointsSystemKey": points_system_key,
@@ -134,10 +146,12 @@ module TrophyApiClient
       rank = parsed_json["rank"]
       previous_rank = parsed_json["previousRank"]
       threshold = parsed_json["threshold"]
+      breakdown_attribute_value = parsed_json["breakdownAttributeValue"]
       id = parsed_json["id"]
       name = parsed_json["name"]
       key = parsed_json["key"]
       rank_by = parsed_json["rankBy"]
+      breakdown_attribute = parsed_json["breakdownAttribute"]
       metric_key = parsed_json["metricKey"]
       metric_name = parsed_json["metricName"]
       points_system_key = parsed_json["pointsSystemKey"]
@@ -152,10 +166,12 @@ module TrophyApiClient
         rank: rank,
         previous_rank: previous_rank,
         threshold: threshold,
+        breakdown_attribute_value: breakdown_attribute_value,
         id: id,
         name: name,
         key: key,
         rank_by: rank_by,
+        breakdown_attribute: breakdown_attribute,
         metric_key: metric_key,
         metric_name: metric_name,
         points_system_key: points_system_key,
@@ -187,10 +203,12 @@ module TrophyApiClient
       obj.rank&.is_a?(Integer) != false || raise("Passed value for field obj.rank is not the expected type, validation failed.")
       obj.previous_rank&.is_a?(Integer) != false || raise("Passed value for field obj.previous_rank is not the expected type, validation failed.")
       obj.threshold.is_a?(Integer) != false || raise("Passed value for field obj.threshold is not the expected type, validation failed.")
+      obj.breakdown_attribute_value&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute_value is not the expected type, validation failed.")
       obj.id.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.")
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
       obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+      obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
       obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
       obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
       obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/types/updated_user.rb

@@ -38,14 +38,14 @@ module TrophyApiClient
     #  up in the Trophy dashboard.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::UpdatedUser]
-    def initialize(email:, name:, device_tokens:, subscribe_to_emails:, attributes:, tz: OMIT,
+    def initialize(email: OMIT, name: OMIT, tz: OMIT, device_tokens: OMIT, subscribe_to_emails: OMIT, attributes: OMIT,
                    additional_properties: nil)
-      @email = email
-      @name = name
+      @email = email if email != OMIT
+      @name = name if name != OMIT
       @tz = tz if tz != OMIT
-      @device_tokens = device_tokens
-      @subscribe_to_emails = subscribe_to_emails
-      @attributes = attributes
+      @device_tokens = device_tokens if device_tokens != OMIT
+      @subscribe_to_emails = subscribe_to_emails if subscribe_to_emails != OMIT
+      @attributes = attributes if attributes != OMIT
       @additional_properties = additional_properties
       @_field_set = {
         "email": email,
@@ -97,12 +97,12 @@ module TrophyApiClient
     # @param obj [Object]
     # @return [Void]
     def self.validate_raw(obj:)
-      obj.email.is_a?(String) != false || raise("Passed value for field obj.email is not the expected type, validation failed.")
-      obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.email&.is_a?(String) != false || raise("Passed value for field obj.email is not the expected type, validation failed.")
+      obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.tz&.is_a?(String) != false || raise("Passed value for field obj.tz is not the expected type, validation failed.")
-      obj.device_tokens.is_a?(Array) != false || raise("Passed value for field obj.device_tokens is not the expected type, validation failed.")
-      obj.subscribe_to_emails.is_a?(Boolean) != false || raise("Passed value for field obj.subscribe_to_emails is not the expected type, validation failed.")
-      obj.attributes.is_a?(Hash) != false || raise("Passed value for field obj.attributes is not the expected type, validation failed.")
+      obj.device_tokens&.is_a?(Array) != false || raise("Passed value for field obj.device_tokens is not the expected type, validation failed.")
+      obj.subscribe_to_emails&.is_a?(Boolean) != false || raise("Passed value for field obj.subscribe_to_emails is not the expected type, validation failed.")
+      obj.attributes&.is_a?(Hash) != false || raise("Passed value for field obj.attributes is not the expected type, validation failed.")
     end
   end
 end

data/lib/trophy_api_client/types/upserted_user.rb

@@ -41,15 +41,15 @@ module TrophyApiClient
     #  up in the Trophy dashboard.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::UpsertedUser]
-    def initialize(id:, email:, name:, device_tokens:, subscribe_to_emails:, attributes:, tz: OMIT,
-                   additional_properties: nil)
+    def initialize(id:, email: OMIT, name: OMIT, tz: OMIT, device_tokens: OMIT, subscribe_to_emails: OMIT,
+                   attributes: OMIT, additional_properties: nil)
       @id = id
-      @email = email
-      @name = name
+      @email = email if email != OMIT
+      @name = name if name != OMIT
       @tz = tz if tz != OMIT
-      @device_tokens = device_tokens
-      @subscribe_to_emails = subscribe_to_emails
-      @attributes = attributes
+      @device_tokens = device_tokens if device_tokens != OMIT
+      @subscribe_to_emails = subscribe_to_emails if subscribe_to_emails != OMIT
+      @attributes = attributes if attributes != OMIT
       @additional_properties = additional_properties
       @_field_set = {
         "id": id,
@@ -105,12 +105,12 @@ module TrophyApiClient
     # @return [Void]
     def self.validate_raw(obj:)
       obj.id.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.")
-      obj.email.is_a?(String) != false || raise("Passed value for field obj.email is not the expected type, validation failed.")
-      obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.email&.is_a?(String) != false || raise("Passed value for field obj.email is not the expected type, validation failed.")
+      obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.tz&.is_a?(String) != false || raise("Passed value for field obj.tz is not the expected type, validation failed.")
-      obj.device_tokens.is_a?(Array) != false || raise("Passed value for field obj.device_tokens is not the expected type, validation failed.")
-      obj.subscribe_to_emails.is_a?(Boolean) != false || raise("Passed value for field obj.subscribe_to_emails is not the expected type, validation failed.")
-      obj.attributes.is_a?(Hash) != false || raise("Passed value for field obj.attributes is not the expected type, validation failed.")
+      obj.device_tokens&.is_a?(Array) != false || raise("Passed value for field obj.device_tokens is not the expected type, validation failed.")
+      obj.subscribe_to_emails&.is_a?(Boolean) != false || raise("Passed value for field obj.subscribe_to_emails is not the expected type, validation failed.")
+      obj.attributes&.is_a?(Hash) != false || raise("Passed value for field obj.attributes is not the expected type, validation failed.")
     end
   end
 end

data/lib/trophy_api_client/types/user.rb

@@ -7,29 +7,28 @@ require "json"
 module TrophyApiClient
   # A user of your application.
   class User
-    # @return [Boolean] Whether the user is in the control group, meaning they do not receive emails or
-    #  other communications from Trophy.
-    attr_reader :control
-    # @return [DateTime] The date and time the user was created, in ISO 8601 format.
-    attr_reader :created
-    # @return [DateTime] The date and time the user was last updated, in ISO 8601 format.
-    attr_reader :updated
     # @return [String] The ID of the user in your database. Must be a string.
     attr_reader :id
-    # @return [String] The user's email address. Required if subscribeToEmails is true.
+    # @return [String] The user's email address.
     attr_reader :email
-    # @return [String] The name to refer to the user by in emails.
+    # @return [String] The name of the user.
     attr_reader :name
-    # @return [String] The user's timezone (used for email scheduling).
+    # @return [String] The user's timezone.
     attr_reader :tz
-    # @return [Array<String>] The user's device tokens, used for push notifications.
+    # @return [Array<String>] The user's device tokens.
     attr_reader :device_tokens
-    # @return [Boolean] Whether the user should receive Trophy-powered emails. If false, Trophy will not
-    #  store the user's email address.
+    # @return [Boolean] Whether the user is opted into receiving Trophy-powered emails.
     attr_reader :subscribe_to_emails
     # @return [Hash{String => String}] User attributes as key-value pairs. Keys must match existing user attributes set
     #  up in the Trophy dashboard.
     attr_reader :attributes
+    # @return [Boolean] Whether the user is in the control group, meaning they do not receive emails or
+    #  other communications from Trophy.
+    attr_reader :control
+    # @return [DateTime] The date and time the user was created, in ISO 8601 format.
+    attr_reader :created
+    # @return [DateTime] The date and time the user was last updated, in ISO 8601 format.
+    attr_reader :updated
     # @return [OpenStruct] Additional properties unmapped to the current class definition
     attr_reader :additional_properties
     # @return [Object]
@@ -38,45 +37,44 @@ module TrophyApiClient
 
     OMIT = Object.new
 
+    # @param id [String] The ID of the user in your database. Must be a string.
+    # @param email [String] The user's email address.
+    # @param name [String] The name of the user.
+    # @param tz [String] The user's timezone.
+    # @param device_tokens [Array<String>] The user's device tokens.
+    # @param subscribe_to_emails [Boolean] Whether the user is opted into receiving Trophy-powered emails.
+    # @param attributes [Hash{String => String}] User attributes as key-value pairs. Keys must match existing user attributes set
+    #  up in the Trophy dashboard.
     # @param control [Boolean] Whether the user is in the control group, meaning they do not receive emails or
     #  other communications from Trophy.
     # @param created [DateTime] The date and time the user was created, in ISO 8601 format.
     # @param updated [DateTime] The date and time the user was last updated, in ISO 8601 format.
-    # @param id [String] The ID of the user in your database. Must be a string.
-    # @param email [String] The user's email address. Required if subscribeToEmails is true.
-    # @param name [String] The name to refer to the user by in emails.
-    # @param tz [String] The user's timezone (used for email scheduling).
-    # @param device_tokens [Array<String>] The user's device tokens, used for push notifications.
-    # @param subscribe_to_emails [Boolean] Whether the user should receive Trophy-powered emails. If false, Trophy will not
-    #  store the user's email address.
-    # @param attributes [Hash{String => String}] User attributes as key-value pairs. Keys must match existing user attributes set
-    #  up in the Trophy dashboard.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::User]
-    def initialize(control:, created:, updated:, id:, email:, name:, device_tokens:, subscribe_to_emails:, attributes:,
-                   tz: OMIT, additional_properties: nil)
-      @control = control
-      @created = created
-      @updated = updated
+    def initialize(id:, device_tokens:, subscribe_to_emails:, attributes:, control:, created:, updated:, email: OMIT,
+                   name: OMIT, tz: OMIT, additional_properties: nil)
       @id = id
-      @email = email
-      @name = name
+      @email = email if email != OMIT
+      @name = name if name != OMIT
       @tz = tz if tz != OMIT
       @device_tokens = device_tokens
       @subscribe_to_emails = subscribe_to_emails
       @attributes = attributes
+      @control = control
+      @created = created
+      @updated = updated
       @additional_properties = additional_properties
       @_field_set = {
-        "control": control,
-        "created": created,
-        "updated": updated,
         "id": id,
         "email": email,
         "name": name,
         "tz": tz,
         "deviceTokens": device_tokens,
         "subscribeToEmails": subscribe_to_emails,
-        "attributes": attributes
+        "attributes": attributes,
+        "control": control,
+        "created": created,
+        "updated": updated
       }.reject do |_k, v|
         v == OMIT
       end
@@ -89,9 +87,6 @@ module TrophyApiClient
     def self.from_json(json_object:)
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
-      control = parsed_json["control"]
-      created = (DateTime.parse(parsed_json["created"]) unless parsed_json["created"].nil?)
-      updated = (DateTime.parse(parsed_json["updated"]) unless parsed_json["updated"].nil?)
       id = parsed_json["id"]
       email = parsed_json["email"]
       name = parsed_json["name"]
@@ -99,10 +94,10 @@ module TrophyApiClient
       device_tokens = parsed_json["deviceTokens"]
       subscribe_to_emails = parsed_json["subscribeToEmails"]
       attributes = parsed_json["attributes"]
+      control = parsed_json["control"]
+      created = (DateTime.parse(parsed_json["created"]) unless parsed_json["created"].nil?)
+      updated = (DateTime.parse(parsed_json["updated"]) unless parsed_json["updated"].nil?)
       new(
-        control: control,
-        created: created,
-        updated: updated,
         id: id,
         email: email,
         name: name,
@@ -110,6 +105,9 @@ module TrophyApiClient
         device_tokens: device_tokens,
         subscribe_to_emails: subscribe_to_emails,
         attributes: attributes,
+        control: control,
+        created: created,
+        updated: updated,
         additional_properties: struct
       )
     end
@@ -128,16 +126,16 @@ module TrophyApiClient
     # @param obj [Object]
     # @return [Void]
     def self.validate_raw(obj:)
-      obj.control.is_a?(Boolean) != false || raise("Passed value for field obj.control is not the expected type, validation failed.")
-      obj.created.is_a?(DateTime) != false || raise("Passed value for field obj.created is not the expected type, validation failed.")
-      obj.updated.is_a?(DateTime) != false || raise("Passed value for field obj.updated is not the expected type, validation failed.")
       obj.id.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.")
-      obj.email.is_a?(String) != false || raise("Passed value for field obj.email is not the expected type, validation failed.")
-      obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.email&.is_a?(String) != false || raise("Passed value for field obj.email is not the expected type, validation failed.")
+      obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.tz&.is_a?(String) != false || raise("Passed value for field obj.tz is not the expected type, validation failed.")
       obj.device_tokens.is_a?(Array) != false || raise("Passed value for field obj.device_tokens is not the expected type, validation failed.")
       obj.subscribe_to_emails.is_a?(Boolean) != false || raise("Passed value for field obj.subscribe_to_emails is not the expected type, validation failed.")
       obj.attributes.is_a?(Hash) != false || raise("Passed value for field obj.attributes is not the expected type, validation failed.")
+      obj.control.is_a?(Boolean) != false || raise("Passed value for field obj.control is not the expected type, validation failed.")
+      obj.created.is_a?(DateTime) != false || raise("Passed value for field obj.created is not the expected type, validation failed.")
+      obj.updated.is_a?(DateTime) != false || raise("Passed value for field obj.updated is not the expected type, validation failed.")
     end
   end
 end

data/lib/trophy_api_client/types/user_leaderboard_response.rb

@@ -22,6 +22,8 @@ module TrophyApiClient
     attr_reader :key
     # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
     attr_reader :rank_by
+    # @return [String] The key of the attribute to break down this leaderboard by.
+    attr_reader :breakdown_attribute
     # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
     attr_reader :metric_key
     # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -61,6 +63,7 @@ module TrophyApiClient
     # @param name [String] The user-facing name of the leaderboard.
     # @param key [String] The unique key used to reference the leaderboard in APIs.
     # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+    # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
     # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
     # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
     # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -76,14 +79,15 @@ module TrophyApiClient
     #  type.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::UserLeaderboardResponse]
-    def initialize(id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, rank: OMIT, value: OMIT, metric_key: OMIT, metric_name: OMIT,
-                   points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
+    def initialize(id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, rank: OMIT, value: OMIT, breakdown_attribute: OMIT, metric_key: OMIT,
+                   metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
       @rank = rank if rank != OMIT
       @value = value if value != OMIT
       @id = id
       @name = name
       @key = key
       @rank_by = rank_by
+      @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
       @metric_key = metric_key if metric_key != OMIT
       @metric_name = metric_name if metric_name != OMIT
       @points_system_key = points_system_key if points_system_key != OMIT
@@ -102,6 +106,7 @@ module TrophyApiClient
         "name": name,
         "key": key,
         "rankBy": rank_by,
+        "breakdownAttribute": breakdown_attribute,
         "metricKey": metric_key,
         "metricName": metric_name,
         "pointsSystemKey": points_system_key,
@@ -130,6 +135,7 @@ module TrophyApiClient
       name = parsed_json["name"]
       key = parsed_json["key"]
       rank_by = parsed_json["rankBy"]
+      breakdown_attribute = parsed_json["breakdownAttribute"]
       metric_key = parsed_json["metricKey"]
       metric_name = parsed_json["metricName"]
       points_system_key = parsed_json["pointsSystemKey"]
@@ -147,6 +153,7 @@ module TrophyApiClient
         name: name,
         key: key,
         rank_by: rank_by,
+        breakdown_attribute: breakdown_attribute,
         metric_key: metric_key,
         metric_name: metric_name,
         points_system_key: points_system_key,
@@ -181,6 +188,7 @@ module TrophyApiClient
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
       obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+      obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
       obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
       obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
       obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/types/user_leaderboard_response_with_history.rb

@@ -25,6 +25,8 @@ module TrophyApiClient
     attr_reader :key
     # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
     attr_reader :rank_by
+    # @return [String] The key of the attribute to break down this leaderboard by.
+    attr_reader :breakdown_attribute
     # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
     attr_reader :metric_key
     # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -65,6 +67,7 @@ module TrophyApiClient
     # @param name [String] The user-facing name of the leaderboard.
     # @param key [String] The unique key used to reference the leaderboard in APIs.
     # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+    # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
     # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
     # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
     # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -80,8 +83,8 @@ module TrophyApiClient
     #  type.
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::UserLeaderboardResponseWithHistory]
-    def initialize(history:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, rank: OMIT, value: OMIT, metric_key: OMIT, metric_name: OMIT,
-                   points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
+    def initialize(history:, id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, rank: OMIT, value: OMIT, breakdown_attribute: OMIT,
+                   metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
       @history = history
       @rank = rank if rank != OMIT
       @value = value if value != OMIT
@@ -89,6 +92,7 @@ module TrophyApiClient
       @name = name
       @key = key
       @rank_by = rank_by
+      @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
       @metric_key = metric_key if metric_key != OMIT
       @metric_name = metric_name if metric_name != OMIT
       @points_system_key = points_system_key if points_system_key != OMIT
@@ -108,6 +112,7 @@ module TrophyApiClient
         "name": name,
         "key": key,
         "rankBy": rank_by,
+        "breakdownAttribute": breakdown_attribute,
         "metricKey": metric_key,
         "metricName": metric_name,
         "pointsSystemKey": points_system_key,
@@ -140,6 +145,7 @@ module TrophyApiClient
       name = parsed_json["name"]
       key = parsed_json["key"]
       rank_by = parsed_json["rankBy"]
+      breakdown_attribute = parsed_json["breakdownAttribute"]
       metric_key = parsed_json["metricKey"]
       metric_name = parsed_json["metricName"]
       points_system_key = parsed_json["pointsSystemKey"]
@@ -158,6 +164,7 @@ module TrophyApiClient
         name: name,
         key: key,
         rank_by: rank_by,
+        breakdown_attribute: breakdown_attribute,
         metric_key: metric_key,
         metric_name: metric_name,
         points_system_key: points_system_key,
@@ -193,6 +200,7 @@ module TrophyApiClient
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
       obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+      obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
       obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
       obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
       obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/types/webhook_user_leaderboard_response.rb

@@ -26,6 +26,8 @@ module TrophyApiClient
     attr_reader :key
     # @return [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
     attr_reader :rank_by
+    # @return [String] The key of the attribute to break down this leaderboard by.
+    attr_reader :breakdown_attribute
     # @return [String] The key of the metric to rank by, if rankBy is 'metric'.
     attr_reader :metric_key
     # @return [String] The name of the metric to rank by, if rankBy is 'metric'.
@@ -67,6 +69,7 @@ module TrophyApiClient
     # @param name [String] The user-facing name of the leaderboard.
     # @param key [String] The unique key used to reference the leaderboard in APIs.
     # @param rank_by [TrophyApiClient::LeaderboardResponseRankBy] What the leaderboard ranks by.
+    # @param breakdown_attribute [String] The key of the attribute to break down this leaderboard by.
     # @param metric_key [String] The key of the metric to rank by, if rankBy is 'metric'.
     # @param metric_name [String] The name of the metric to rank by, if rankBy is 'metric'.
     # @param points_system_key [String] The key of the points system to rank by, if rankBy is 'points'.
@@ -83,7 +86,7 @@ module TrophyApiClient
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
     # @return [TrophyApiClient::WebhookUserLeaderboardResponse]
     def initialize(id:, name:, key:, rank_by:, description:, start:, max_participants:, run_interval:, previous_rank: OMIT, previous_value: OMIT, rank: OMIT, value: OMIT,
-                   metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
+                   breakdown_attribute: OMIT, metric_key: OMIT, metric_name: OMIT, points_system_key: OMIT, points_system_name: OMIT, end_: OMIT, run_unit: OMIT, additional_properties: nil)
       @previous_rank = previous_rank if previous_rank != OMIT
       @previous_value = previous_value if previous_value != OMIT
       @rank = rank if rank != OMIT
@@ -92,6 +95,7 @@ module TrophyApiClient
       @name = name
       @key = key
       @rank_by = rank_by
+      @breakdown_attribute = breakdown_attribute if breakdown_attribute != OMIT
       @metric_key = metric_key if metric_key != OMIT
       @metric_name = metric_name if metric_name != OMIT
       @points_system_key = points_system_key if points_system_key != OMIT
@@ -112,6 +116,7 @@ module TrophyApiClient
         "name": name,
         "key": key,
         "rankBy": rank_by,
+        "breakdownAttribute": breakdown_attribute,
         "metricKey": metric_key,
         "metricName": metric_name,
         "pointsSystemKey": points_system_key,
@@ -142,6 +147,7 @@ module TrophyApiClient
       name = parsed_json["name"]
       key = parsed_json["key"]
       rank_by = parsed_json["rankBy"]
+      breakdown_attribute = parsed_json["breakdownAttribute"]
       metric_key = parsed_json["metricKey"]
       metric_name = parsed_json["metricName"]
       points_system_key = parsed_json["pointsSystemKey"]
@@ -161,6 +167,7 @@ module TrophyApiClient
         name: name,
         key: key,
         rank_by: rank_by,
+        breakdown_attribute: breakdown_attribute,
         metric_key: metric_key,
         metric_name: metric_name,
         points_system_key: points_system_key,
@@ -197,6 +204,7 @@ module TrophyApiClient
       obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
       obj.key.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
       obj.rank_by.is_a?(TrophyApiClient::LeaderboardResponseRankBy) != false || raise("Passed value for field obj.rank_by is not the expected type, validation failed.")
+      obj.breakdown_attribute&.is_a?(String) != false || raise("Passed value for field obj.breakdown_attribute is not the expected type, validation failed.")
       obj.metric_key&.is_a?(String) != false || raise("Passed value for field obj.metric_key is not the expected type, validation failed.")
       obj.metric_name&.is_a?(String) != false || raise("Passed value for field obj.metric_name is not the expected type, validation failed.")
       obj.points_system_key&.is_a?(String) != false || raise("Passed value for field obj.points_system_key is not the expected type, validation failed.")

data/lib/trophy_api_client/users/client.rb

@@ -45,7 +45,7 @@ module TrophyApiClient
     #    environment: TrophyApiClient::Environment::PRODUCTION,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.users.create(request: { email: "user@example.com", name: "User", device_tokens: ["token1", "token2"], subscribe_to_emails: true, attributes: { "department": "engineering", "role": "developer" }, id: "user-id" })
+    #  api.users.create(request: { id: "user-id" })
     def create(request:, request_options: nil)
       response = @request_client.conn.post do |req|
         req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -114,7 +114,7 @@ module TrophyApiClient
     #    environment: TrophyApiClient::Environment::PRODUCTION,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.users.identify(id: "id", request: { email: "user@example.com", name: "User", tz: "Europe/London", device_tokens: ["token1", "token2"], subscribe_to_emails: true, attributes: { "department": "engineering", "role": "developer" } })
+    #  api.users.identify(id: "id", request: { email: "user@example.com", tz: "Europe/London", attributes: { "department": "engineering", "role": "developer" } })
     def identify(id:, request:, request_options: nil)
       response = @request_client.conn.put do |req|
         req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -151,7 +151,7 @@ module TrophyApiClient
     #    environment: TrophyApiClient::Environment::PRODUCTION,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.users.update(id: "id", request: { email: "user@example.com", name: "User", tz: "Europe/London", device_tokens: ["token1", "token2"], subscribe_to_emails: true, attributes: { "department": "engineering", "role": "developer" } })
+    #  api.users.update(id: "id", request: { email: "user@example.com", tz: "Europe/London", attributes: { "department": "engineering", "role": "developer" } })
     def update(id:, request:, request_options: nil)
       response = @request_client.conn.patch do |req|
         req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
@@ -525,7 +525,7 @@ module TrophyApiClient
     #    environment: TrophyApiClient::Environment::PRODUCTION,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.users.create(request: { email: "user@example.com", name: "User", device_tokens: ["token1", "token2"], subscribe_to_emails: true, attributes: { "department": "engineering", "role": "developer" }, id: "user-id" })
+    #  api.users.create(request: { id: "user-id" })
     def create(request:, request_options: nil)
       Async do
         response = @request_client.conn.post do |req|
@@ -598,7 +598,7 @@ module TrophyApiClient
     #    environment: TrophyApiClient::Environment::PRODUCTION,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.users.identify(id: "id", request: { email: "user@example.com", name: "User", tz: "Europe/London", device_tokens: ["token1", "token2"], subscribe_to_emails: true, attributes: { "department": "engineering", "role": "developer" } })
+    #  api.users.identify(id: "id", request: { email: "user@example.com", tz: "Europe/London", attributes: { "department": "engineering", "role": "developer" } })
     def identify(id:, request:, request_options: nil)
       Async do
         response = @request_client.conn.put do |req|
@@ -637,7 +637,7 @@ module TrophyApiClient
     #    environment: TrophyApiClient::Environment::PRODUCTION,
     #    api_key: "YOUR_API_KEY"
     #  )
-    #  api.users.update(id: "id", request: { email: "user@example.com", name: "User", tz: "Europe/London", device_tokens: ["token1", "token2"], subscribe_to_emails: true, attributes: { "department": "engineering", "role": "developer" } })
+    #  api.users.update(id: "id", request: { email: "user@example.com", tz: "Europe/London", attributes: { "department": "engineering", "role": "developer" } })
     def update(id:, request:, request_options: nil)
       Async do
         response = @request_client.conn.patch do |req|

data/lib/trophy_api_client/version.rb

@@ -1,3 +1,3 @@
 module MyGem
-  VERSION = "1.0.30"
+  VERSION = "1.0.32"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trophy_api_client
 version: !ruby/object:Gem::Version
-  version: 1.0.30
+  version: 1.0.32
 platform: ruby
 authors:
 - Trophy Labs, Inc