merge_ruby_client 0.1.4 → 1.1.0

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,22 +34,30 @@ 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. To fetch all `Users` and
+      #  `Teams` that can access the ticket, use the `GET /tickets/{ticket_id}/viewers`
+      #  [endpoint](https://docs.merge.dev/ticketing/tickets/#tickets_viewers_list).
       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. To fetch all `Users` and `Teams` that can
+      #  access this ticket, use the `GET /tickets/{ticket_id}/viewers`
+      #  [endpoint](https://docs.merge.dev/ticketing/tickets/#tickets_viewers_list).
+      attr_reader :assigned_teams
       # @return [Merge::Ticketing::TicketCreator] The user who created this ticket.
       attr_reader :creator
       # @return [DateTime] The ticket's due date.
       attr_reader :due_date
       # @return [Merge::Ticketing::TicketStatusEnum] The current status of the ticket.
-      #  - `OPEN` - OPEN
-      #  - `CLOSED` - CLOSED
-      #  - `IN_PROGRESS` - IN_PROGRESS
-      #  - `ON_HOLD` - ON_HOLD
+      #  * `OPEN` - OPEN
+      #  * `CLOSED` - CLOSED
+      #  * `IN_PROGRESS` - IN_PROGRESS
+      #  * `ON_HOLD` - ON_HOLD
       attr_reader :status
       # @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,21 +72,26 @@ 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
       # @return [Merge::Ticketing::PriorityEnum] The priority or urgency of the Ticket.
-      #  - `URGENT` - URGENT
-      #  - `HIGH` - HIGH
-      #  - `NORMAL` - NORMAL
-      #  - `LOW` - LOW
+      #  * `URGENT` - URGENT
+      #  * `HIGH` - HIGH
+      #  * `NORMAL` - NORMAL
+      #  * `LOW` - LOW
       attr_reader :priority
       # @return [Hash{String => Object}]
       attr_reader :field_mappings
@@ -98,17 +112,24 @@ 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. To fetch all `Users` and
+      #  `Teams` that can access the ticket, use the `GET /tickets/{ticket_id}/viewers`
+      #  [endpoint](https://docs.merge.dev/ticketing/tickets/#tickets_viewers_list).
+      # @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. To fetch all `Users` and `Teams` that can
+      #  access this ticket, use the `GET /tickets/{ticket_id}/viewers`
+      #  [endpoint](https://docs.merge.dev/ticketing/tickets/#tickets_viewers_list).
       # @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.
-      #  - `OPEN` - OPEN
-      #  - `CLOSED` - CLOSED
-      #  - `IN_PROGRESS` - IN_PROGRESS
-      #  - `ON_HOLD` - ON_HOLD
+      #  * `OPEN` - OPEN
+      #  * `CLOSED` - CLOSED
+      #  * `IN_PROGRESS` - IN_PROGRESS
+      #  * `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,29 +137,34 @@ 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
-      #  - `HIGH` - HIGH
-      #  - `NORMAL` - NORMAL
-      #  - `LOW` - LOW
+      #  * `URGENT` - URGENT
+      #  * `HIGH` - HIGH
+      #  * `NORMAL` - NORMAL
+      #  * `LOW` - LOW
       # @param field_mappings [Hash{String => Object}]
       # @param remote_data [Array<Merge::Ticketing::RemoteData>]
       # @param remote_fields [Array<Merge::Ticketing::RemoteField>]
       # @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 +176,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 +194,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 +206,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 +237,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 +278,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 +305,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 +317,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 +351,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 +363,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_access_enum.rb

@@ -2,9 +2,9 @@
 
 module Merge
   module Ticketing
-    # - `ALL` - ALL
-    #  - `ASSIGNED_ONLY` - ASSIGNED_ONLY
-    #  - `TEAM_ONLY` - TEAM_ONLY
+    # * `ALL` - ALL
+    #  * `ASSIGNED_ONLY` - ASSIGNED_ONLY
+    #  * `TEAM_ONLY` - TEAM_ONLY
     class TicketAccessEnum
       ALL = "ALL"
       ASSIGNED_ONLY = "ASSIGNED_ONLY"

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

@@ -2,12 +2,12 @@
 
 module Merge
   module Ticketing
-    # - `VIEW` - VIEW
-    #  - `CREATE` - CREATE
-    #  - `EDIT` - EDIT
-    #  - `DELETE` - DELETE
-    #  - `CLOSE` - CLOSE
-    #  - `ASSIGN` - ASSIGN
+    # * `VIEW` - VIEW
+    #  * `CREATE` - CREATE
+    #  * `EDIT` - EDIT
+    #  * `DELETE` - DELETE
+    #  * `CLOSE` - CLOSE
+    #  * `ASSIGN` - ASSIGN
     class TicketActionsEnum
       VIEW = "VIEW"
       CREATE = "CREATE"

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,28 +19,36 @@ 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. To fetch all `Users` and
+      #  `Teams` that can access the ticket, use the `GET /tickets/{ticket_id}/viewers`
+      #  [endpoint](https://docs.merge.dev/ticketing/tickets/#tickets_viewers_list).
       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. To fetch all `Users` and `Teams` that can
