yext-api 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8053aa37eff876ce5e19ea3adfc1cc612ba75e33
-  data.tar.gz: 5a2c361a2c6765727896f5d3dfe5cbda88d91ae0
+  metadata.gz: 5ce7d01dbd9e9f86ee887b0316ad5daac4a03767
+  data.tar.gz: 539b2d9959f9295d55149a2c96d4895630d33103
 SHA512:
-  metadata.gz: 2a37ebb7efc5e369d9e379f9268be0129ab1c3ba85b735a0b1e130cc6c4995dd6b1ce741a80c59314e0416cdda6118e54b511fb8b46cbe3f005e6a377e52257e
-  data.tar.gz: e328357997e34cc2ff3620377e8b4d38a17c52210bf945ecceaff13f1f0fe6bcf9600287549ca8c007f57474a9c9db941e8d78a4b3bb0ed413c39cbcb3d00648
+  metadata.gz: 639206c698f5c4daafa14663966acd800663429521dc6e8838839c9567b779dfbc3da861eac32f9fc75b69d8c1f21d0fa1d8bb61061395454772e3ab76d3b629
+  data.tar.gz: c72da8551f456fea3ae50621dd2a18656a6e106fea62cfba200450d582a7aee416f6d8110960ef773924af20838e0e88f9b2ca69d6d97378d9533af8b1efb669

data/Gemfile

@@ -2,9 +2,11 @@
 
 source "https://rubygems.org"
 
-git_source(:github) { |_repo_name| "https://github.com/RealNobody/yext-api" }
+git_source(:github) { |_repo_name| "https://github.com/CardTapp/yext-api" }
 
 # Specify your gem's dependencies in yext-api.gemspec
 gemspec
 
+gem "codecov"
 gem "gem-release"
+gem "simplecov"

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    yext-api (0.1.0)
-      rails (~> 5.1.2)
+    yext-api (0.1.3)
+      memoist (~> 0)
+      rails (> 4)
       spyke (~> 5)
 
 GEM
@@ -49,6 +50,10 @@ GEM
       public_suffix (>= 2.0.2, < 4.0)
     arel (8.0.0)
     builder (3.2.3)
+    codecov (0.1.10)
+      json
+      simplecov
+      url
     concurrent-ruby (1.0.5)
     cornucopia (0.1.40)
       activesupport
@@ -58,7 +63,7 @@ GEM
     diff-lcs (1.3)
     docile (1.1.5)
     erubi (1.7.0)
-    faraday (0.13.1)
+    faraday (0.14.0)
       multipart-post (>= 1.2, < 3)
     faraday_middleware (0.12.2)
       faraday (>= 0.7.4, < 1.0)
@@ -75,6 +80,7 @@ GEM
       nokogiri (>= 1.5.9)
     mail (2.7.0)
       mini_mime (>= 0.1.1)
+    memoist (0.16.0)
     method_source (0.9.0)
     mini_mime (1.0.0)
     mini_portile2 (2.3.0)
@@ -147,7 +153,7 @@ GEM
       actionpack (>= 4.0)
       activesupport (>= 4.0)
       sprockets (>= 3.0.0)
-    spyke (5.2.0)
+    spyke (5.3.0)
       activemodel (>= 4.0.0, < 6.0)
       activesupport (>= 4.0.0, < 6.0)
       addressable (>= 2.5.2)
@@ -157,6 +163,7 @@ GEM
     thread_safe (0.3.6)
     tzinfo (1.2.4)
       thread_safe (~> 0.1)
+    url (0.3.2)
     vcr (4.0.0)
     webmock (3.2.1)
       addressable (>= 2.3.6)
@@ -170,12 +177,13 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.16)
+  bundler
+  codecov
   cornucopia
   gem-release
   hashie
-  rake (~> 10.0)
-  rspec (~> 3.0)
+  rake (~> 10)
+  rspec
   rspec-rails
   simplecov
   simplecov-rcov
@@ -184,4 +192,4 @@ DEPENDENCIES
   yext-api!
 
 BUNDLED WITH
-   1.16.0
+   1.16.1

data/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,11 @@
+## CHANGES
+
+A brief description of the changes being made and the reason for the changes.
+
+## DEVELOPER NOTES
+
+- [ ] Notes on the code changes and what to pay particular attention to in the PR.
+
+## TESTING NOTES
+
+- [ ] Notes on Tests added and how to manually reproduce/test this on a live project.

data/README.md

