gitlab_support_readiness 1.0.0

data/lib/support_readiness/zendesk/users.rb

@@ -0,0 +1,946 @@
+# frozen_string_literal: true
+
+# Defines the module Readiness.
+module Readiness
+  # Defines the module Zendesk
+  module Zendesk
+    ##
+    # Defines the class Users within the module {Readiness::Zendesk}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.0
+    # @todo Merge users
+    class Users < Readiness::Client
+      attr_accessor :active, :alias, :custom_role_id, :default_group_id, :details, :email, :external_id, :iana_time_zone, :id, :last_login_at, :locale, :locale_id, :moderator, :name, :notes, :only_private_comments, :organization_id, :phone, :report_csv, :restricted_agent, :role, :role_type, :shared, :shared_agent, :shared_phone_number, :signature, :suspended, :tags, :ticket_restriction, :time_zone, :two_factor_auth_enabled, :user_fields, :verified
+
+      ##
+      # Creates a new {Readiness::Zendesk::Users} instance
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param object [Object] An instance of {Readiness::Zendesk::Users}
+      # @example
+      #   require 'support_readiness'
+      #   Readiness::Zendesk::Users.new
+      def initialize(object = {})
+        @active = object['active']
+        @alias = object['alias']
+        @custom_role_id = object['custom_role_id']
+        @default_group_id = object['default_group_id']
+        @details = object['details']
+        @email = object['email']
+        @external_id = object['external_id']
+        @iana_time_zone = object['iana_time_zone']
+        @id = object['id']
+        @last_login_at = object['last_login_at']
+        @locale = object['locale']
+        @locale_id = object['locale_id']
+        @moderator = object['moderator']
+        @name = object['name']
+        @notes = object['notes']
+        @only_private_comments = object['only_private_comments']
+        @organization_id = object['organization_id']
+        @phone = object['phone']
+        @report_csv = object['report_csv']
+        @restricted_agent = object['restricted_agent']
+        @role = object['role']
+        @role_type = object['role_type']
+        @shared = object['shared']
+        @shared_agent = object['shared_agent']
+        @shared_phone_number = object['shared_phone_number']
+        @signature = object['signature']
+        @suspended = object['suspended']
+        @tags = object['tags']
+        @ticket_restriction = object['ticket_restriction']
+        @time_zone = object['time_zone']
+        @two_factor_auth_enabled = object['two_factor_auth_enabled']
+        @user_fields = object['user_fields']
+        @verified = object['verified']
+      end
+
+      ##
+      # Lists the first 100 users
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param permission_set [Integer] The custom_role_id to use in the listing. Set to false to show all.
+      # @param roles [Array] The roles to use in the listing. Leave blank to show all.
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#list-users Zendesk API > Users > List Users
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   users = Readiness::Zendesk::Users.list(client)
+      #   pp users.first.name
+      #   # => "Johnny Agent"
+      def self.list(client, permission_set = false, roles = [])
+        opts = ''
+        opts += "&permission_set=#{permission_set}" if permission_set
+        opts += roles.map { |r| "&role[]=#{r}" }.join('') unless roles.count.zero?
+        response = client.connection.get("users?page[size]=100&#{opts}")
+        handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+        Oj.load(response.body)['users'].map { |u| Users.new(u) }
+      end
+
+      ##
+      # Lists many users. Does not stop until it ends or the page limit is hit.
+      # This method can take a long time to run depending on the parameters used.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param limit [Integer] The number of pages to stop at. Using 0 means to list all.
+      # @param permission_set [Integer] The custom_role_id to use in the listing. Set to false to show all.
+      # @param roles [Array] The roles to use in the listing. Leave blank to show all.
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#list-users Zendesk API > Users > List Users
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   users = Readiness::Zendesk::Users.list_many(client, 15)
+      #   pp users.count
+      #   # => 1500
+      def self.list_many(client, limit = 0, permission_set = false, roles = [])
+        array = []
+        opts = "page[size]=100"
+        opts += "&permission_set=#{permission_set}" if permission_set
+        opts += roles.map { |r| "&role[]=#{r}" }.join('') unless roles.count.zero?
+        loop do
+          response = client.connection.get("users?#{opts}")
+          handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+          body = Oj.load(response.body)
+          array += body['users'].map { |u| Users.new(u) }
+          break if limit != 0 && array.count >= (limit * 100)
+          break unless body['meta']['has_more']
+
+          opts = body['links'] ['next'].split('?').last
+        end
+        array
+      end
+
+      ##
+      # Show information on the approximate count of users.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param permission_set [Integer] The custom_role_id to use in the listing. Set to false to show all.
+      # @param roles [Array] The roles to use in the listing. Leave blank to show all.
+      # @return [Hash]
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#count-users Zendesk API > Users > Count Users
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   count = Readiness::Zendesk::Users.count(client)
+      #   pp count['value']
+      #   # => 102
+      def self.count(client, permission_set = false, roles = [])
+        opts = ''
+        opts += "&permission_set=#{permission_set}" if permission_set
+        opts += roles.map { |r| "&role[]=#{r}" }.join('') unless roles.count.zero?
+        response = client.connection.get("users/count?#{opts}")
+        handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+        Oj.load(response.body)['count']
+      end
+
+      ##
+      # Locates an user within Zendesk. This will not exit on error (except Authentication errors)
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param uid [Integer] The user ID to find
+      # @return [Object] An instance of {Readiness::Zendesk::Users}
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#show-user Zendesk API > Users > Show User
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find(client, 35436)
+      #   pp email.email
+      #   # => "johny_agent@example.com"
+      def self.find(client, uid)
+        response = client.connection.get("users/#{uid}")
+        handle_request_error(0, 'Zendesk', response.status,  { action: 'get', id: uid }) unless response.status == 200
+        return Users.new(Oj.load(response.body)['user']) if response.status == 200
+
+        Oj.load(response.body)
+      end
+
+      ##
+      # Locates an user within Zendesk. This will exit on error
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param uid [Integer] The user ID to find
+      # @return [Object] An instance of {Readiness::Zendesk::Users}
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#show-user Zendesk API > Users > Show User
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 35436)
+      #   pp email.email
+      #   # => "johny_agent@example.com"
+      def self.find!(client, uid)
+        response = client.connection.get("users/#{uid}")
+        handle_request_error(1, 'Zendesk', response.status, { action: 'Find user', id: uid }) unless response.status == 200
+        Users.new(Oj.load(response.body)['user'])
+      end
+
+      ##
+      # Locates up to 100 users within Zendesk.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param uids [Array] The user IDs to find
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/organizations/organizations/#show-many-organizations Zendesk API > Organizations > Show Many Organizations
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   users = Readiness::Zendesk::Users.find!(client, [35436, 35436])
+      #   pp users.count
+      #   # => 2
+      def self.find_many(client, uids)
+        response = client.connection.get("users/show_many?ids=#{uids.join(',')}")
+        handle_request_error(0, 'Zendesk', response.status,  { action: 'get', id: uids }) unless response.status == 200
+        Oj.load(response.body)['users'].map { |o| Users.new(o) }
+      end
+
+      ##
+      # Creates an user. Will exit if unsuccessful
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @return [Object] An instance of {Readiness::Zendesk::Users}
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#create-user Zendesk API > Users > Create User
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.new
+      #   user.custom_role_id = 123456
+      #   user.email = 'roge@example.org'
+      #   user.name = 'Roger Wilco'
+      #   user.organization_id = 57542
+      #   user.role = 'agent'
+      #   user.role_type = 0
+      #   create = Readiness::Zendesk::Users.create!(client, user)
+      #   pp create.id
+      #   # => 9873843
+      def self.create!(client, user)
+        response = client.connection.post 'users', to_clean_json_with_key(user, 'user')
+        handle_request_error(1, 'Zendesk', response.status, { action: 'Create user', message: Oj.load(response.body)}) unless response.status == 201
+        Users.new(Oj.load(response.body)['user'])
+      end
+
+      ##
+      # Creates or updates an user. Will exit if unsuccessful
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @return [Object] An instance of {Readiness::Zendesk::Users}
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#create-or-update-user Zendesk API > Users > Create Or Update User
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.new
+      #   user.custom_role_id = 123456
+      #   user.email = 'roge@example.org'
+      #   user.name = 'Roger Wilco'
+      #   user.organization_id = 57542
+      #   user.role = 'agent'
+      #   user.role_type = 0
+      #   create = Readiness::Zendesk::Users.create_or_update!(client, user)
+      #   pp create.id
+      #   # => 9873843
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 9873843)
+      #   user.name = 'Roger Wilco II'
+      #   create = Readiness::Zendesk::Users.create_or_update!(client, user)
+      #   pp create.name
+      #   # => "Roger Wilco II"
+      def self.create_or_update!(client, user)
+        response = client.connection.post 'users/create_or_update', to_clean_json_with_key(user, 'user')
+        handle_request_error(1, 'Zendesk', response.status, { action: 'Create or update user', id: user.email, message: Oj.load(response.body)}) unless [200, 201].include?(response.status)
+        Users.new(Oj.load(response.body)['user'])
+      end
+
+      ##
+      # Updates an user. Will exit if unsuccessful
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @return [Object] An instance of {Readiness::Zendesk::Organizations}
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#update-user Zendesk API > Users > Update User
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 9873843)
+      #   user.name = 'Roger Wilco II'
+      #   update = Readiness::Zendesk::Users.update!(client, user)
+      #   pp update.name
+      #   # => "Roger Wilco II"
+      def self.update!(client, user)
+        response = client.connection.put "users/#{user.id}", to_clean_json_with_key(user, 'user')
+        handle_request_error(1, 'Zendesk', response.status, { action: 'Update user', id: user.id, message: Oj.load(response.body)}) unless response.status == 200
+        Users.new(Oj.load(response.body)['user'])
+      end
+
+      ##
+      # Deletes an user. Will exit if unsuccessful
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @return [Boolean]
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#delete-user Zendesk API > Users > Delete User
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 9873843)
+      #   delete = Readiness::Zendesk::Users.delete!(client, user)
+      #   pp delete
+      #   # => true
+      def self.delete!(client, user)
+        response = client.connection.delete "users/#{user.id}"
+        handle_request_error(1, 'Zendesk', response.status, { action: 'Delete an user', id: user.id, message: Oj.load(response.body)}) unless response.status == 204
+        true
+      end
+
+      ##
+      # Deletes a deleted user. This will exit if unsuccessful
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param uid [Integer] The deleted user's ID
+      # @return [Hash]
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#permanently-delete-user Zendesk API > Users > Permanently Delete User
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   delete = Readiness::Zendesk::Users.delete_permanently!(client, 9873843)
+      #   pp delete.id
+      #   # => 189304711533
+      def self.delete_permanently!(client, uid)
+        response = client.connection.delete "deleted_users/#{uid}"
+        handle_request_error(1, 'Zendesk', response.status) unless response.status == 200
+        Oj.load(response.body['deleted_user'])
+      end
+
+      ##
+      # Lists the first 100 deleted users
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#list-deleted-users Zendesk API > Users > List Deleted Users
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   deletes = Readiness::Zendesk::Users.list_deleted(client)
+      #   pp deletes.first.id
+      #   # => 189304711533
+      def self.list_deleted(client)
+        response = client.connection.get("deleted_users?page[size]=100")
+        handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+        Oj.load(response.body)['deleted_users']
+      end
+
+      ##
+      # Lists many deleted users. Does not stop until it ends or the page limit is hit.
+      # This method can take a long time to run depending on the parameters used.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param limit [Integer] The number of pages to stop at. Using 0 means to list all.
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#list-deleted-users Zendesk API > Users > List Deleted Users
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   deletes = Readiness::Zendesk::Users.list_many_deleted(client, 7)
+      #   pp deletes.count
+      #   # => 700
+      def self.list_many_deleted(client, limit = 0, permission_set = false)
+        array = []
+        opts = "page[size]=100"
+        loop do
+          response = client.connection.get("deleted_users?#{opts}")
+          handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+          body = Oj.load(response.body)
+          array += body['deleted_users']
+          break if limit != 0 && array.count >= (limit * 100)
+          break unless body['meta']['has_more']
+
+          opts = body['links'] ['next'].split('?').last
+        end
+        array
+      end
+
+      ##
+      # Show information on the approximate count of deleted users.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @return [Hash]
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#count-deleted-users Zendesk API > Users > Count Deleted Users
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   deletes = Readiness::Zendesk::Users.deleted_count(client)
+      #   pp deletes['value']
+      #   # => 13
+      def self.deleted_count(client)
+        response = client.connection.get("deleted_users/count?#{opts}")
+        handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+        Oj.load(response.body)['count']
+      end
+
+      ##
+      # Show information on a deleted user
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param did [Integer] The deleted user's ID
+      # @return [Hash]
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#show-deleted-user Zendesk API > Users > Show Deleted User
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   deleted = Readiness::Zendesk::Users.find_deleted!(client, 189304711533)
+      #   pp deleted['name']
+      #   # => "David"
+      def self.find_deleted!(client, did)
+        response = client.connection.get("deleted_users/#{did}")
+        handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+        Oj.load(response.body)['deleted_user']
+      end
+
+      ##
+      # Force logs out users
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param uids [Array] An array of user IDs
+      # @return [Hash]
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#logout-many-users Zendesk API > Users > Logout many users
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   log_out = Readiness::Zendesk::Users.logout_many(client, [1, 2])
+      #   pp log_out
+      #   # => true
+      def self.logout_many(client, uids)
+        response = client.connection.get("users/logout_many?ids=#{uids.join(',')}")
+        handle_request_error(0, 'Zendesk', response.status) unless response.status == 202
+        true
+      end
+
+      ##
+      # Lists all tickets involving an user (requested, cc'd, assigned).
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/tickets/tickets/#list-tickets Zendesk API > Tickets > List Tickets
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 123456)
+      #   tickets = Readiness::Zendesk::Users.all_tickets(client, user)
+      #   pp tickets.count
+      #   # => 18
+      def self.all_tickets(client, user)
+        (tickets(client, user) + ccd_tickets(client, user) + assigned_tickets(client, user)).uniq { |t| t.id }.sort_by { |t| t.id }
+      end
+
+      ##
+      # Lists requests for an user.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/tickets/tickets/#list-tickets Zendesk API > Tickets > List Tickets
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 123456)
+      #   tickets = Readiness::Zendesk::Users.tickets(client, user)
+      #   pp tickets.count
+      #   # => 10
+      def self.tickets(client, user)
+        array = []
+        opts = "page[size]=100"
+        loop do
+          response = client.connection.get("users/#{user.id}/tickets/requested?#{opts}")
+          handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+          body = Oj.load(response.body)
+          array += body['tickets'].map { |t| Tickets.new(t) }
+          break unless body['meta']['has_more']
+
+          opts = body['links'] ['next'].split('?').last
+        end
+        array
+      end
+
+      ##
+      # Lists tickets that a user is CC'd on.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/tickets/tickets/#list-tickets Zendesk API > Tickets > List Tickets
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 123456)
+      #   tickets = Readiness::Zendesk::Users.ccd_tickets(client, user)
+      #   pp tickets.count
+      #   # => 6
+      def self.ccd_tickets(client, user)
+        array = []
+        opts = "page[size]=100"
+        loop do
+          response = client.connection.get("users/#{user.id}/tickets/ccd?#{opts}")
+          handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+          body = Oj.load(response.body)
+          array += body['tickets'].map { |t| Tickets.new(t) }
+          break unless body['meta']['has_more']
+
+          opts = body['links'] ['next'].split('?').last
+        end
+        array
+      end
+
+      ##
+      # Lists tickets that a user is assigned.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/tickets/tickets/#list-tickets Zendesk API > Tickets > List Tickets
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 123456)
+      #   tickets = Readiness::Zendesk::Users.assigned_tickets(client, user)
+      #   pp tickets.count
+      #   # => 2
+      def self.assigned_tickets(client, user)
+        array = []
+        opts = "page[size]=100"
+        loop do
+          response = client.connection.get("users/#{user.id}/tickets/assigned?#{opts}")
+          handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+          body = Oj.load(response.body)
+          array += body['tickets'].map { |t| Tickets.new(t) }
+          break unless body['meta']['has_more']
+
+          opts = body['links'] ['next'].split('?').last
+        end
+        array
+      end
+
+      ##
+      # Lists organization a user is part of.
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @return [Object] An instance of {Readiness::Zendesk::Organizations}
+      # @see https://developer.zendesk.com/api-reference/ticketing/organizations/organizations/#show-organization Zendesk API > Organizations > Show Organization
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 123456)
+      #   organization = Readiness::Zendesk::Users.organization(client, user)
+      #   pp organization.name
+      #   # => "Groablet Enterprises"
+      def self.organization(client, user)
+        return nil if user.organization_id.nil?
+
+        Organizations.find(client, user.organization_id)
+      end
+
+      ##
+      # Creates multiple users via a batch job
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param users [Array] An array of {Readiness::Zendesk::Users} instances
+      # @return [object] A {Readiness::Zendesk::JobStatuses} instance
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#create-many-users Zendesk API > Users > Create Many Users
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user1 = Readiness::Zendesk::Users.new
+      #   user1.email = 'alice@example.com'
+      #   user1.name = 'Alice Example'
+      #   user2 = Readiness::Zendesk::Users.new
+      #   user2.email = 'bob@example.com'
+      #   user2.name = 'Bob Example'
+      #   users = [user1, user2]
+      #   creates = Readiness::Zendesk::Users.create_many!(client, users)
+      #   pp creates.id
+      #   # => "82de0b044094f0c67893ac9fe64f1a99"
+      def self.create_many!(client, users)
+        data = { users: users.map { |u| to_hash(u).compact } }.to_json
+        response = client.connection.post('users/create_many', data)
+        handle_request_error(1, 'Zendesk', response.status, { action: 'Create many users', message: Oj.load(response.body)}) unless response.status == 200
+        JobStatuses.new(Oj.load(response.body)['job_status'])
+      end
+
+      ##
+      # Creates or updates multiple users via a batch job
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param users [Array] An array of {Readiness::Zendesk::Users} instances
+      # @return [object] A {Readiness::Zendesk::JobStatuses} instance
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#create-or-update-many-users Zendesk API > Users > Create Or Update Many Users
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user1 = Readiness::Zendesk::Users.new
+      #   user1.email = 'alice@example.com'
+      #   user1.name = 'Alice Example'
+      #   user2 = Readiness::Zendesk::Users.find!(client, 456)
+      #   user2.name = 'Bob Example'
+      #   users = [user1, user2]
+      #   creates = Readiness::Zendesk::Users.create_or_update_many!(client, users)
+      #   pp creates.id
+      #   # => "82de0b044094f0c67893ac9fe64f1a99"
+      def self.create_or_update_many!(client, users)
+        data = { users: users.map { |u| to_hash(u).compact } }.to_json
+        response = client.connection.post('users/create_or_update_many', data)
+        handle_request_error(1, 'Zendesk', response.status, { action: 'Create or update many users', message: Oj.load(response.body)}) unless response.status == 200
+        JobStatuses.new(Oj.load(response.body)['job_status'])
+      end
+
+      ##
+      # Updates multiple users via a batch job
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param users [Array] An array of {Readiness::Zendesk::Users} instances
+      # @return [object] A {Readiness::Zendesk::JobStatuses} instance
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/users/#update-many-users Zendesk API > Users > Update Many Users
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user1 = Readiness::Zendesk::Users.find!(client, 123)
+      #   user1.name = 'Alice Example'
+      #   user2 = Readiness::Zendesk::Users.find!(client, 456)
+      #   user2.name = 'Bob Example'
+      #   users = [user1, user2]
+      #   updates = Readiness::Zendesk::Users.update_many!(client, users)
+      #   pp updates.id
+      #   # => "82de0b044094f0c67893ac9fe64f1a99"
+      def self.update_many!(client, users)
+        data = { users: users.map { |u| to_hash(u).compact } }.to_json
+        response = client.connection.post('users/update_many', data)
+        handle_request_error(1, 'Zendesk', response.status, { action: 'Update many users', message: Oj.load(response.body)}) unless response.status == 200
+        JobStatuses.new(Oj.load(response.body)['job_status'])
+      end
+
+      ##
+      # Deletes multiple users via a batch job
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param uids [Array] An array of user IDs
+      # @return [object] A {Readiness::Zendesk::JobStatuses} instance
+      # @see https://developer.zendesk.com/api-reference/ticketing/tickets/tickets/#bulk-delete-tickets Zendesk API > Tickets > Bulk Delete Tickets
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   delete = Readiness::Zendesk::Users.delete_many!(client, [35436, 35437])
+      #   pp delete.id
+      #   # => "82de0b044094f0c67893ac9fe64f1a99"
+      def self.delete_many!(client, uids)
+        response = client.connection.delete("users/destroy_many?ids=#{uids.join(',')}")
+        handle_request_error(1, 'Zendesk', response.status, { action: 'Delete many users', message: Oj.load(response.body)}) unless response.status == 200
+        JobStatuses.new(Oj.load(response.body)['job_status'])
+      end
+
+      ##
+      # Lists organization memberships for a user
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/organizations/organization_memberships/#list-memberships Zendesk API > Organization Memberships > List Memberships
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 123)
+      #   members = Readiness::Zendesk::Users.organization_memberships(client, user)
+      #   pp members.first.organization_id
+      #   # => 456
+      def self.organization_memberships(client, user)
+        array = []
+        opts = "page[size]=100"
+        loop do
+          response = client.connection.get("user/#{user.id}/organization_memberships?#{opts}")
+          handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+          body = Oj.load(response.body)
+          array += body['organization_memberships'].map { |o| OrganizationMemberships.new(o) }
+          break if limit != 0 && array.count >= (limit * 100)
+          break unless body['meta']['has_more']
+
+          opts = body['links'] ['next'].split('?').last
+        end
+        array
+      end
+
+      ##
+      # Sets the default organization membership of a given user
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @param organization [Object] An instance of {Readiness::Zendesk::Organizations}
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/organizations/organization_memberships/#set-organization-as-default Zendesk API > Organization Memberships > Set Organization as Default
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 123)
+      #   org = Readiness::Zendesk::Organizations.find!(client, 456)
+      #   member = Readiness::Zendesk::Users.set_default_organization!(client, user, org)
+      #   pp member.id
+      #   # => 4
+      def self.set_default_organization!(client, user, organization)
+        response = client.connection.put("users/#{user.id}/organizations/#{organization.id}/make_default")
+        handle_request_error(1, 'Zendesk', response.status, { action: 'Set org as default', message: Oj.load(response.body)}) unless response.status == 200
+        OrganizationMemberships.new(Oj.load(response.body)['organization_membership'])
+      end
+
+      ##
+      # Lists group memberships for a user
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/groups/group_memberships/#list-memberships Zendesk API > Group Memberships > List Memberships
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 123)
+      #   members = Readiness::Zendesk::Users.group_memberships(client, user)
+      #   pp members.first.group_id
+      #   # => 456
+      def self.group_memberships(client, user)
+        response = client.connection.get("users/#{user.id}/group_memberships?page[size]=100")
+        handle_request_error(0, 'Zendesk', response.status) unless response.status == 200
+        Oj.load(response.body)['group_memberships'].map { |m| GroupMemberships.new(m) }
+      end
+
+      ##
+      # Sets the default group membership of a given user
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @param group [Object] An instance of {Readiness::Zendesk::Group}
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/groups/group_memberships/#set-membership-as-default Zendesk API > Group Memberships > Set Membership as Default
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 123)
+      #   group = Readiness::Zendesk::Groups.find!(client, 456)
+      #   member = Readiness::Zendesk::Users.set_default_group!(client, user, group)
+      #   pp member.id
+      #   # => 4
+      def self.set_default_group!(client, user, group)
+        response = client.connection.put("users/#{user.id}/group_memberships/#{group.id}/make_default")
+        handle_request_error(1, 'Zendesk', response.status, { action: 'Set group as default', message: Oj.load(response.body)}) unless response.status == 200
+        GroupMemberships.new(Oj.load(response.body)['group_memberships'])
+      end
+
+      ##
+      # Sets the password for a user
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @param client [Object] An instance of {Readiness::Zendesk::Client}
+      # @param user [Object] An instance of {Readiness::Zendesk::Users}
+      # @param password [String] The password to set
+      # @return [Array]
+      # @see https://developer.zendesk.com/api-reference/ticketing/users/user_passwords/#set-a-users-password Zendesk API > User Password > Set a User's Password
+      # @example
+      #   require 'support_readiness'
+      #   config = Readiness::Zendesk::Configuration.new
+      #   config.username = 'alice@example.com'
+      #   config.token = 'test123abc'
+      #   config.url = 'https://example.zendesk.com/api/v2'
+      #   client = Readiness::Zendesk::Client.new(config)
+      #   user = Readiness::Zendesk::Users.find!(client, 123)
+      #   action = Readiness::Zendesk::Users.set_password!(client, user, 'test123!')
+      #   pp action
+      #   # => true
+      def self.set_password!(client, user, password)
+        response = client.connection.post "users/#{user.id}/password", { password: password }.to_json
+        handle_request_error(1, 'Zendesk', response.status, { action: 'Set user password', id: user.id, message: Oj.load(response.body)}) unless response.status == 200
+        true
+      end
+    end
+  end
+end