merge_ruby_client 0.1.3 → 1.0.0

data/lib/merge_ruby_client/ticketing/types/project.rb

@@ -27,7 +27,9 @@ module Merge
       # @return [String] The project's description.
       attr_reader :description
       # @return [Boolean] Indicates whether or not this object has been deleted in the third party
-      #  platform.
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       attr_reader :remote_was_deleted
       # @return [Hash{String => Object}]
       attr_reader :field_mappings
@@ -48,7 +50,9 @@ module Merge
       # @param name [String] The project's name.
       # @param description [String] The project's description.
       # @param remote_was_deleted [Boolean] Indicates whether or not this object has been deleted in the third party
-      #  platform.
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       # @param field_mappings [Hash{String => Object}]
       # @param remote_data [Array<Merge::Ticketing::RemoteData>]
       # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition

data/lib/merge_ruby_client/ticketing/types/remote_data.rb

@@ -5,8 +5,14 @@ require "json"
 
 module Merge
   module Ticketing
+    # # The RemoteData Object
+    #  ### Description
+    #  The `RemoteData` object is used to represent the full data pulled from the
+    #  third-party API for an object.
+    #  ### Usage Example
+    #  TODO
     class RemoteData
-      # @return [String]
+      # @return [String] The third-party API path that is being called.
       attr_reader :path
       # @return [Object]
       attr_reader :data
@@ -18,7 +24,7 @@ module Merge
 
       OMIT = Object.new
 
-      # @param path [String]
+      # @param path [String] The third-party API path that is being called.
       # @param data [Object]
       # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
       # @return [Merge::Ticketing::RemoteData]

data/lib/merge_ruby_client/ticketing/types/remote_field_api.rb

@@ -37,12 +37,12 @@ module Merge
       # @param coverage [Merge::Ticketing::RemoteFieldApiCoverage]
       # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
       # @return [Merge::Ticketing::RemoteFieldApi]