@@ -1,3 +1,9 @@
+[![Gem Version](https://badge.fury.io/rb/yext-api.svg)](https://badge.fury.io/rb/yext-api.svg)
+[![CircleCI](https://circleci.com/gh/CardTapp/yext-api.svg?style=svg)](https://circleci.com/gh/CardTapp/yext-api)
+[![codecov](https://codecov.io/gh/CardTapp/yext-api/branch/master/graph/badge.svg)](https://codecov.io/gh/CardTapp/yext-api)
+[![Dependency Status](https://gemnasium.com/badges/github.com/CardTapp/yext-api.svg)](https://gemnasium.com/github.com/CardTapp/yext-api)
+[![Maintainability](https://api.codeclimate.com/v1/badges/d80882f00aafa1ed5c7b/maintainability)](https://codeclimate.com/github/CardTapp/yext-api/maintainability)
+
 # Yext::Api
 
 This gem provides a Rails interface with the Yext API.
@@ -46,19 +52,19 @@ The global configurations can be initialized with ENV values.  The following con
   This is the Account ID that is used in the path to API endpoints that require an account ID.  This
   value will default to `"me"` if not specified.
 
-  You can specify this on a per-call basis using `with_account("new account_id")`.  This option is only
+  You can specify this on a per-call basis using `account("new account_id")`.  This option is only
   available for objects that require an account ID for all calls.
 
 * `api_key` - `ENV["YEXT_API_KEY"]`
   This is the API_KEY from the Yext Application that you are using.
 
-  You can specify this on a per-call basis using `with_application("new application key")`.
+  You can specify this on a per-call basis using `application("new application key")`.
 
 * `api_version` - `ENV["YEXT_API_VERSION"]`
   This is the version number of the `v2` API endpoint to be used.  This value be defaulted to the most
   recent version of the API that the gem is aware of or `"2016101"`
 
-  You can specify this on a per-call basis using `with_version("new version")`.
+  You can specify this on a per-call basis using `version("new version")`.
 
 * `yext_username` - `ENV["YEXT_USERNAME"]`
   This is the username to be associated with changes in Yext.  This option is available on all calls but
@@ -87,9 +93,21 @@ The global configurations can be initialized with ENV values.  The following con
 
 ### General Usage
 
-The API namespaces are setup to mimic the structure of the Yext API documentation to make it easier.
-to find or guess at an objects name.  Objects are defined based on the routes for those objects.  The
-following classes are planned based on that structure:
+The API namespaces are setup to mimic the structure of the Yext API documentation to make it easier
+to find or guess at an objects name.  Objects are defined based on the routes for those objects.
+
+In general to see what an object will look like or what to pass in as arguments to some custom routes
+that update or create objects, please refer to the Yext API documentation:
+
+* http://developer.yext.com/docs/api-reference/
+* http://developer.yext.com/docs/administrative-api/
+* http://developer.yext.com/docs/live-api/
+* http://developer.yext.com/docs/webhooks/
+
+The config/api.yml file contains links to the documentation for every action.  In general, each
+class should also include the same information to point you at/to the related documentation.
+
+The following classes are planned based on that structure:
 
 * AdministrativeApi::Account
 * AdministrativeApi::AddRequest
@@ -153,7 +171,7 @@ account = Yext::Api::AdministrativeApi::Account.find("my-id")
 #### Overriding configuration options
 
 ```ruby
-other_account_services = Yext::Api::AdministrativeApi::Service.with_account("6664444").with_application("777821019292928").to_a
+other_account_services = Yext::Api::AdministrativeApi::Service.account("6664444").application("777821019292928").to_a
 ```
 
 #### Using custom actions

data/app/controllers/yext/api/agreements/add_request_controller.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Yext
+  module Api
+    module Agreements
+      # This controller processes Yext add_request webhook callbacks.
+      #
+      # The controller will call the add_request_changed function on the configured class
+      # for the add_request_changed function.
+
+      # :webhooks:
+      #   :agreements:
+      #     :add_request_update:
+      #       :endpoint: https://[your_hostname]/[your_add_request_webhook_path]
+      #       :default_version: 20161012
+      #       :documentation: http://developer.yext.com/docs/webhooks/#operation/addRequestWebhook
+      #       :sandbox_only: false
+      class AddRequestController < Yext::Api::ApplicationController
+        extend Memoist
+
+        def create
+          process_add_request_changed
+
+          head :ok
+        end
+
+        private
+
+        def process_add_request_changed
+          processor = Yext::Api.configuration.get_callback_processor(:add_request_changed)
+
+          return if processor.blank?
+
+          processor.new(processor_args[:meta],
+                        Yext::Api::AdministrativeApi::AddRequest.new(processor_args[:addRequest]),
+                        nil).
+              add_request_changed
+        end
+
+        def processor_args
+          params_hash.convert_epoch :meta, :timestamp
+          params_hash.convert_time :addRequest, :dateSubmitted
+          params_hash.convert_time :addRequest, :dateCompleted
+
+          params_hash.params
+        end
+
+        # rubocop:disable MethodLength
+
+        def params_hash
+          Yext::Api::Utils::Params.
+              new(params.
+                  permit(meta:       %i[eventType uuid timestamp accountId actor appSpecificAccountId],
+                         addRequest: [:id,
+                                      :locationMode,
+                                      :existingLocationId,
+                                      :newLocationId,
+                                      :newLocationAccountId,
+                                      :newAccountParentAccountId,
+                                      :newLocationData,
+                                      { skus: [] },
+                                      :agreementId,
+                                      :status,
+                                      :dateSubmitted,
+                                      :dateCompleted,
+                                      :statusDetail]).
+                  to_hash.
+                  with_indifferent_access)
+        end
+
+        # rubocop:enable MethodLength
+
+        memoize :processor_args,
+                :params_hash
+      end
+    end
+  end
+end

data/app/controllers/yext/api/application_controller.rb

@@ -1,12 +1,10 @@
 # frozen_string_literal: true
 
-# :nocov:
 module Yext
   module Api
     # The base class for the Engines controllers.
     class ApplicationController < ActionController::Base
-      protect_from_forgery with: :exception
+      # protect_from_forgery with: :exception
     end
   end
 end
-# :nocov:

data/config/initializers/memoist.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "memoist"

data/config/routes.rb

@@ -1,4 +1,7 @@
 # frozen_string_literal: true
 
 Yext::Api::Engine.routes.draw do
+  scope :agreements, module: :agreements do
+    resources :add_request, only: %i[create]
+  end
 end

data/lib/config/api.yml

@@ -3,37 +3,12 @@
   :objects:
     :account:
       :actions:
-        - :action: :create
-          :method: :post
-          :endpoint: https://api.yext.com/v2/accounts/{accountId}/newlocationaddrequests
-          :path_regex: v2/accounts/[^/]+?/newlocationaddrequests
-          :default_version: 20161012
-          :documentation: http://developer.yext.com/docs/administrative-api/#operation/createNewLocationAddRequest
-          :comment: Request that a new location be added and services added to it. The location is created only if the request succeeds.
-          :sandbox_only: false
-        - :action: :add_services
-          :method: :post
-          :endpoint: https://api.yext.com/v2/accounts/{accountId}/existinglocationaddrequests
-          :path_regex: v2/accounts/[^/]+?/existinglocationaddrequests
-          :default_version: 20161012
-          :documentation: http://developer.yext.com/docs/administrative-api/#operation/createExistingLocationAddRequest
-          :comment: Request that one or more available services be added to an existing location.
-          :sandbox_only: false
-        - :action: :change_status
-          :method: :post
-          :endpoint: https://api.yext.com/v2/accounts/{accountId}/processaddrequest
-          :path_regex: v2/accounts/[^/]+?/processaddrequest
-          :default_version: 20161012
-          :documentation: http://developer.yext.com/docs/administrative-api/#operation/createProcessReviewAddRequest
-          :comment: Request that an add request in REVIEW be processed to COMPLETE, CANCELED, or FAILED.
-          :sandbox_only: true
         - :action: :index
           :method: :get
           # :endpoint: https://api.yext.com/v2/accounts
           # :path_regex: v2/accounts
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/administrative-api/#operation/listAccounts
-          :comment: List all accounts that you have access to. Unless you are in Partner Portal mode, this will only be your own account.
           :sandbox_only: false
         - :action: :show
           :method: :get
@@ -41,7 +16,6 @@
           # :path_regex: v2/accounts/[^/]+?
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/administrative-api/#operation/getAccount
-          :comment: Get details for an account.
           :sandbox_only: false
         - :action: :update
           :method: :put
@@ -49,7 +23,6 @@
           :path_regex: v2/accounts/[^/]+?
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/administrative-api/#operation/updateAccount
-          :comment: Update an account's name or ID.
           :sandbox_only: false
     :add_request:
       :actions:
@@ -59,15 +32,34 @@
           :path_regex: v2/accounts/[^/]+?/addrequests
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/administrative-api/#operation/listAddRequests
-          :comment: Get all of the add requests in the account. The response includes both New Location Add Requests and Existing Location Add Requests.
           :sandbox_only: false
         - :action: :show
           :method: :get
           :endpoint: https://api.yext.com/v2/accounts/{accountId}/addrequests/{addRequestId}
-          :path_regex: v2/accounts/[^/]+?/addrequests/[^/]+??
+          :path_regex: v2/accounts/[^/]+?/addrequests/[^/]+?
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/administrative-api/#operation/getAddRequest
-          :comment: Get status information about an add request previously created.
+          :sandbox_only: false
+        - :action: :create
+          :method: :post
+          :endpoint: https://api.yext.com/v2/accounts/{accountId}/newlocationaddrequests
+          :path_regex: v2/accounts/[^/]+?/newlocationaddrequests
+          :default_version: 20161012
+          :documentation: http://developer.yext.com/docs/administrative-api/#operation/createNewLocationAddRequest
+          :sandbox_only: false
+        - :action: :change_status
+          :method: :post
+          :endpoint: https://api.yext.com/v2/accounts/{accountId}/processaddrequest
+          :path_regex: v2/accounts/[^/]+?/processaddrequest
+          :default_version: 20161012
+          :documentation: http://developer.yext.com/docs/administrative-api/#operation/createProcessReviewAddRequest
+          :sandbox_only: true
+        - :action: :add_services
+          :method: :post
+          :endpoint: https://api.yext.com/v2/accounts/{accountId}/existinglocationaddrequests
+          :path_regex: v2/accounts/[^/]+?/existinglocationaddrequests
+          :default_version: 20161012
+          :documentation: http://developer.yext.com/docs/administrative-api/#operation/createExistingLocationAddRequest
           :sandbox_only: false
     :service:
       :actions:
@@ -77,7 +69,6 @@
           :path_regex: v2/accounts/[^/]+?/availableservices
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/administrative-api/#operation/listAvailableServices
-          :comment: Return list of services available to you under your agreements.
           :sandbox_only: false
         - :action: :index
           :method: :get
@@ -85,7 +76,6 @@
           :path_regex: v2/accounts/[^/]+?/services
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/administrative-api/#operation/listServices
-          :comment: Retrieve a list of all services provisioned through this account.
           :sandbox_only: false
         - :action: :destroy
           :method: :post
@@ -93,7 +83,6 @@
           :path_regex: v2/accounts/[^/]+?/cancelservices
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/administrative-api/#operation/cancelServices
-          :comment: Cancel one or more active services.
           :sandbox_only: false
 :knowledge_api:
   :documentation: http://developer.yext.com/docs/api-reference/
@@ -107,7 +96,6 @@
             :path_regex: v2/healthy
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/healthCheck
-            :comment: The Health Check endpoint allows you to monitor the status of Yext's systems.
             :sandbox_only: false
   :knowledge_manager:
     :objects:
@@ -120,7 +108,6 @@
             :path_regex: v2/accounts/[^/]+?/locations
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getLocations
-            :comment: Get multiple Locations (primary profiles only).
             :sandbox_only: false
           - :action: :create
             :method: :post
@@ -128,7 +115,6 @@
             :path_regex: v2/accounts/[^/]+?/locations
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createLocation
-            :comment: Create a new Location.
             :sandbox_only: false
           - :action: :search
             :method: :get
@@ -136,23 +122,20 @@
             :path_regex: v2/accounts/[^/]+?/locationsearch
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/searchLocations
-            :comment: Get multiple Locations (primary profiles only) that match provided filters.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/locations/{locationId}
-            :path_regex: v2/accounts/[^/]+?/locations/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/locations/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getLocation
-            :comment: Gets the primary profile for a single Location.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/locations/{locationId}
-            :path_regex: v2/accounts/[^/]+?/locations/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/locations/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateLocation
-            :comment: Updates the primary profile for a Location.
             :sandbox_only: false
       :folder:
         :actions:
@@ -162,7 +145,6 @@
             :path_regex: v2/accounts/[^/]+?/folders
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getLocationFolders
-            :comment: Returns a list of Location Folders in an Account.
             :sandbox_only: false
       :menu:
         :actions:
@@ -172,7 +154,6 @@
             :path_regex: v2/accounts/[^/]+?/menus
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getMenus
-            :comment: Retrieve all Menus for an account.
             :sandbox_only: false
           - :action: :create
             :method: :post
@@ -180,31 +161,27 @@
             :path_regex: v2/accounts/[^/]+?/menus
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createMenu
-            :comment: Create a new Menu.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/menus/{listId}
-            :path_regex: v2/accounts/[^/]+?/menus/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/menus/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getMenu
-            :comment: Retrieve a specific Menu.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/menus/{listId}
-            :path_regex: v2/accounts/[^/]+?/menus/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/menus/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateMenu
-            :comment: Update an existing Menu.
             :sandbox_only: false
           - :action: :destroy
             :method: :delete
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/menus/{listId}
-            :path_regex: v2/accounts/[^/]+?/menus/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/menus/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/deleteMenuList
-            :comment: Delete an existing Menu.
             :sandbox_only: false
       :bio:
         :actions:
@@ -214,7 +191,6 @@
             :path_regex: v2/accounts/[^/]+?/bios
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getBios
-            :comment: Retrieve all Bio Lists for an account.
             :sandbox_only: false
           - :action: :create
             :method: :post
@@ -222,31 +198,27 @@
             :path_regex: v2/accounts/[^/]+?/bios
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createBio
-            :comment: Create a new Bio List.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/bios/{listId}
-            :path_regex: v2/accounts/[^/]+?/bios/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/bios/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getBio
-            :comment: Retrieve a specific Bio List.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/bios/{listId}
-            :path_regex: v2/accounts/[^/]+?/bios/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/bios/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateBio
-            :comment: Update an existing Bio List.
             :sandbox_only: false
           - :action: :destroy
             :method: :delete
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/bios/{listId}
-            :path_regex: v2/accounts/[^/]+?/bios/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/bios/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/deleteBioList
-            :comment: Delete an existing Bios List.
             :sandbox_only: false
       :product:
         :actions:
@@ -256,7 +228,6 @@
             :path_regex: v2/accounts/[^/]+?/products
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getProducts
-            :comment: Retrieve all Product Lists for an account.
             :sandbox_only: false
           - :action: :create
             :method: :post
@@ -264,31 +235,27 @@
             :path_regex: v2/accounts/[^/]+?/products
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createProduct
-            :comment: Create a new Product List.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/products/{listId}
-            :path_regex: v2/accounts/[^/]+?/products/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/products/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getProduct
-            :comment: Retrieve a specific Product List.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/products/{listId}
-            :path_regex: v2/accounts/[^/]+?/products/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/products/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateProduct
-            :comment: Update an existing Product List.
             :sandbox_only: false
           - :action: :destroy
             :method: :delete
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/products/{listId}
-            :path_regex: v2/accounts/[^/]+?/products/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/products/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/deleteProductList
-            :comment: Delete an existing Products List.
             :sandbox_only: false
       :event:
         :actions:
@@ -298,7 +265,6 @@
             :path_regex: v2/accounts/[^/]+?/events
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getEvents
-            :comment: Retrieve all Event Lists for an account.
             :sandbox_only: false
           - :action: :create
             :method: :post
@@ -306,31 +272,27 @@
             :path_regex: v2/accounts/[^/]+?/events
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createEvent
-            :comment: Create a new Event List.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/events/{listId}
-            :path_regex: v2/accounts/[^/]+?/events/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/events/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getEvent
-            :comment: Retrieve a specific Event List.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/events/{listId}
-            :path_regex: v2/accounts/[^/]+?/events/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/events/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateEvent
-            :comment: Update an existing Event List.
             :sandbox_only: false
           - :action: :destroy
             :method: :delete
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/events/{listId}
-            :path_regex: v2/accounts/[^/]+?/events/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/events/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/deleteEventList
-            :comment: Delete an existing Events List.
             :sandbox_only: false
       :category:
         :actions:
@@ -340,7 +302,6 @@
             :path_regex: v2/categories
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getBusinessCategories
-            :comment: Get available Categories.
             :sandbox_only: false
       :google_field:
         :actions:
@@ -350,12 +311,6 @@
             :path_regex: v2/googlefields
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getGoogleKeywords
-            :comment: >
-              Use the Google Fields endpoint to retrieve a complete list of Google's location attributes
-              for each business category. This list includes attributes that may not apply to all
-              Locations in an account. The set of attributes available to a Location depends on its
-              primary business category. You can view and edit the attributes of Locations in the
-              googleAttributes Location field.
             :sandbox_only: false
       :custom_field:
         :actions:
@@ -365,7 +320,6 @@
             :path_regex: v2/accounts/[^/]+?/customfields
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getCustomFields
-            :comment: Returns a list of Custom Fields in an Account.
             :sandbox_only: false
           - :action: :create
             :method: :post
@@ -373,31 +327,27 @@
             :path_regex: v2/accounts/[^/]+?/customfields
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createCustomField
-            :comment: Creates a new Custom Field in an Account.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/customfields/{customFieldId}
-            :path_regex: v2/accounts/[^/]+?/customfields/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/customfields/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getCustomField
-            :comment: Gets a specific Custom Field in an Account.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/customfields/{customFieldId}
-            :path_regex: v2/accounts/[^/]+?/customfields/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/customfields/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateCustomField
-            :comment: Updates a single Custom Field in an Account.
             :sandbox_only: false
           - :action: :destroy
             :method: :delete
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/customfields/{customFieldId}
-            :path_regex: v2/accounts/[^/]+?/customfields/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/customfields/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/deleteCustomField
-            :comment: Deletes a Custom Field in an Account.
             :sandbox_only: false
       :language_profile:
         :belongs_to: location
@@ -405,36 +355,32 @@
           - :action: :index
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/locations/{locationId}/profiles
-            :path_regex: v2/accounts/[^/]+?/locations/[^/]+??/profiles
+            :path_regex: v2/accounts/[^/]+?/locations/[^/]+?/profiles
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getLanguageProfiles
-            :comment: Get Language Profiles for a Location.
             :sandbox_only: false
           - :action: :create
             :alias: :update
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/locations/{locationId}/profiles/{language_code}
-            :path_regex: v2/accounts/[^/]+?/locations/[^/]+??/profiles/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/locations/[^/]+?/profiles/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getLanguageProfile
-            :comment: Gets the the requested Language Profile for a given Location.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/locations/{locationId}/profiles/{language_code}
-            :path_regex: v2/accounts/[^/]+?/locations/[^/]+??/profiles/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/locations/[^/]+?/profiles/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateLanguageProfile
-            :comment: Creates and / or sets the fields for a Language Profile
             :sandbox_only: false
           - :action: :destroy
             :method: :delete
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/locations/{locationId}/profiles/{language_code}
-            :path_regex: v2/accounts/[^/]+?/locations/[^/]+??/profiles/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/locations/[^/]+?/profiles/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/deleteLanguageProfile
-            :comment: Remove a Language Profile from a location.
             :sandbox_only: false
       :asset:
         :actions:
@@ -444,7 +390,6 @@
             :path_regex: v2/accounts/[^/]+?/assets
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getAssets
-            :comment: List assets in an account.
             :sandbox_only: false
           - :action: :create
             :method: :post
@@ -452,33 +397,30 @@
             :path_regex: v2/accounts/[^/]+?/assets
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createAsset
-            :comment: Creates a new Asset in an account.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/assets/{assetId}
-            :path_regex: v2/accounts/[^/]+?/assets/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/assets/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getAsset
-            :comment: Get a specific asset.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/assets/{assetId}
-            :path_regex: v2/accounts/[^/]+?/assets/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/assets/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateAsset
-            :comment: Update a specific asset.
             :sandbox_only: false
           - :action: :destroy
             :method: :delete
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/assets/{assetId}
-            :path_regex: v2/accounts/[^/]+?/assets/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/assets/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/deleteAsset
-            :comment: Delete a specific asset.
             :sandbox_only: false
   :power_listings:
+    :module_name: PowerListings
     :objects:
       :publishser:
         :actions:
@@ -488,7 +430,6 @@
             :path_regex: v2/accounts/[^/]+?/powerlistings/publishers
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/listPublishers
-            :comment: Retrieve a list of publishers included in an account's subscription.
             :sandbox_only: false
       :listing:
         :actions:
@@ -498,7 +439,6 @@
             :path_regex: v2/accounts/[^/]+?/powerlistings/listings
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/listListings
-            :comment: Retrieve all Listings matching the given criteria including status and reasons why a Listing may be unavailable.
             :sandbox_only: false
           - :action: :opt_in
             :method: :put
@@ -506,7 +446,6 @@
             :path_regex: v2/accounts/[^/]+?/powerlistings/listings/optin
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/optInListings
-            :comment: Opts designated locations into designated publishers.
             :sandbox_only: false
           - :action: :opt_out
             :method: :put
@@ -514,7 +453,6 @@
             :path_regex: v2/accounts/[^/]+?/powerlistings/listings/optout
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/optOutListings
-            :comment: Opts designated locations out of designated publishers.
             :sandbox_only: false
       :publisher_suggestion:
         :actions:
@@ -524,23 +462,20 @@
             :path_regex: v2/accounts/[^/]+?/powerlistings/publishersuggestions
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/listPublisherSuggestions
-            :comment: Retrieve suggestions publishers have submitted for the Locations in an account.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/powerlistings/publishersuggestions/{suggestionId}
-            :path_regex: v2/accounts/[^/]+?/powerlistings/publishersuggestions/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/powerlistings/publishersuggestions/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getPublisherSuggestion
-            :comment: Fetches details of a specific Publisher Suggestion.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/powerlistings/publishersuggestions/{suggestionId}
-            :path_regex: v2/accounts/[^/]+?/powerlistings/publishersuggestions/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/powerlistings/publishersuggestions/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updatePublisherSuggestion
-            :comment: Accept or reject a Publisher Suggestion.
             :sandbox_only: false
       :duplicate:
         :actions:
@@ -550,7 +485,6 @@
             :path_regex: v2/accounts/[^/]+?/powerlistings/duplicates
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/listDuplicates
-            :comment: Retrieve Duplicates for an account.
             :sandbox_only: false
           - :action: :create
             :method: :post
@@ -558,25 +492,23 @@
             :path_regex: v2/accounts/[^/]+?/powerlistings/duplicates
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createDuplicate
-            :comment: Creates a new Duplicate with status SUPPRESSION_REQUESTED.
             :sandbox_only: false
           - :action: :destroy
             :method: :delete
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/powerlistings/duplicates/{duplicateId}
-            :path_regex: v2/accounts/[^/]+?/powerlistings/duplicates/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/powerlistings/duplicates/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/deleteDuplicate
-            :comment: Indicates that a Duplicate should be ignored.
             :sandbox_only: false
           - :action: :suppress
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/powerlistings/duplicates/{duplicateId}
-            :path_regex: v2/accounts/[^/]+?/powerlistings/duplicates/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/powerlistings/duplicates/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/suppressDuplicate
-            :comment: Request suppression of a Duplicate.
             :sandbox_only: false
   :analytics:
+    :module_name: Analytics
     :objects:
       :max_date:
         :actions:
@@ -586,7 +518,6 @@
             :path_regex: v2/accounts/[^/]+?/analytics/maxdates
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getMaxDates
-            :comment: The dates through which reporting data is available.
             :sandbox_only: false
       :report:
         :actions:
@@ -596,15 +527,13 @@
             :path_regex: v2/accounts/[^/]+?/analytics/reports
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createReports
-            :comment: Begins the process of producing a report.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/analytics/standardreports/{reportId}
-            :path_regex: v2/accounts/[^/]+?/analytics/standardreports/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/analytics/standardreports/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/reportStatus
-            :comment: Checks the status of a Report created with async=true.
             :sandbox_only: false
       :activity:
         :actions:
@@ -614,9 +543,9 @@
             :path_regex: v2/accounts/[^/]+?/analytics/activity
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/activityLog
-            :comment: Fetches account activity information.
             :sandbox_only: false
   :reviews:
+    :module_name: Reviews
     :objects:
       :review:
         :has_many: comments
@@ -627,7 +556,6 @@
             :path_regex: v2/accounts/[^/]+?/reviews
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/listReviews
-            :comment: Retrieve all Reviews matching the given criteria.
             :sandbox_only: false
           - :action: :create
             :method: :post
@@ -635,23 +563,20 @@
             :path_regex: v2/accounts/[^/]+?/reviews
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createReview
-            :comment: Create a new External First Party Review.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/reviews/{reviewId}
-            :path_regex: v2/accounts/[^/]+?/reviews/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/reviews/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getReview
-            :comment: Retrieve a specific Review.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/reviews/{reviewId}
-            :path_regex: v2/accounts/[^/]+?/reviews/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/reviews/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateReview
-            :comment: Updates an External First Party Review.
             :sandbox_only: false
       :comment:
         :belongs_to: review
@@ -659,10 +584,9 @@
           - :action: :create
             :method: :post
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/reviews/{reviewId}/comments
-            :path_regex: v2/accounts/[^/]+?/reviews/[^/]+??/comments
+            :path_regex: v2/accounts/[^/]+?/reviews/[^/]+?/comments
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createComment
-            :comment: Creates a new Comment on a Review.
             :sandbox_only: false
       :review_invitation:
         :actions:
@@ -672,7 +596,6 @@
             :path_regex: v2/accounts/[^/]+?/reviewinvites
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/listReviewInvitations
-            :comment: Retrieves all review invitations for an account.
             :sandbox_only: false
           - :action: :create
             :method: :post
@@ -680,15 +603,13 @@
             :path_regex: v2/accounts/[^/]+?/reviewinvites
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createReviewInvites
-            :comment: Sends review invitations to one or more consumers.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/reviewinvites/{invitationId}
-            :path_regex: v2/accounts/[^/]+?/reviewinvites/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/reviewinvites/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getReviewInvitation
-            :comment: Retrieve a specific review invitation.
             :sandbox_only: false
       :review_generation_setting:
         :actions:
@@ -698,7 +619,6 @@
             :path_regex: v2/accounts/[^/]+?/reviews/settings/generation
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getReviewGenerationSettings
-            :comment: Returns all current generation settings for a specified account.
             :sandbox_only: false
           - :action: :create
             :alias: :update
@@ -708,9 +628,6 @@
             :path_regex: v2/accounts/[^/]+?/reviews/settings/generation
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateReviewGenerationSettings
-            :comment: >
-              Updates any generation settings specified in a specified account. Call may include any/all
-              settings available to the account. Settings not included will remain unchanged.
             :sandbox_only: false
   :social:
     :objects:
@@ -723,7 +640,6 @@
             :path_regex: v2/accounts/[^/]+?/posts
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getPosts
-            :comment: Retrieve list of Posts.
             :sandbox_only: false
           - :action: :create
             :method: :post
@@ -731,15 +647,13 @@
             :path_regex: v2/accounts/[^/]+?/posts
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createPosts
-            :comment: Create a new Post.
             :sandbox_only: false
           - :action: :destroy
             :method: :delete
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/posts/{postId}
-            :path_regex: v2/accounts/[^/]+?/posts/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/posts/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/deletePost
-            :comment: Deletes an existing Post.
             :sandbox_only: false
       :comment:
         :belongs_to: post
@@ -747,34 +661,30 @@
           - :action: :index
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/posts/{postId}/comments
-            :path_regex: v2/accounts/[^/]+?/posts/[^/]+??/comments
+            :path_regex: v2/accounts/[^/]+?/posts/[^/]+?/comments
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getComments
-            :comment: Retrieve list of Comments for a Post.
             :sandbox_only: false
           - :action: :create
             :method: :post
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/posts/{postId}/comments
-            :path_regex: v2/accounts/[^/]+?/posts/[^/]+??/comments
+            :path_regex: v2/accounts/[^/]+?/posts/[^/]+?/comments
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createComment
-            :comment: Create a new Comment in response to another Post / Comment.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/posts/{postId}/comments/{commentId}
-            :path_regex: v2/accounts/[^/]+?/posts/[^/]+??/comments/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/posts/[^/]+?/comments/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateComment
-            :comment: Updates an existing Comment.
             :sandbox_only: false
           - :action: :destroy
             :method: :delete
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/posts/{postId}/comments/{commentId}
-            :path_regex: v2/accounts/[^/]+?/posts/[^/]+??/comments/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/posts/[^/]+?/comments/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/deleteComment
-            :comment: Deletes an existing Comment.
             :sandbox_only: false
       :linked_account:
         :actions:
@@ -784,25 +694,23 @@
             :path_regex: v2/accounts/[^/]+?/linkedaccounts
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getLinkedAccounts
-            :comment: Retrieve all Linked Accounts and their last known statuses.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/linkedaccounts/{linkedAccountId}
-            :path_regex: v2/accounts/[^/]+?/linkedaccounts/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/linkedaccounts/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getLinkedAccount
-            :comment: Retrieve a specific Linked Account.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/linkedaccounts/{linkedAccountId}
-            :path_regex: v2/accounts/[^/]+?/linkedaccounts/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/linkedaccounts/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateLinkedAccount
-            :comment: Assign or Unassign a Linked Account to one or more Locations.
             :sandbox_only: false
   :account_settings:
+    :module_name: AccountSettings
     :objects:
       :role:
         :actions:
@@ -812,7 +720,6 @@
             :path_regex: v2/accounts/[^/]+?/roles
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getRoles
-            :comment: Retrieves a list of the roles that users can have within a customer’s account.
             :sandbox_only: false
       :user:
         :actions:
@@ -822,7 +729,6 @@
             :path_regex: v2/accounts/[^/]+?/users
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getUsers
-            :comment: Lists all Users in an account.
             :sandbox_only: false
           - :action: :create
             :method: :post
@@ -830,39 +736,34 @@
             :path_regex: v2/accounts/[^/]+?/users
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/createUser
-            :comment: Create a new User.
             :sandbox_only: false
           - :action: :show
             :method: :get
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/users/{userId}
-            :path_regex: v2/accounts/[^/]+?/users/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/users/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getUser
-            :comment: Retrieves details of a specific User.
             :sandbox_only: false
           - :action: :update
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/users/{userId}
-            :path_regex: v2/accounts/[^/]+?/users/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/users/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateUser
-            :comment: Updates an existing User.
             :sandbox_only: false
           - :action: :destroy
             :method: :delete
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/users/{userId}
-            :path_regex: v2/accounts/[^/]+?/users/[^/]+??
+            :path_regex: v2/accounts/[^/]+?/users/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/deleteUser
-            :comment: Deletes an existing User.
             :sandbox_only: false
           - :action: :change_password
             :method: :put
             :endpoint: https://api.yext.com/v2/accounts/{accountId}/users/{userId}/password
-            :path_regex: v2/accounts/[^/]+?/users/[^/]+??/password
+            :path_regex: v2/accounts/[^/]+?/users/[^/]+?/password
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/updateUserPassword
-            :comment: Updates a User's password.
             :sandbox_only: false
       :account:
         :actions:
@@ -872,9 +773,6 @@
             :path_regex: v2/accounts
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/listAccounts
-            :comment: >
-              List all accounts that you have access to. Unless you are in Partner Portal mode,
-              this will only be your own account.
             :sandbox_only: false
           - :action: :show
             :method: :get
@@ -882,9 +780,9 @@
             :path_regex: v2/accounts/[^/]+?
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getAccount
-            :comment: Get details for an account.
             :sandbox_only: false
   :optimization_tasks:
+    :module_name: OptimizationTasks
     :objects:
       :optimization_task:
         :actions:
@@ -894,7 +792,6 @@
             :path_regex: v2/accounts/[^/]+?/optimizationtasks
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getOptimizationTasks
-            :comment: List Optimization Tasks for the account, optionally filtered by task and location.
             :sandbox_only: false
           - :action: :show
             :method: :get
@@ -902,7 +799,6 @@
             :path_regex: v2/accounts/[^/]+?/optimizationlink
             :default_version: 20161012
             :documentation: http://developer.yext.com/docs/api-reference/#operation/getLinkOptimizationTask
-            :comment: Retrieve a link to perform any pending Optimization Tasks given a set of Optimization Tasks and a location.
             :sandbox_only: false
 :live_api:
   :documentation: http://developer.yext.com/docs/live-api/
@@ -912,40 +808,36 @@
         - :action: :show
           :method: :get
           :endpoint: https://liveapi.yext.com/v2/accounts/{accountId}/menus/{listId}
-          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/menus/[^/]+??
+          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/menus/[^/]+?
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/live-api/#operation/getMenus
-          :comment: Retrieve a specific Menu.
           :sandbox_only: false
     :bio:
       :actions:
         - :action: :show
           :method: :get
           :endpoint: https://liveapi.yext.com/v2/accounts/{accountId}/bios/{listId}
-          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/bios/[^/]+??
+          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/bios/[^/]+?
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/live-api/#operation/getBios
-          :comment: Retrieve a specific Bios ECL.
           :sandbox_only: false
     :product:
       :actions:
         - :action: :show
           :method: :get
           :endpoint: https://liveapi.yext.com/v2/accounts/{accountId}/products/{listId}
-          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/products/[^/]+??
+          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/products/[^/]+?
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/live-api/#operation/getProducts
-          :comment: Retrieve a specific Products ECL.
           :sandbox_only: false
     :event:
       :actions:
         - :action: :show
           :method: :get
           :endpoint: https://liveapi.yext.com/v2/accounts/{accountId}/events/{listId}
-          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/events/[^/]+??
+          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/events/[^/]+?
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/live-api/#operation/getEvents
-          :comment: Retrieve a specific Events ECL.
           :sandbox_only: false
     :language_profile:
       :belongs_to: location
@@ -954,18 +846,16 @@
         - :action: :index
           :method: :get
           :endpoint: https://liveapi.yext.com/v2/accounts/{accountId}/locations/{locationId}/profiles/
-          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations/[^/]+??/profiles/
+          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations/[^/]+?/profiles/
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/live-api/#operation/listLanguageProfiles
-          :comment: Gets all Language Profiles for a Location.
           :sandbox_only: false
         - :action: :show
           :method: :get
           :endpoint: https://liveapi.yext.com/v2/accounts/{accountId}/locations/{locationId}/profiles/{languageCode}
-          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations/[^/]+??/profiles/[^/]+??
+          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations/[^/]+?/profiles/[^/]+?
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/live-api/#operation/getLanguageProfiles
-          :comment: Gets the requested Language Profile for a given Location.
           :sandbox_only: false
     :language_profile_schema:
       :belongs_to: language_profile
@@ -973,12 +863,25 @@
         - :action: :show
           :method: :get
           :endpoint: https://liveapi.yext.com/v2/accounts/{accountId}/locations/{locationId}/profiles/{languageCode}/schema
-          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations/[^/]+??/profiles/[^/]+??/schema
+          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations/[^/]+?/profiles/[^/]+?/schema
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/live-api/#operation/getLanguageProfilesSchema
-          :comment: >
-            Gets the schema.org compliant schema for the requested Language Profile of a given Location.
-            Schema will vary depending on the primary category of the Location.
+          :sandbox_only: false
+    :location_schema:
+      :actions:
+        - :action: :show
+          :method: :get
+          :endpoint: https://liveapi.yext.com/v2/accounts/{accountId}/locations/{locationId}/schema
+          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations/[^/]+?/schema
+          :default_version: 20161012
+          :documentation: http://developer.yext.com/docs/live-api/#operation/getLocationSchema
+          :sandbox_only: false
+        - :action: :geo_search
+          :method: :get
+          :endpoint: https://liveapi.yext.com/v2/accounts/{accountId}/locations/geosearch
+          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations/geosearch
+          :default_version: 20161012
+          :documentation: http://developer.yext.com/docs/live-api/#operation/geoSearch
           :sandbox_only: false
     :location:
       :has_many: language_profile
@@ -990,40 +893,13 @@
           :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/live-api/#operation/locationsList
-          :comment: >
-            Get multiple Locations (primary profile only). Filters are evaluated against all language
-            profiles as well as the primary profile.
           :sandbox_only: false
         - :action: :show
           :method: :get
           :endpoint: https://liveapi.yext.com/v2/accounts/{accountId}/locations/{locationId}
-          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations/[^/]+??
+          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations/[^/]+?
           :default_version: 20161012
           :documentation: http://developer.yext.com/docs/live-api/#operation/getLocation
-          :comment: Gets the primary profile for a single Location.
-          :sandbox_only: false
-    :location_schema:
-      :actions:
-        - :action: :show
-          :method: :get
-          :endpoint: https://liveapi.yext.com/v2/accounts/{accountId}/locations/{locationId}/schema
-          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations/[^/]+??/schema
-          :default_version: 20161012
-          :documentation: http://developer.yext.com/docs/live-api/#operation/getLocationSchema
-          :comment: >
-            Gets the schema.org compliant schema for the primary profile of a single Location. Schema
-            will vary depending on the primary category of the Location.
-          :sandbox_only: false
-        - :action: :geo_search
-          :method: :get
-          :endpoint: https://liveapi.yext.com/v2/accounts/{accountId}/locations/geosearch
-          :path_regex: https://liveapi.yext.com/v2/accounts/[^/]+?/locations/geosearch
-          :default_version: 20161012
-          :documentation: http://developer.yext.com/docs/live-api/#operation/geoSearch
-          :comment: >
-            Gets multiple Locations (primary profile only) near a given location, ordered by proximity
-            to the location (if no other sort criteria are given) and restricted to a radius. Searches
-            through all language profiles, including the primary profile.
           :sandbox_only: false
 :webhooks:
   :documentation: http://developer.yext.com/docs/webhooks/
@@ -1032,69 +908,58 @@
       :endpoint: https://[your_hostname]/[your_locations_webhook_path]
       :default_version: 20161012
       :documentation: http://developer.yext.com/docs/webhooks/#operation/locationsWebhook
-      :comment: Sends an updated Location to your server.
       :sandbox_only: false
     :menu:
       :endpoint: https://[your_hostname]/[your_menus_webhook_path]
       :default_version: 20161012
       :documentation: http://developer.yext.com/docs/webhooks/#operation/menusWebhook
-      :comment: Sends an updated Menu object to your server.
       :sandbox_only: false
     :bio:
       :endpoint: https://[your_hostname]/[your_bios_webhook_path]
       :default_version: 20161012
       :documentation: http://developer.yext.com/docs/webhooks/#operation/biosWebhook
-      :comment: Sends an updated Bios object to your server.
       :sandbox_only: false
     :product:
       :endpoint: https://[your_hostname]/[your_products_webhook_path]
       :default_version: 20161012
       :documentation: http://developer.yext.com/docs/webhooks/#operation/productsWebhook
-      :comment: Sends an updated Product List object to your server.
       :sandbox_only: false
     :event:
       :endpoint: https://[your_hostname]/[your_events_webhook_path]
       :default_version: 20161012
       :documentation: http://developer.yext.com/docs/webhooks/#operation/eventsWebhook
-      :comment: Sends an updated Events List (Calendar) object to your server.
       :sandbox_only: false
   :power_listings:
     :listing:
       :endpoint: https://[your_hostname]/[your_listings_webhook_path]
       :default_version: 20161012
       :documentation: http://developer.yext.com/docs/webhooks/#operation/listingsWebhook
-      :comment: Sends an updated Listing object to your server.
       :sandbox_only: false
     :duplicate:
       :endpoint: https://[your_hostname]/[your_duplicates_webhook_path]
       :default_version: 20161012
       :documentation: http://developer.yext.com/docs/webhooks/#operation/duplicatesWebhook
-      :comment: Sends an updated Duplicate object to your server.
       :sandbox_only: false
     :publisher_suggestion:
       :endpoint: https://[your_hostname]/[your_publisherSuggestions_webhook_path]
       :default_version: 20161012
       :documentation: http://developer.yext.com/docs/webhooks/#operation/publisherSuggestionsWebhook
-      :comment: Sends an updated Publisher Suggestion object to your server.
       :sandbox_only: false
   :reviews:
     :review:
       :endpoint: https://[your_hostname]/[your_reviews_webhook_path]
       :default_version: 20161012
       :documentation: http://developer.yext.com/docs/webhooks/#operation/reviewsWebhook
-      :comment: Sends an updated Review object to your server whenever a Review or one of its Comments are created or modified.
       :sandbox_only: false
   :app_directory:
     :review:
       :endpoint: https://[your_hostname]/[your_unlink_account_webhook_path]
       :default_version: 20161012
       :documentation: http://developer.yext.com/docs/webhooks/#operation/unlinkWebhook
-      :comment: Fired when an account uninstalls your App.
       :sandbox_only: false
   :agreements:
     :add_request_update:
       :endpoint: https://[your_hostname]/[your_add_request_webhook_path]
       :default_version: 20161012
       :documentation: http://developer.yext.com/docs/webhooks/#operation/addRequestWebhook
-      :comment: Fired when an Add Request is updated.
       :sandbox_only: false