+      #  access this ticket, use the `GET /tickets/{ticket_id}/viewers`
+      #  [endpoint](https://docs.merge.dev/ticketing/tickets/#tickets_viewers_list).
+      attr_reader :assigned_teams
       # @return [Merge::Ticketing::TicketRequestCreator] The user who created this ticket.
       attr_reader :creator
       # @return [DateTime] The ticket's due date.
       attr_reader :due_date
       # @return [Merge::Ticketing::TicketStatusEnum] The current status of the ticket.
-      #  - `OPEN` - OPEN
-      #  - `CLOSED` - CLOSED
-      #  - `IN_PROGRESS` - IN_PROGRESS
-      #  - `ON_HOLD` - ON_HOLD
+      #  * `OPEN` - OPEN
+      #  * `CLOSED` - CLOSED
+      #  * `IN_PROGRESS` - IN_PROGRESS
+      #  * `ON_HOLD` - ON_HOLD
       attr_reader :status
       # @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,15 +63,17 @@ 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.
       attr_reader :ticket_url
       # @return [Merge::Ticketing::PriorityEnum] The priority or urgency of the Ticket.
-      #  - `URGENT` - URGENT
-      #  - `HIGH` - HIGH
-      #  - `NORMAL` - NORMAL
-      #  - `LOW` - LOW
+      #  * `URGENT` - URGENT
+      #  * `HIGH` - HIGH
+      #  * `NORMAL` - NORMAL
+      #  * `LOW` - LOW
       attr_reader :priority
       # @return [Hash{String => Object}]
       attr_reader :integration_params
@@ -79,17 +90,24 @@ 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. To fetch all `Users` and
+      #  `Teams` that can access the ticket, use the `GET /tickets/{ticket_id}/viewers`
+      #  [endpoint](https://docs.merge.dev/ticketing/tickets/#tickets_viewers_list).
+      # @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. To fetch all `Users` and `Teams` that can
+      #  access this ticket, use the `GET /tickets/{ticket_id}/viewers`
+      #  [endpoint](https://docs.merge.dev/ticketing/tickets/#tickets_viewers_list).
       # @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.
-      #  - `OPEN` - OPEN
-      #  - `CLOSED` - CLOSED
-      #  - `IN_PROGRESS` - IN_PROGRESS
-      #  - `ON_HOLD` - ON_HOLD
+      #  * `OPEN` - OPEN
+      #  * `CLOSED` - CLOSED
+      #  * `IN_PROGRESS` - IN_PROGRESS
+      #  * `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,22 +115,24 @@ 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.
-      #  - `URGENT` - URGENT
-      #  - `HIGH` - HIGH
-      #  - `NORMAL` - NORMAL
-      #  - `LOW` - LOW
+      #  * `URGENT` - URGENT
+      #  * `HIGH` - HIGH
+      #  * `NORMAL` - NORMAL
+      #  * `LOW` - LOW
       # @param integration_params [Hash{String => Object}]
       # @param linked_account_params [Hash{String => Object}]
       # @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 +144,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 +155,7 @@ module Merge
         @_field_set = {
           "name": name,
           "assignees": assignees,
+          "assigned_teams": assigned_teams,
           "creator": creator,
           "due_date": due_date,
           "status": status,
@@ -145,6 +167,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 +191,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 +232,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 +245,7 @@ module Merge
         new(
           name: name,
           assignees: assignees,
+          assigned_teams: assigned_teams,
           creator: creator,
           due_date: due_date,
           status: status,
@@ -228,6 +257,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 +284,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 +296,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

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

@@ -2,10 +2,10 @@
 
 module Merge
   module Ticketing
-    # - `OPEN` - OPEN
-    #  - `CLOSED` - CLOSED
-    #  - `IN_PROGRESS` - IN_PROGRESS
-    #  - `ON_HOLD` - ON_HOLD
+    # * `OPEN` - OPEN
+    #  * `CLOSED` - CLOSED
+    #  * `IN_PROGRESS` - IN_PROGRESS
+    #  * `ON_HOLD` - ON_HOLD
     class TicketStatusEnum
       OPEN = "OPEN"
       CLOSED = "CLOSED"

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

@@ -11,7 +11,10 @@ module Merge
   module Ticketing
     # # The User Object
     #  ### Description
-    #  The `User` object is used to represent an employee within a company.
+    #  The `User` object is used to represent a user with a login to the ticketing
+    #  system.
+    #  Users are either assignees who are directly responsible or a viewer on a
+    #  `Ticket`/ `Collection`.
     #  ### Usage Example
     #  TODO
     class User
@@ -36,7 +39,9 @@ module Merge
       # @return [String] The user's avatar picture.
       attr_reader :avatar
       # @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 +66,9 @@ module Merge
       # @param roles [Array<Merge::Ticketing::UserRolesItem>]
       # @param avatar [String] The user's avatar picture.
       # @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