-      def initialize(schema:, remote_key_name:, remote_endpoint_info:, example_values:, advanced_metadata: OMIT,
+      def initialize(schema:, remote_key_name:, remote_endpoint_info:, example_values: OMIT, advanced_metadata: OMIT,
                      coverage: OMIT, additional_properties: nil)
         @schema = schema
         @remote_key_name = remote_key_name
         @remote_endpoint_info = remote_endpoint_info
-        @example_values = example_values
+        @example_values = example_values if example_values != OMIT
         @advanced_metadata = advanced_metadata if advanced_metadata != OMIT
         @coverage = coverage if coverage != OMIT
         @additional_properties = additional_properties
@@ -114,7 +114,7 @@ module Merge
         obj.schema.is_a?(Hash) != false || raise("Passed value for field obj.schema is not the expected type, validation failed.")
         obj.remote_key_name.is_a?(String) != false || raise("Passed value for field obj.remote_key_name is not the expected type, validation failed.")
         Merge::Ticketing::RemoteEndpointInfo.validate_raw(obj: obj.remote_endpoint_info)
-        obj.example_values.is_a?(Array) != false || raise("Passed value for field obj.example_values is not the expected type, validation failed.")
+        obj.example_values&.is_a?(Array) != false || raise("Passed value for field obj.example_values is not the expected type, validation failed.")
         obj.advanced_metadata.nil? || Merge::Ticketing::AdvancedMetadata.validate_raw(obj: obj.advanced_metadata)
         obj.coverage.nil? || Merge::Ticketing::RemoteFieldApiCoverage.validate_raw(obj: obj.coverage)
       end

data/lib/merge_ruby_client/ticketing/types/role.rb

@@ -35,7 +35,9 @@ module Merge
       #  - `TEAM_ONLY` - TEAM_ONLY
       attr_reader :ticket_access
       # @return [Boolean] Indicates whether or not this object has been deleted in the third party
-      #  platform.
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       attr_reader :remote_was_deleted
       # @return [Hash{String => Object}]
       attr_reader :field_mappings
@@ -61,7 +63,9 @@ module Merge
       #  - `ASSIGNED_ONLY` - ASSIGNED_ONLY
       #  - `TEAM_ONLY` - TEAM_ONLY
       # @param remote_was_deleted [Boolean] Indicates whether or not this object has been deleted in the third party
-      #  platform.
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       # @param field_mappings [Hash{String => Object}]
       # @param remote_data [Array<Merge::Ticketing::RemoteData>]
       # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition

data/lib/merge_ruby_client/ticketing/types/tag.rb

@@ -19,10 +19,14 @@ module Merge
       attr_reader :created_at
       # @return [DateTime] The datetime that this object was modified by Merge.
       attr_reader :modified_at
+      # @return [String]
+      attr_reader :id
       # @return [String] The tag's name.
       attr_reader :name
       # @return [Boolean] Indicates whether or not this object has been deleted in the third party
-      #  platform.
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       attr_reader :remote_was_deleted
       # @return [Hash{String => Object}]
       attr_reader :field_mappings
@@ -39,18 +43,22 @@ module Merge
       # @param remote_id [String] The third-party API ID of the matching object.
       # @param created_at [DateTime] The datetime that this object was created by Merge.
       # @param modified_at [DateTime] The datetime that this object was modified by Merge.
+      # @param id [String]
       # @param name [String] The tag's name.
       # @param remote_was_deleted [Boolean] Indicates whether or not this object has been deleted in the third party
-      #  platform.
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       # @param field_mappings [Hash{String => Object}]
       # @param remote_data [Array<Merge::Ticketing::RemoteData>]
       # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
       # @return [Merge::Ticketing::Tag]
-      def initialize(remote_id: OMIT, created_at: OMIT, modified_at: OMIT, name: OMIT, remote_was_deleted: OMIT,
-                     field_mappings: OMIT, remote_data: OMIT, additional_properties: nil)
+      def initialize(remote_id: OMIT, created_at: OMIT, modified_at: OMIT, id: OMIT, name: OMIT,
+                     remote_was_deleted: OMIT, field_mappings: OMIT, remote_data: OMIT, additional_properties: nil)
         @remote_id = remote_id if remote_id != OMIT
         @created_at = created_at if created_at != OMIT
         @modified_at = modified_at if modified_at != OMIT
+        @id = id if id != OMIT
         @name = name if name != OMIT
         @remote_was_deleted = remote_was_deleted if remote_was_deleted != OMIT
         @field_mappings = field_mappings if field_mappings != OMIT
@@ -60,6 +68,7 @@ module Merge
           "remote_id": remote_id,
           "created_at": created_at,
           "modified_at": modified_at,
+          "id": id,
           "name": name,
           "remote_was_deleted": remote_was_deleted,
           "field_mappings": field_mappings,
@@ -79,6 +88,7 @@ module Merge
         remote_id = parsed_json["remote_id"]
         created_at = (DateTime.parse(parsed_json["created_at"]) unless parsed_json["created_at"].nil?)
         modified_at = (DateTime.parse(parsed_json["modified_at"]) unless parsed_json["modified_at"].nil?)
+        id = parsed_json["id"]
         name = parsed_json["name"]
         remote_was_deleted = parsed_json["remote_was_deleted"]
         field_mappings = parsed_json["field_mappings"]
@@ -90,6 +100,7 @@ module Merge
           remote_id: remote_id,
           created_at: created_at,
           modified_at: modified_at,
+          id: id,
           name: name,
           remote_was_deleted: remote_was_deleted,
           field_mappings: field_mappings,
@@ -115,6 +126,7 @@ module Merge
         obj.remote_id&.is_a?(String) != false || raise("Passed value for field obj.remote_id is not the expected type, validation failed.")
         obj.created_at&.is_a?(DateTime) != false || raise("Passed value for field obj.created_at is not the expected type, validation failed.")
         obj.modified_at&.is_a?(DateTime) != false || raise("Passed value for field obj.modified_at 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.remote_was_deleted&.is_a?(Boolean) != false || raise("Passed value for field obj.remote_was_deleted is not the expected type, validation failed.")
         obj.field_mappings&.is_a?(Hash) != false || raise("Passed value for field obj.field_mappings is not the expected type, validation failed.")

data/lib/merge_ruby_client/ticketing/types/team.rb

@@ -9,8 +9,8 @@ module Merge
   module Ticketing
     # # The Team Object
     #  ### Description
-    #  The `Team` object is used to represent a team within the company receiving the
-    #  ticket.
+    #  The `Team` object is used to represent one or more `Users` within the company
+    #  receiving the ticket.
     #  ### Usage Example
     #  TODO
     class Team
@@ -27,7 +27,9 @@ module Merge
       # @return [String] The team's description.
       attr_reader :description
       # @return [Boolean] Indicates whether or not this object has been deleted in the third party
-      #  platform.
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       attr_reader :remote_was_deleted
       # @return [Hash{String => Object}]
       attr_reader :field_mappings
@@ -48,7 +50,9 @@ module Merge
       # @param name [String] The team's name.
       # @param description [String] The team's description.
       # @param remote_was_deleted [Boolean] Indicates whether or not this object has been deleted in the third party
-      #  platform.
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       # @param field_mappings [Hash{String => Object}]
       # @param remote_data [Array<Merge::Ticketing::RemoteData>]
       # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition

data/lib/merge_ruby_client/ticketing/types/ticket.rb

@@ -2,6 +2,7 @@
 
 require "date"
 require_relative "ticket_assignees_item"
+require_relative "ticket_assigned_teams_item"
 require_relative "ticket_creator"
 require_relative "ticket_status_enum"
 require_relative "ticket_collections_item"
@@ -19,7 +20,7 @@ module Merge
   module Ticketing
     # # The Ticket Object
     #  ### Description
-    #  The `Ticket` object is used to represent a ticket or a task within a system.
+    #  The `Ticket` object is used to represent a ticket, issue, task or case.
     #  ### Usage Example
     #  TODO
     class Ticket
@@ -33,8 +34,12 @@ module Merge
       attr_reader :modified_at
       # @return [String] The ticket's name.
       attr_reader :name
-      # @return [Array<Merge::Ticketing::TicketAssigneesItem>]
+      # @return [Array<Merge::Ticketing::TicketAssigneesItem>] The individual `Users` who are assigned to this ticket. This does not include
+      #  `Users` who just have view access to this ticket.
       attr_reader :assignees
+      # @return [Array<Merge::Ticketing::TicketAssignedTeamsItem>] The `Teams` that are assigned to this ticket. This does not include `Teams` who
+      #  just have view access to this ticket.
+      attr_reader :assigned_teams
       # @return [Merge::Ticketing::TicketCreator] The user who created this ticket.
       attr_reader :creator
       # @return [DateTime] The ticket's due date.
@@ -48,7 +53,7 @@ module Merge
       # @return [String] The ticket’s description. HTML version of description is mapped if supported by
       #  the third-party platform.
       attr_reader :description
-      # @return [Array<Merge::Ticketing::TicketCollectionsItem>]
+      # @return [Array<Merge::Ticketing::TicketCollectionsItem>] The `Collections` that this `Ticket` is included in.
       attr_reader :collections
       # @return [String] The sub category of the ticket within the 3rd party system. Examples include
       #  incident, task, subtask or to-do.
@@ -63,13 +68,18 @@ module Merge
       attr_reader :attachments
       # @return [Array<String>]
       attr_reader :tags
+      # @return [Array<String>]
+      attr_reader :roles
       # @return [DateTime] When the third party's ticket was created.
       attr_reader :remote_created_at
       # @return [DateTime] When the third party's ticket was updated.
       attr_reader :remote_updated_at
       # @return [DateTime] When the ticket was completed.
       attr_reader :completed_at
-      # @return [Boolean]
+      # @return [Boolean] Indicates whether or not this object has been deleted in the third party
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       attr_reader :remote_was_deleted
       # @return [String] The 3rd party url of the Ticket.
       attr_reader :ticket_url
@@ -98,7 +108,10 @@ module Merge
       # @param created_at [DateTime] The datetime that this object was created by Merge.
       # @param modified_at [DateTime] The datetime that this object was modified by Merge.
       # @param name [String] The ticket's name.
-      # @param assignees [Array<Merge::Ticketing::TicketAssigneesItem>]
+      # @param assignees [Array<Merge::Ticketing::TicketAssigneesItem>] The individual `Users` who are assigned to this ticket. This does not include
+      #  `Users` who just have view access to this ticket.
+      # @param assigned_teams [Array<Merge::Ticketing::TicketAssignedTeamsItem>] The `Teams` that are assigned to this ticket. This does not include `Teams` who
+      #  just have view access to this ticket.
       # @param creator [Merge::Ticketing::TicketCreator] The user who created this ticket.
       # @param due_date [DateTime] The ticket's due date.
       # @param status [Merge::Ticketing::TicketStatusEnum] The current status of the ticket.
@@ -108,7 +121,7 @@ module Merge
       #  - `ON_HOLD` - ON_HOLD
       # @param description [String] The ticket’s description. HTML version of description is mapped if supported by
       #  the third-party platform.
-      # @param collections [Array<Merge::Ticketing::TicketCollectionsItem>]
+      # @param collections [Array<Merge::Ticketing::TicketCollectionsItem>] The `Collections` that this `Ticket` is included in.
       # @param ticket_type [String] The sub category of the ticket within the 3rd party system. Examples include
       #  incident, task, subtask or to-do.
       # @param account [Merge::Ticketing::TicketAccount] The account associated with the ticket.
@@ -116,10 +129,14 @@ module Merge
       # @param parent_ticket [Merge::Ticketing::TicketParentTicket] The ticket's parent ticket.
       # @param attachments [Array<Merge::Ticketing::TicketAttachmentsItem>]
       # @param tags [Array<String>]
+      # @param roles [Array<String>]
       # @param remote_created_at [DateTime] When the third party's ticket was created.
       # @param remote_updated_at [DateTime] When the third party's ticket was updated.
       # @param completed_at [DateTime] When the ticket was completed.
-      # @param remote_was_deleted [Boolean]
+      # @param remote_was_deleted [Boolean] Indicates whether or not this object has been deleted in the third party
+      #  platform. Full coverage deletion detection is a premium add-on. Native deletion
+      #  detection is offered for free with limited coverage. [Learn
+      #  more](https://docs.merge.dev/integrations/hris/supported-features/).
       # @param ticket_url [String] The 3rd party url of the Ticket.
       # @param priority [Merge::Ticketing::PriorityEnum] The priority or urgency of the Ticket.
       #  - `URGENT` - URGENT
@@ -132,13 +149,14 @@ module Merge
       # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
       # @return [Merge::Ticketing::Ticket]
       def initialize(id: OMIT, remote_id: OMIT, created_at: OMIT, modified_at: OMIT, name: OMIT, assignees: OMIT,
-                     creator: OMIT, due_date: OMIT, status: OMIT, description: OMIT, collections: OMIT, ticket_type: OMIT, account: OMIT, contact: OMIT, parent_ticket: OMIT, attachments: OMIT, tags: OMIT, remote_created_at: OMIT, remote_updated_at: OMIT, completed_at: OMIT, remote_was_deleted: OMIT, ticket_url: OMIT, priority: OMIT, field_mappings: OMIT, remote_data: OMIT, remote_fields: OMIT, additional_properties: nil)
+                     assigned_teams: OMIT, creator: OMIT, due_date: OMIT, status: OMIT, description: OMIT, collections: OMIT, ticket_type: OMIT, account: OMIT, contact: OMIT, parent_ticket: OMIT, attachments: OMIT, tags: OMIT, roles: OMIT, remote_created_at: OMIT, remote_updated_at: OMIT, completed_at: OMIT, remote_was_deleted: OMIT, ticket_url: OMIT, priority: OMIT, field_mappings: OMIT, remote_data: OMIT, remote_fields: OMIT, additional_properties: nil)
         @id = id if id != OMIT
         @remote_id = remote_id if remote_id != OMIT
         @created_at = created_at if created_at != OMIT
         @modified_at = modified_at if modified_at != OMIT
         @name = name if name != OMIT
         @assignees = assignees if assignees != OMIT
+        @assigned_teams = assigned_teams if assigned_teams != OMIT
         @creator = creator if creator != OMIT
         @due_date = due_date if due_date != OMIT
         @status = status if status != OMIT
@@ -150,6 +168,7 @@ module Merge
         @parent_ticket = parent_ticket if parent_ticket != OMIT
         @attachments = attachments if attachments != OMIT
         @tags = tags if tags != OMIT
+        @roles = roles if roles != OMIT
         @remote_created_at = remote_created_at if remote_created_at != OMIT
         @remote_updated_at = remote_updated_at if remote_updated_at != OMIT
         @completed_at = completed_at if completed_at != OMIT
@@ -167,6 +186,7 @@ module Merge
           "modified_at": modified_at,
           "name": name,
           "assignees": assignees,
+          "assigned_teams": assigned_teams,
           "creator": creator,
           "due_date": due_date,
           "status": status,
@@ -178,6 +198,7 @@ module Merge
           "parent_ticket": parent_ticket,
           "attachments": attachments,
           "tags": tags,
+          "roles": roles,
           "remote_created_at": remote_created_at,
           "remote_updated_at": remote_updated_at,
           "completed_at": completed_at,
@@ -208,6 +229,10 @@ module Merge
           item = item.to_json
           Merge::Ticketing::TicketAssigneesItem.from_json(json_object: item)
         end
+        assigned_teams = parsed_json["assigned_teams"]&.map do |item|
+          item = item.to_json
+          Merge::Ticketing::TicketAssignedTeamsItem.from_json(json_object: item)
+        end
         if parsed_json["creator"].nil?
           creator = nil
         else
@@ -245,6 +270,7 @@ module Merge
           Merge::Ticketing::TicketAttachmentsItem.from_json(json_object: item)
         end
         tags = parsed_json["tags"]
+        roles = parsed_json["roles"]
         remote_created_at = unless parsed_json["remote_created_at"].nil?
                               DateTime.parse(parsed_json["remote_created_at"])
                             end
@@ -271,6 +297,7 @@ module Merge
           modified_at: modified_at,
           name: name,
           assignees: assignees,
+          assigned_teams: assigned_teams,
           creator: creator,
           due_date: due_date,
           status: status,
@@ -282,6 +309,7 @@ module Merge
           parent_ticket: parent_ticket,
           attachments: attachments,
           tags: tags,
+          roles: roles,
           remote_created_at: remote_created_at,
           remote_updated_at: remote_updated_at,
           completed_at: completed_at,
@@ -315,6 +343,7 @@ module Merge
         obj.modified_at&.is_a?(DateTime) != false || raise("Passed value for field obj.modified_at 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.assignees&.is_a?(Array) != false || raise("Passed value for field obj.assignees is not the expected type, validation failed.")
+        obj.assigned_teams&.is_a?(Array) != false || raise("Passed value for field obj.assigned_teams is not the expected type, validation failed.")
         obj.creator.nil? || Merge::Ticketing::TicketCreator.validate_raw(obj: obj.creator)
         obj.due_date&.is_a?(DateTime) != false || raise("Passed value for field obj.due_date is not the expected type, validation failed.")
         obj.status&.is_a?(Merge::Ticketing::TicketStatusEnum) != false || raise("Passed value for field obj.status is not the expected type, validation failed.")
@@ -326,6 +355,7 @@ module Merge
         obj.parent_ticket.nil? || Merge::Ticketing::TicketParentTicket.validate_raw(obj: obj.parent_ticket)
         obj.attachments&.is_a?(Array) != false || raise("Passed value for field obj.attachments is not the expected type, validation failed.")
         obj.tags&.is_a?(Array) != false || raise("Passed value for field obj.tags is not the expected type, validation failed.")
+        obj.roles&.is_a?(Array) != false || raise("Passed value for field obj.roles is not the expected type, validation failed.")
         obj.remote_created_at&.is_a?(DateTime) != false || raise("Passed value for field obj.remote_created_at is not the expected type, validation failed.")
         obj.remote_updated_at&.is_a?(DateTime) != false || raise("Passed value for field obj.remote_updated_at is not the expected type, validation failed.")
         obj.completed_at&.is_a?(DateTime) != false || raise("Passed value for field obj.completed_at is not the expected type, validation failed.")

data/lib/merge_ruby_client/ticketing/types/ticket_assigned_teams_item.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "team"
+
+module Merge
+  module Ticketing
+    class TicketAssignedTeamsItem
+      # Deserialize a JSON object to an instance of TicketAssignedTeamsItem
+      #
+      # @param json_object [String]
+      # @return [Merge::Ticketing::TicketAssignedTeamsItem]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        begin
+          struct.is_a?(String) != false || raise("Passed value for field struct is not the expected type, validation failed.")
+          return struct unless struct.nil?
+
+          return nil
+        rescue StandardError
+          # noop
+        end
+        begin
+          Merge::Ticketing::Team.validate_raw(obj: struct)
+          return Merge::Ticketing::Team.from_json(json_object: struct) unless struct.nil?
+
+          return nil
+        rescue StandardError
+          # noop
+        end
+        struct
+      end
+
+      # Leveraged for Union-type generation, validate_raw attempts to parse the given
+      #  hash and check each fields type against the current object's property
+      #  definitions.
+      #
+      # @param obj [Object]
+      # @return [Void]
+      def self.validate_raw(obj:)
+        begin
+          return obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+        rescue StandardError
+          # noop
+        end
+        begin
+          return Merge::Ticketing::Team.validate_raw(obj: obj)
+        rescue StandardError
+          # noop
+        end
+        raise("Passed value matched no type within the union, validation failed.")
+      end
+    end
+  end
+end

data/lib/merge_ruby_client/ticketing/types/ticket_request.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "ticket_request_assignees_item"
+require_relative "ticket_request_assigned_teams_item"
 require_relative "ticket_request_creator"
 require "date"
 require_relative "ticket_status_enum"
@@ -18,14 +19,18 @@ module Merge
   module Ticketing
     # # The Ticket Object
     #  ### Description
-    #  The `Ticket` object is used to represent a ticket or a task within a system.
+    #  The `Ticket` object is used to represent a ticket, issue, task or case.
     #  ### Usage Example
     #  TODO
     class TicketRequest
       # @return [String] The ticket's name.
       attr_reader :name
-      # @return [Array<Merge::Ticketing::TicketRequestAssigneesItem>]
+      # @return [Array<Merge::Ticketing::TicketRequestAssigneesItem>] The individual `Users` who are assigned to this ticket. This does not include
+      #  `Users` who just have view access to this ticket.
       attr_reader :assignees
+      # @return [Array<Merge::Ticketing::TicketRequestAssignedTeamsItem>] The `Teams` that are assigned to this ticket. This does not include `Teams` who
+      #  just have view access to this ticket.
+      attr_reader :assigned_teams
       # @return [Merge::Ticketing::TicketRequestCreator] The user who created this ticket.
       attr_reader :creator
       # @return [DateTime] The ticket's due date.
@@ -39,7 +44,7 @@ module Merge
       # @return [String] The ticket’s description. HTML version of description is mapped if supported by
       #  the third-party platform.
       attr_reader :description
-      # @return [Array<Merge::Ticketing::TicketRequestCollectionsItem>]
+      # @return [Array<Merge::Ticketing::TicketRequestCollectionsItem>] The `Collections` that this `Ticket` is included in.
       attr_reader :collections
       # @return [String] The sub category of the ticket within the 3rd party system. Examples include
       #  incident, task, subtask or to-do.
@@ -54,6 +59,8 @@ module Merge
       attr_reader :attachments
       # @return [Array<String>]
       attr_reader :tags
+      # @return [Array<String>]
+      attr_reader :roles
       # @return [DateTime] When the ticket was completed.
       attr_reader :completed_at
       # @return [String] The 3rd party url of the Ticket.
@@ -79,7 +86,10 @@ module Merge
       OMIT = Object.new
 
       # @param name [String] The ticket's name.
-      # @param assignees [Array<Merge::Ticketing::TicketRequestAssigneesItem>]
+      # @param assignees [Array<Merge::Ticketing::TicketRequestAssigneesItem>] The individual `Users` who are assigned to this ticket. This does not include
+      #  `Users` who just have view access to this ticket.
+      # @param assigned_teams [Array<Merge::Ticketing::TicketRequestAssignedTeamsItem>] The `Teams` that are assigned to this ticket. This does not include `Teams` who
+      #  just have view access to this ticket.
       # @param creator [Merge::Ticketing::TicketRequestCreator] The user who created this ticket.
       # @param due_date [DateTime] The ticket's due date.
       # @param status [Merge::Ticketing::TicketStatusEnum] The current status of the ticket.
@@ -89,7 +99,7 @@ module Merge
       #  - `ON_HOLD` - ON_HOLD
       # @param description [String] The ticket’s description. HTML version of description is mapped if supported by
       #  the third-party platform.
-      # @param collections [Array<Merge::Ticketing::TicketRequestCollectionsItem>]
+      # @param collections [Array<Merge::Ticketing::TicketRequestCollectionsItem>] The `Collections` that this `Ticket` is included in.
       # @param ticket_type [String] The sub category of the ticket within the 3rd party system. Examples include
       #  incident, task, subtask or to-do.
       # @param account [Merge::Ticketing::TicketRequestAccount] The account associated with the ticket.
@@ -97,6 +107,7 @@ module Merge
       # @param parent_ticket [Merge::Ticketing::TicketRequestParentTicket] The ticket's parent ticket.
       # @param attachments [Array<Merge::Ticketing::TicketRequestAttachmentsItem>]
       # @param tags [Array<String>]
+      # @param roles [Array<String>]
       # @param completed_at [DateTime] When the ticket was completed.
       # @param ticket_url [String] The 3rd party url of the Ticket.
       # @param priority [Merge::Ticketing::PriorityEnum] The priority or urgency of the Ticket.
@@ -109,10 +120,11 @@ module Merge
       # @param remote_fields [Array<Merge::Ticketing::RemoteFieldRequest>]
       # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
       # @return [Merge::Ticketing::TicketRequest]
-      def initialize(name: OMIT, assignees: OMIT, creator: OMIT, due_date: OMIT, status: OMIT, description: OMIT,
-                     collections: OMIT, ticket_type: OMIT, account: OMIT, contact: OMIT, parent_ticket: OMIT, attachments: OMIT, tags: OMIT, completed_at: OMIT, ticket_url: OMIT, priority: OMIT, integration_params: OMIT, linked_account_params: OMIT, remote_fields: OMIT, additional_properties: nil)
+      def initialize(name: OMIT, assignees: OMIT, assigned_teams: OMIT, creator: OMIT, due_date: OMIT, status: OMIT,
+                     description: OMIT, collections: OMIT, ticket_type: OMIT, account: OMIT, contact: OMIT, parent_ticket: OMIT, attachments: OMIT, tags: OMIT, roles: OMIT, completed_at: OMIT, ticket_url: OMIT, priority: OMIT, integration_params: OMIT, linked_account_params: OMIT, remote_fields: OMIT, additional_properties: nil)
         @name = name if name != OMIT
         @assignees = assignees if assignees != OMIT
+        @assigned_teams = assigned_teams if assigned_teams != OMIT
         @creator = creator if creator != OMIT
         @due_date = due_date if due_date != OMIT
         @status = status if status != OMIT
@@ -124,6 +136,7 @@ module Merge
         @parent_ticket = parent_ticket if parent_ticket != OMIT
         @attachments = attachments if attachments != OMIT
         @tags = tags if tags != OMIT
+        @roles = roles if roles != OMIT
         @completed_at = completed_at if completed_at != OMIT
         @ticket_url = ticket_url if ticket_url != OMIT
         @priority = priority if priority != OMIT
@@ -134,6 +147,7 @@ module Merge
         @_field_set = {
           "name": name,
           "assignees": assignees,
+          "assigned_teams": assigned_teams,
           "creator": creator,
           "due_date": due_date,
           "status": status,
@@ -145,6 +159,7 @@ module Merge
           "parent_ticket": parent_ticket,
           "attachments": attachments,
           "tags": tags,
+          "roles": roles,
           "completed_at": completed_at,
           "ticket_url": ticket_url,
           "priority": priority,
@@ -168,6 +183,10 @@ module Merge
           item = item.to_json
           Merge::Ticketing::TicketRequestAssigneesItem.from_json(json_object: item)
         end
+        assigned_teams = parsed_json["assigned_teams"]&.map do |item|
+          item = item.to_json
+          Merge::Ticketing::TicketRequestAssignedTeamsItem.from_json(json_object: item)
+        end
         if parsed_json["creator"].nil?
           creator = nil
         else
@@ -205,6 +224,7 @@ module Merge
           Merge::Ticketing::TicketRequestAttachmentsItem.from_json(json_object: item)
         end
         tags = parsed_json["tags"]
+        roles = parsed_json["roles"]
         completed_at = (DateTime.parse(parsed_json["completed_at"]) unless parsed_json["completed_at"].nil?)
         ticket_url = parsed_json["ticket_url"]
         priority = parsed_json["priority"]
@@ -217,6 +237,7 @@ module Merge
         new(
           name: name,
           assignees: assignees,
+          assigned_teams: assigned_teams,
           creator: creator,
           due_date: due_date,
           status: status,
@@ -228,6 +249,7 @@ module Merge
           parent_ticket: parent_ticket,
           attachments: attachments,
           tags: tags,
+          roles: roles,
           completed_at: completed_at,
           ticket_url: ticket_url,
           priority: priority,
@@ -254,6 +276,7 @@ module Merge
       def self.validate_raw(obj:)
         obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
         obj.assignees&.is_a?(Array) != false || raise("Passed value for field obj.assignees is not the expected type, validation failed.")
+        obj.assigned_teams&.is_a?(Array) != false || raise("Passed value for field obj.assigned_teams is not the expected type, validation failed.")
         obj.creator.nil? || Merge::Ticketing::TicketRequestCreator.validate_raw(obj: obj.creator)
         obj.due_date&.is_a?(DateTime) != false || raise("Passed value for field obj.due_date is not the expected type, validation failed.")
         obj.status&.is_a?(Merge::Ticketing::TicketStatusEnum) != false || raise("Passed value for field obj.status is not the expected type, validation failed.")
@@ -265,6 +288,7 @@ module Merge
         obj.parent_ticket.nil? || Merge::Ticketing::TicketRequestParentTicket.validate_raw(obj: obj.parent_ticket)
         obj.attachments&.is_a?(Array) != false || raise("Passed value for field obj.attachments is not the expected type, validation failed.")
         obj.tags&.is_a?(Array) != false || raise("Passed value for field obj.tags is not the expected type, validation failed.")
+        obj.roles&.is_a?(Array) != false || raise("Passed value for field obj.roles is not the expected type, validation failed.")
         obj.completed_at&.is_a?(DateTime) != false || raise("Passed value for field obj.completed_at is not the expected type, validation failed.")
         obj.ticket_url&.is_a?(String) != false || raise("Passed value for field obj.ticket_url is not the expected type, validation failed.")
         obj.priority&.is_a?(Merge::Ticketing::PriorityEnum) != false || raise("Passed value for field obj.priority is not the expected type, validation failed.")

data/lib/merge_ruby_client/ticketing/types/ticket_request_assigned_teams_item.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "team"
+
+module Merge
+  module Ticketing
+    class TicketRequestAssignedTeamsItem
+      # Deserialize a JSON object to an instance of TicketRequestAssignedTeamsItem
+      #
+      # @param json_object [String]
+      # @return [Merge::Ticketing::TicketRequestAssignedTeamsItem]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        begin
+          struct.is_a?(String) != false || raise("Passed value for field struct is not the expected type, validation failed.")
+          return struct unless struct.nil?
+
+          return nil
+        rescue StandardError
+          # noop
+        end
+        begin
+          Merge::Ticketing::Team.validate_raw(obj: struct)
+          return Merge::Ticketing::Team.from_json(json_object: struct) unless struct.nil?
+
+          return nil
+        rescue StandardError
+          # noop
+        end
+        struct
+      end
+
+      # Leveraged for Union-type generation, validate_raw attempts to parse the given
+      #  hash and check each fields type against the current object's property
+      #  definitions.
+      #
+      # @param obj [Object]
+      # @return [Void]
+      def self.validate_raw(obj:)
+        begin
+          return obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+        rescue StandardError
+          # noop
+        end
+        begin
+          return Merge::Ticketing::Team.validate_raw(obj: obj)
+        rescue StandardError
+          # noop
+        end
+        raise("Passed value matched no type within the union, validation failed.")
+      end
+    end
+  end
+end