spree_api 4.3.0.rc2 → 4.3.0.rc3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48615e27a8581045bc1b9839021d0d247059463a110a8edae568d697b615c6fa
-  data.tar.gz: 4f68efa95ca9540d8bdd18d34889d37b25a210c4867035ac09e2eda66643459b
+  metadata.gz: 2bd9fd052b9bc9fd57cabf4fb28955081e4e3522aad98fe014641d46ca7b5c2c
+  data.tar.gz: f91442e429d34783f73dbc25806afa80ab0cbd5013c07c499c8b7da4bc5a29aa
 SHA512:
-  metadata.gz: a859373d202ea8f1ad70c30a9fcc48ed8d89a62bcbaab5d77844a5128dff9a674fb219ed5e523676be47317c259fbab13ba16a4fcfdd2742c6a81247a5ca0097
-  data.tar.gz: 54e262a305a30977dc426ef8fe1462634214c3e2f4e566182559d8cc54fc79b23fd9ec78f7ece0655a7d77703d879266e2572789071d093b53f401254960b7dd
+  metadata.gz: dcc5d4344630b798bb0ea424285c89267ec2034d2a2f2fb483686c17670793b13fb23499a10aec1c579a3c807cd995b2b6b9f6c33ba68cfe4da9883b57de017f
+  data.tar.gz: c9d7016ddc08b9d26a438b46a5374d1c229e90e51cb2bace94c4f616c647d13d37eecd913c10ed80126508e25b23d5054032f1bd4ef349098c2caa8fc8869ae6

data/app/controllers/concerns/spree/api/v2/caching.rb

@@ -14,8 +14,8 @@ module Spree
             sparse_fields,
             serializer_params,
             params[:sort]&.strip,
-            params[:page]&.strip,
-            params[:per_page]&.strip,
+            params[:page]&.to_s&.strip,
+            params[:per_page]&.to_s&.strip,
           ].flatten.join('-')
 
           Digest::MD5.hexdigest(cache_key_parts)

data/app/controllers/spree/api/v2/base_controller.rb

@@ -132,7 +132,9 @@ module Spree
             currency: current_currency,
             locale: current_locale,
             store: current_store,
-            user: spree_current_user
+            user: spree_current_user,
+            image_transformation: params[:image_transformation],
+            taxon_image_transformation: params[:taxon_image_transformation]
           }
         end
 

data/app/controllers/spree/api/v2/platform/menu_items_controller.rb

@@ -8,7 +8,7 @@ module Spree
           def reposition
             spree_authorize! :update, @moved_item if spree_current_user.present?
 
-            @moved_item = scope.find(params[:moved_item_id])
+            @moved_item = scope.find(params[:id])
             @new_parent = scope.find(params[:new_parent_id])
             new_index = params[:new_position_idx].to_i
 
@@ -19,7 +19,7 @@ module Spree
             end
 
             if @moved_item.save
-              head :no_content
+              render_serialized_payload { serialize_resource(resource) }
             end
           end
 

data/app/controllers/spree/api/v2/platform/menus_controller.rb

@@ -12,6 +12,10 @@ module Spree
           def scope_includes
             [:menu_items]
           end
+
+          def scope
+            current_store.menus
+          end
         end
       end
     end

data/app/controllers/spree/api/v2/platform/resource_controller.rb

@@ -18,6 +18,8 @@ module Spree
           def create
             resource = model_class.new(permitted_resource_params)
 
+            ensure_current_store(resource)
+
             if resource.save
               render_serialized_payload(201) { serialize_resource(resource) }
             else
@@ -27,6 +29,7 @@ module Spree
 
           def update
             if resource.update(permitted_resource_params)
+              ensure_current_store(resource)
               render_serialized_payload { serialize_resource(resource) }
             else
               render_error_payload(resource.errors)

data/app/controllers/spree/api/v2/storefront/countries_controller.rb

@@ -3,6 +3,8 @@ module Spree
     module V2
       module Storefront
         class CountriesController < ::Spree::Api::V2::ResourceController
+          before_action :set_default_per_page
+
           private
 
           def serialize_collection(collection)
@@ -43,6 +45,11 @@ module Spree
           def model_class
             Spree::Country
           end
+
+          # by default we want to return all countries on a single page
+          def set_default_per_page
+            params[:per_page] ||= Spree::Country.count
+          end
         end
       end
     end

data/app/serializers/concerns/spree/api/v2/image_transformation_concern.rb

@@ -0,0 +1,15 @@
+module Spree
+  module Api
+    module V2
+      module ImageTransformationConcern
+        extend ActiveSupport::Concern
+
+        def self.included(base)
+          base.attribute :transformed_url do |image, params|
+            image.generate_url(size: params.dig(:image_transformation, :size))
+          end
+        end
+      end
+    end
+  end
+end

data/app/serializers/concerns/spree/api/v2/taxon_image_transformation_concern.rb

@@ -0,0 +1,15 @@
+module Spree
+  module Api
+    module V2
+      module TaxonImageTransformationConcern
+        extend ActiveSupport::Concern
+
+        def self.included(base)
+          base.attribute :transformed_url do |image, params|
+            image.generate_url(size: params.dig(:taxon_image_transformation, :size))
+          end
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v2/platform/icon_serializer.rb

@@ -0,0 +1,16 @@
+module Spree
+  module Api
+    module V2
+      module Platform
+        class IconSerializer < BaseSerializer
+          set_type :icon
+
+          attribute :url do |icon|
+            url_helpers = Rails.application.routes.url_helpers
+            url_helpers.polymorphic_url(icon.attachment, only_path: true)
+          end
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/api/v2/platform/image_serializer.rb

@@ -3,9 +3,11 @@ module Spree
     module V2
       module Platform
         class ImageSerializer < BaseSerializer
+          include ::Spree::Api::V2::ImageTransformationConcern
+
           set_type :image
 
-          attributes :styles, :position, :alt, :created_at, :updated_at
+          attributes :styles, :position, :alt, :created_at, :updated_at, :original_url
 
           belongs_to :viewable, polymorphic: true
         end

data/app/serializers/spree/api/v2/platform/menu_item_serializer.rb

@@ -5,11 +5,29 @@ module Spree
         class MenuItemSerializer < BaseSerializer
           include ::Spree::Api::V2::ResourceSerializerConcern
 
-          has_one :image,
+          attributes :link
+
+          attribute :is_container do |menu_item|
+            menu_item.container?
+          end
+
+          attribute :is_root do |menu_item|
+            menu_item.root?
+          end
+
+          attribute :is_child do |menu_item|
+            menu_item.child?
+          end
+
+          attribute :is_leaf do |menu_item|
+            menu_item.leaf?
+          end
+
+          has_one :icon,
                   object_method_name: :icon,
                   id_method_name: :icon_id,
-                  record_type: :image,
-                  serializer: :image
+                  record_type: :icon,
+                  serializer: :icon
 
           belongs_to :menu, serializer: :menu
           belongs_to :parent, record_type: :menu_item, serializer: :menu_item

data/app/serializers/spree/api/v2/platform/taxon_image_serializer.rb

@@ -3,9 +3,11 @@ module Spree
     module V2
       module Platform
         class TaxonImageSerializer < BaseSerializer
+          include ::Spree::Api::V2::TaxonImageTransformationConcern
+
           set_type :taxon_image
 
-          attributes :styles, :alt, :created_at, :updated_at
+          attributes :alt, :created_at, :updated_at, :original_url
         end
       end
     end

data/app/serializers/spree/v2/storefront/icon_serializer.rb

@@ -0,0 +1,14 @@
+module Spree
+  module V2
+    module Storefront
+      class IconSerializer < BaseSerializer
+        set_type :icon
+
+        attribute :url do |icon|
+          url_helpers = Rails.application.routes.url_helpers
+          url_helpers.polymorphic_url(icon.attachment, only_path: true)
+        end
+      end
+    end
+  end
+end

data/app/serializers/spree/v2/storefront/image_serializer.rb

@@ -2,9 +2,11 @@ module Spree
   module V2
     module Storefront
       class ImageSerializer < BaseSerializer
+        include ::Spree::Api::V2::ImageTransformationConcern
+
         set_type :image
 
-        attributes :viewable_type, :viewable_id, :styles
+        attributes :styles, :position, :alt, :original_url
       end
     end
   end

data/app/serializers/spree/v2/storefront/menu_item_serializer.rb

@@ -4,7 +4,7 @@ module Spree
       class MenuItemSerializer < BaseSerializer
         set_type :menu_item
 
-        attributes :code, :name, :subtitle, :link, :new_window, :lft, :rgt, :depth
+        attributes :code, :name, :subtitle, :link, :destination, :item_type, :new_window, :lft, :rgt, :depth
 
         attribute :is_container do |menu_item|
           menu_item.container?
@@ -22,11 +22,11 @@ module Spree
           menu_item.leaf?
         end
 
-        has_one :image,
+        has_one :icon,
                 object_method_name: :icon,
                 id_method_name: :icon_id,
-                record_type: :image,
-                serializer: :image
+                record_type: :icon,
+                serializer: :icon
 
         belongs_to :menu, serializer: :menu
         belongs_to :parent, record_type: :menu_item, serializer: :menu_item

data/app/serializers/spree/v2/storefront/payment_method_serializer.rb

@@ -5,6 +5,10 @@ module Spree
         set_type :payment_method
 
         attributes :type, :name, :description
+
+        attribute :preferences do |object|
+          object.public_preferences.as_json
+        end
       end
     end
   end

data/app/serializers/spree/v2/storefront/product_serializer.rb

@@ -6,7 +6,7 @@ module Spree
 
         set_type :product
 
-        attributes :name, :description, :available_on, :slug, :meta_description, :meta_keywords, :updated_at
+        attributes :name, :description, :available_on, :slug, :meta_description, :meta_keywords, :updated_at, :sku
 
         attribute :purchasable do |product|
           product.purchasable?

data/app/serializers/spree/v2/storefront/taxon_image_serializer.rb

@@ -2,9 +2,11 @@ module Spree
   module V2
     module Storefront
       class TaxonImageSerializer < BaseSerializer
+        include ::Spree::Api::V2::TaxonImageTransformationConcern
+
         set_type   :taxon_image
 
-        attributes :viewable_type, :viewable_id, :styles
+        attributes :styles, :alt, :original_url
       end
     end
   end

data/config/routes.rb

@@ -254,7 +254,7 @@ Spree::Core::Engine.add_routes do
 
         # Menu API
         resources :menus
-        resource :menu_items do
+        resources :menu_items do
           member do
             patch :reposition
           end

data/docs/v2/platform/index.yaml

@@ -57,8 +57,8 @@ paths:
                         state_name:
                         alternative_phone: 555-555-0199
                         company: Company
-                        created_at: '2021-08-20T11:02:26.158Z'
-                        updated_at: '2021-08-20T11:02:26.158Z'
+                        created_at: '2021-08-23T21:28:22.108Z'
+                        updated_at: '2021-08-23T21:28:22.108Z'
                         deleted_at:
                         label:
                       relationships:
@@ -85,8 +85,8 @@ paths:
                         state_name:
                         alternative_phone: 555-555-0199
                         company: Company
-                        created_at: '2021-08-20T11:02:26.166Z'
-                        updated_at: '2021-08-20T11:02:26.166Z'
+                        created_at: '2021-08-23T21:28:22.134Z'
+                        updated_at: '2021-08-23T21:28:22.134Z'
                         deleted_at:
                         label:
                       relationships:
@@ -154,8 +154,8 @@ paths:
                         state_name:
                         alternative_phone: 555-555-0199
                         company: Company
-                        created_at: '2021-08-20T11:02:26.535Z'
-                        updated_at: '2021-08-20T11:02:26.535Z'
+                        created_at: '2021-08-23T21:28:22.275Z'
+                        updated_at: '2021-08-23T21:28:22.275Z'
                         deleted_at:
                         label:
                       relationships:
@@ -200,7 +200,7 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/address_params"
+              "$ref": "#/components/schemas/addresses_params"
   "/api/v2/platform/addresses/{id}":
     get:
       summary: Returns an Address
@@ -243,8 +243,8 @@ paths:
                         state_name:
                         alternative_phone: 555-555-0199
                         company: Company
-                        created_at: '2021-08-20T11:02:26.609Z'
-                        updated_at: '2021-08-20T11:02:26.609Z'
+                        created_at: '2021-08-23T21:28:22.297Z'
+                        updated_at: '2021-08-23T21:28:22.297Z'
                         deleted_at:
                         label:
                       relationships:
@@ -315,8 +315,8 @@ paths:
                         state_name:
                         alternative_phone: 555-555-0199
                         company: Company
-                        created_at: '2021-08-20T11:02:26.706Z'
-                        updated_at: '2021-08-20T11:02:26.721Z'
+                        created_at: '2021-08-23T21:28:22.331Z'
+                        updated_at: '2021-08-23T21:28:22.336Z'
                         deleted_at:
                         label:
                       relationships:
@@ -363,7 +363,7 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/address_params"
+              "$ref": "#/components/schemas/addresses_params"
     delete:
       summary: Deletes an Address
       tags:
@@ -439,8 +439,8 @@ paths:
                       type: classification
                       attributes:
                         position: 1
-                        created_at: '2021-08-20T11:02:27.225Z'
-                        updated_at: '2021-08-20T11:02:27.225Z'
+                        created_at: '2021-08-23T21:28:22.534Z'
+                        updated_at: '2021-08-23T21:28:22.534Z'
                       relationships:
                         product:
                           data:
@@ -454,8 +454,8 @@ paths:
                       type: classification
                       attributes:
                         position: 1
-                        created_at: '2021-08-20T11:02:27.336Z'
-                        updated_at: '2021-08-20T11:02:27.336Z'
+                        created_at: '2021-08-23T21:28:22.569Z'
+                        updated_at: '2021-08-23T21:28:22.569Z'
                       relationships:
                         product:
                           data:
@@ -510,8 +510,8 @@ paths:
                       type: classification
                       attributes:
                         position: 1
-                        created_at: '2021-08-20T11:02:27.775Z'
-                        updated_at: '2021-08-20T11:02:27.775Z'
+                        created_at: '2021-08-23T21:28:22.728Z'
+                        updated_at: '2021-08-23T21:28:22.728Z'
                       relationships:
                         product:
                           data:
@@ -538,7 +538,7 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/classification_params"
+              "$ref": "#/components/schemas/classifications_params"
   "/api/v2/platform/classifications/{id}":
     get:
       summary: Returns a Classification
@@ -551,46 +551,1183 @@ paths:
         in: path
         required: true
         schema:
-          type: string
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: product,taxon
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: classification
+                      attributes:
+                        position: 1
+                        created_at: '2021-08-23T21:28:22.787Z'
+                        updated_at: '2021-08-23T21:28:22.787Z'
+                      relationships:
+                        product:
+                          data:
+                            id: '1'
+                            type: product
+                        taxon:
+                          data:
+                            id: '2'
+                            type: taxon
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    put:
+      summary: Updates a Classification
+      tags:
+      - Classifications
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: product,taxon
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: classification
+                      attributes:
+                        position: 1
+                        created_at: '2021-08-23T21:28:22.904Z'
+                        updated_at: '2021-08-23T21:28:22.904Z'
+                      relationships:
+                        product:
+                          data:
+                            id: '1'
+                            type: product
+                        taxon:
+                          data:
+                            id: '2'
+                            type: taxon
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Product can't be blank
+                    errors:
+                      product:
+                      - can't be blank
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/classifications_params"
+    delete:
+      summary: Deletes a Classification
+      tags:
+      - Classifications
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: Record deleted
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/classifications/{id}/reposition":
+    put:
+      summary: Reposition a Classification
+      tags:
+      - Classifications
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: product,taxon
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: classification
+                      attributes:
+                        position: 2
+                        created_at: '2021-08-23T21:28:23.191Z'
+                        updated_at: '2021-08-23T21:28:23.199Z'
+                      relationships:
+                        product:
+                          data:
+                            id: '1'
+                            type: product
+                        taxon:
+                          data:
+                            id: '2'
+                            type: taxon
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: is not a number
+                    errors: {}
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/classification_params"
+  "/api/v2/platform/countries":
+    get:
+      summary: Returns a list of Countries
+      tags:
+      - Countries
+      security:
+      - bearer_auth: []
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: country
+                      attributes:
+                        iso_name: UNITED STATES
+                        iso: US
+                        iso3: IS34
+                        name: United States of America
+                        numcode: 840
+                        states_required: true
+                        updated_at: '2021-08-23T21:28:23.328Z'
+                        zipcode_required: true
+                        created_at: '2021-08-23T21:28:23.328Z'
+                      relationships:
+                        states:
+                          data: []
+                    - id: '2'
+                      type: country
+                      attributes:
+                        iso_name: ISO_NAME_2
+                        iso: I2
+                        iso3: IS35
+                        name: NAME_2
+                        numcode: 840
+                        states_required: false
+                        updated_at: '2021-08-23T21:28:23.332Z'
+                        zipcode_required: true
+                        created_at: '2021-08-23T21:28:23.332Z'
+                      relationships:
+                        states:
+                          data: []
+                    - id: '3'
+                      type: country
+                      attributes:
+                        iso_name: ISO_NAME_3
+                        iso: I3
+                        iso3: IS36
+                        name: NAME_3
+                        numcode: 840
+                        states_required: false
+                        updated_at: '2021-08-23T21:28:23.333Z'
+                        zipcode_required: true
+                        created_at: '2021-08-23T21:28:23.333Z'
+                      relationships:
+                        states:
+                          data: []
+                    meta:
+                      count: 3
+                      total_count: 3
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/countries
+                      next: http://www.example.com/api/v2/platform/countries?page=1
+                      prev: http://www.example.com/api/v2/platform/countries?page=1
+                      last: http://www.example.com/api/v2/platform/countries?page=1
+                      first: http://www.example.com/api/v2/platform/countries?page=1
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/countries/{id}":
+    get:
+      summary: Returns a Country
+      tags:
+      - Countries
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: country
+                      attributes:
+                        iso_name: ISO_NAME_6
+                        iso: I6
+                        iso3: IS41
+                        name: NAME_6
+                        numcode: 840
+                        states_required: false
+                        updated_at: '2021-08-23T21:28:23.362Z'
+                        zipcode_required: true
+                        created_at: '2021-08-23T21:28:23.362Z'
+                      relationships:
+                        states:
+                          data: []
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/menu_items":
+    get:
+      summary: Returns a list of MenuItems
+      tags:
+      - MenuItems
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: page
+        in: query
+        example: 1
+        schema:
+          type: integer
+      - name: per_page
+        in: query
+        example: 50
+        schema:
+          type: integer
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: linked_resource
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example:
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: menu_item
+                      attributes:
+                        name: Quia ea unde minus sunt voluptatum iste repellendus.
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Container
+                        linked_resource_type: URL
+                        code:
+                        lft: 1
+                        rgt: 16
+                        depth: 0
+                        created_at: '2021-08-23T21:28:23.403Z'
+                        updated_at: '2021-08-23T21:28:23.479Z'
+                        link:
+                        is_container: true
+                        is_root: true
+                        is_child: false
+                        is_leaf: false
+                      relationships:
+                        icon:
+                          data:
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                        linked_resource:
+                          data:
+                        children:
+                          data:
+                          - id: '2'
+                            type: menu_item
+                          - id: '3'
+                            type: menu_item
+                          - id: '4'
+                            type: menu_item
+                          - id: '5'
+                            type: menu_item
+                          - id: '6'
+                            type: menu_item
+                          - id: '7'
+                            type: menu_item
+                          - id: '8'
+                            type: menu_item
+                    - id: '2'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 1 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 2
+                        rgt: 3
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.414Z'
+                        updated_at: '2021-08-23T21:28:23.416Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '1'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    - id: '3'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 2 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 4
+                        rgt: 5
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.425Z'
+                        updated_at: '2021-08-23T21:28:23.426Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '2'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    - id: '4'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 3 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 6
+                        rgt: 7
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.435Z'
+                        updated_at: '2021-08-23T21:28:23.436Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '3'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    - id: '5'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 4 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 8
+                        rgt: 9
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.444Z'
+                        updated_at: '2021-08-23T21:28:23.446Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '4'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    - id: '6'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 5 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 10
+                        rgt: 11
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.454Z'
+                        updated_at: '2021-08-23T21:28:23.456Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '5'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    - id: '7'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 6 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 12
+                        rgt: 13
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.464Z'
+                        updated_at: '2021-08-23T21:28:23.465Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '6'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    - id: '8'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 7 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 14
+                        rgt: 15
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.474Z'
+                        updated_at: '2021-08-23T21:28:23.475Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '7'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+                    meta:
+                      count: 8
+                      total_count: 8
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/menu_items?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/menu_items?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/menu_items?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/menu_items?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/menu_items?include=&page=1&per_page=
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    post:
+      summary: Creates a MenuItem
+      tags:
+      - MenuItems
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: linked_resource
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '5'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 18 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 8
+                        rgt: 9
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.637Z'
+                        updated_at: '2021-08-23T21:28:23.639Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank, Menu can't be blank, and Item type
+                      is not included in the list
+                    errors:
+                      name:
+                      - can't be blank
+                      menu:
+                      - can't be blank
+                      item_type:
+                      - is not included in the list
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/menu_items_params"
+  "/api/v2/platform/menu_items/{id}":
+    get:
+      summary: Returns a MenuItem
+      tags:
+      - MenuItems
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: linked_resource
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '5'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 25 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 8
+                        rgt: 9
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.746Z'
+                        updated_at: '2021-08-23T21:28:23.748Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '4'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    put:
+      summary: Updates a MenuItem
+      tags:
+      - MenuItems
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: linked_resource
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '5'
+                      type: menu_item
+                      attributes:
+                        name: Menu Item One
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 8
+                        rgt: 9
+                        depth: 1
+                        created_at: '2021-08-23T21:28:23.926Z'
+                        updated_at: '2021-08-23T21:28:23.937Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '4'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank
+                    errors:
+                      name:
+                      - can't be blank
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/menu_items_params"
+    delete:
+      summary: Deletes a MenuItem
+      tags:
+      - MenuItems
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: Record deleted
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+  "/api/v2/platform/menu_items/{id}/reposition":
+    patch:
+      summary: Reposition a Menu Item
+      tags:
+      - MenuItems
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: id
+        in: path
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '5'
+                      type: menu_item
+                      attributes:
+                        name: Link no. 62 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
+                        lft: 5
+                        rgt: 6
+                        depth: 2
+                        created_at: '2021-08-23T21:28:24.309Z'
+                        updated_at: '2021-08-23T21:28:24.321Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
+                          data:
+                            id: '4'
+                            type: icon
+                        menu:
+                          data:
+                            id: '1'
+                            type: menu
+                        parent:
+                          data:
+                            id: '3'
+                            type: menu_item
+                        linked_resource:
+                          data:
+                        children:
+                          data: []
+        '404':
+          description: Record not found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The resource you were looking for could not be found.
+        '401':
+          description: Authentication Failed
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/menu_item_reposition_params"
+  "/api/v2/platform/menus":
+    get:
+      summary: Returns a list of Menus
+      tags:
+      - Menus
+      security:
+      - bearer_auth: []
+      parameters:
+      - name: page
+        in: query
+        example: 1
+        schema:
+          type: integer
+      - name: per_page
+        in: query
+        example: 50
+        schema:
+          type: integer
       - name: include
         in: query
         description: 'Select which associated resources you would like to fetch, see:
           <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
-        example: product,taxon
+        example: menu_items
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: location_eq=header
         schema:
           type: string
       responses:
         '200':
-          description: Record found
+          description: Records returned
           content:
             application/vnd.api+json:
               examples:
                 Example:
                   value:
                     data:
-                      id: '1'
-                      type: classification
+                    - id: '1'
+                      type: menu
                       attributes:
-                        position: 1
-                        created_at: '2021-08-20T11:02:27.921Z'
-                        updated_at: '2021-08-20T11:02:27.921Z'
+                        name: Main Menu
+                        location: header
+                        locale: en
+                        created_at: '2021-08-23T21:28:24.436Z'
+                        updated_at: '2021-08-23T21:28:24.464Z'
                       relationships:
-                        product:
+                        menu_items:
                           data:
-                            id: '1'
-                            type: product
-                        taxon:
+                          - id: '1'
+                            type: menu_item
+                          - id: '3'
+                            type: menu_item
+                          - id: '4'
+                            type: menu_item
+                    - id: '2'
+                      type: menu
+                      attributes:
+                        name: Footer Menu
+                        location: footer
+                        locale: en
+                        created_at: '2021-08-23T21:28:24.440Z'
+                        updated_at: '2021-08-23T21:28:24.484Z'
+                      relationships:
+                        menu_items:
                           data:
-                            id: '2'
-                            type: taxon
-        '404':
-          description: Record not found
-          content:
-            application/vnd.api+json:
-              examples:
-                Example:
-                  value:
-                    error: The resource you were looking for could not be found.
+                          - id: '2'
+                            type: menu_item
+                          - id: '5'
+                            type: menu_item
+                          - id: '6'
+                            type: menu_item
+                    meta:
+                      count: 2
+                      total_count: 2
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/menus?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/menus?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/menus?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/menus?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/menus?include=&page=1&per_page=
         '401':
           description: Authentication Failed
           content:
@@ -599,28 +1736,23 @@ paths:
                 Example:
                   value:
                     error: The access token is invalid
-    put:
-      summary: Updates a Classification
+    post:
+      summary: Creates a Menu
       tags:
-      - Classifications
+      - Menus
       security:
       - bearer_auth: []
       parameters:
-      - name: id
-        in: path
-        required: true
-        schema:
-          type: string
       - name: include
         in: query
         description: 'Select which associated resources you would like to fetch, see:
           <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
-        example: product,taxon
+        example: menu_items
         schema:
           type: string
       responses:
-        '200':
-          description: record updated
+        '201':
+          description: record created
           content:
             application/vnd.api+json:
               examples:
@@ -628,20 +1760,18 @@ paths:
                   value:
                     data:
                       id: '1'
-                      type: classification
+                      type: menu
                       attributes:
-                        position: 1
-                        created_at: '2021-08-20T11:02:28.202Z'
-                        updated_at: '2021-08-20T11:02:28.202Z'
+                        name: Main Menu
+                        location: header
+                        locale: en
+                        created_at: '2021-08-23T21:28:24.595Z'
+                        updated_at: '2021-08-23T21:28:24.598Z'
                       relationships:
-                        product:
-                          data:
-                            id: '1'
-                            type: product
-                        taxon:
+                        menu_items:
                           data:
-                            id: '2'
-                            type: taxon
+                          - id: '1'
+                            type: menu_item
         '422':
           description: invalid request
           content:
@@ -649,35 +1779,25 @@ paths:
               examples:
                 Example:
                   value:
-                    error: Product can't be blank
+                    error: Name can't be blank, Locale can't be blank, and Location
+                      is not included in the list
                     errors:
-                      product:
+                      name:
                       - can't be blank
-        '404':
-          description: Record not found
-          content:
-            application/vnd.api+json:
-              examples:
-                Example:
-                  value:
-                    error: The resource you were looking for could not be found.
-        '401':
-          description: Authentication Failed
-          content:
-            application/vnd.api+json:
-              examples:
-                Example:
-                  value:
-                    error: The access token is invalid
+                      locale:
+                      - can't be blank
+                      location:
+                      - is not included in the list
       requestBody:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/classification_params"
-    delete:
-      summary: Deletes a Classification
+              "$ref": "#/components/schemas/menus_params"
+  "/api/v2/platform/menus/{id}":
+    get:
+      summary: Returns a Menu
       tags:
-      - Classifications
+      - Menus
       security:
       - bearer_auth: []
       parameters:
@@ -686,9 +1806,35 @@ paths:
         required: true
         schema:
           type: string
+      - name: include
+        in: query
+        description: 'Select which associated resources you would like to fetch, see:
+          <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
+        example: menu_items
+        schema:
+          type: string
       responses:
-        '204':
-          description: Record deleted
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: menu
+                      attributes:
+                        name: Main Menu
+                        location: header
+                        locale: en
+                        created_at: '2021-08-23T21:28:24.622Z'
+                        updated_at: '2021-08-23T21:28:24.625Z'
+                      relationships:
+                        menu_items:
+                          data:
+                          - id: '1'
+                            type: menu_item
         '404':
           description: Record not found
           content:
@@ -705,11 +1851,10 @@ paths:
                 Example:
                   value:
                     error: The access token is invalid
-  "/api/v2/platform/classifications/{id}/reposition":
     put:
-      summary: Reposition a Classification
+      summary: Updates a Menu
       tags:
-      - Classifications
+      - Menus
       security:
       - bearer_auth: []
       parameters:
@@ -722,7 +1867,7 @@ paths:
         in: query
         description: 'Select which associated resources you would like to fetch, see:
           <a href="https://jsonapi.org/format/#fetching-includes">https://jsonapi.org/format/#fetching-includes</a>'
-        example: product,taxon
+        example: menu_items
         schema:
           type: string
       responses:
@@ -735,20 +1880,18 @@ paths:
                   value:
                     data:
                       id: '1'
-                      type: classification
+                      type: menu
                       attributes:
-                        position: 2
-                        created_at: '2021-08-20T11:02:28.904Z'
-                        updated_at: '2021-08-20T11:02:28.922Z'
+                        name: Main Menu
+                        location: header
+                        locale: en
+                        created_at: '2021-08-23T21:28:24.664Z'
+                        updated_at: '2021-08-23T21:28:24.667Z'
                       relationships:
-                        product:
-                          data:
-                            id: '1'
-                            type: product
-                        taxon:
+                        menu_items:
                           data:
-                            id: '2'
-                            type: taxon
+                          - id: '1'
+                            type: menu_item
         '422':
           description: invalid request
           content:
@@ -756,8 +1899,15 @@ paths:
               examples:
                 Example:
                   value:
-                    error: is not a number
-                    errors: {}
+                    error: Name can't be blank, Locale can't be blank, and Location
+                      is not included in the list
+                    errors:
+                      name:
+                      - can't be blank
+                      locale:
+                      - can't be blank
+                      location:
+                      - is not included in the list
         '404':
           description: Record not found
           content:
@@ -778,91 +1928,11 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/classification_params"
-  "/api/v2/platform/countries":
-    get:
-      summary: Returns a list of Countries
-      tags:
-      - Countries
-      security:
-      - bearer_auth: []
-      responses:
-        '200':
-          description: Records returned
-          content:
-            application/vnd.api+json:
-              examples:
-                Example:
-                  value:
-                    data:
-                    - id: '1'
-                      type: country
-                      attributes:
-                        iso_name: UNITED STATES
-                        iso: US
-                        iso3: IS34
-                        name: United States of America
-                        numcode: 840
-                        states_required: true
-                        updated_at: '2021-08-20T11:02:29.220Z'
-                        zipcode_required: true
-                        created_at: '2021-08-20T11:02:29.220Z'
-                      relationships:
-                        states:
-                          data: []
-                    - id: '2'
-                      type: country
-                      attributes:
-                        iso_name: ISO_NAME_2
-                        iso: I2
-                        iso3: IS35
-                        name: NAME_2
-                        numcode: 840
-                        states_required: false
-                        updated_at: '2021-08-20T11:02:29.229Z'
-                        zipcode_required: true
-                        created_at: '2021-08-20T11:02:29.229Z'
-                      relationships:
-                        states:
-                          data: []
-                    - id: '3'
-                      type: country
-                      attributes:
-                        iso_name: ISO_NAME_3
-                        iso: I3
-                        iso3: IS36
-                        name: NAME_3
-                        numcode: 840
-                        states_required: false
-                        updated_at: '2021-08-20T11:02:29.231Z'
-                        zipcode_required: true
-                        created_at: '2021-08-20T11:02:29.231Z'
-                      relationships:
-                        states:
-                          data: []
-                    meta:
-                      count: 3
-                      total_count: 3
-                      total_pages: 1
-                    links:
-                      self: http://www.example.com/api/v2/platform/countries
-                      next: http://www.example.com/api/v2/platform/countries?page=1
-                      prev: http://www.example.com/api/v2/platform/countries?page=1
-                      last: http://www.example.com/api/v2/platform/countries?page=1
-                      first: http://www.example.com/api/v2/platform/countries?page=1
-        '401':
-          description: Authentication Failed
-          content:
-            application/vnd.api+json:
-              examples:
-                Example:
-                  value:
-                    error: The access token is invalid
-  "/api/v2/platform/countries/{id}":
-    get:
-      summary: Returns a Country
+              "$ref": "#/components/schemas/menus_params"
+    delete:
+      summary: Deletes a Menu
       tags:
-      - Countries
+      - Menus
       security:
       - bearer_auth: []
       parameters:
@@ -872,29 +1942,8 @@ paths:
         schema:
           type: string
       responses:
-        '200':
-          description: Record found
-          content:
-            application/vnd.api+json:
-              examples:
-                Example:
-                  value:
-                    data:
-                      id: '2'
-                      type: country
-                      attributes:
-                        iso_name: ISO_NAME_6
-                        iso: I6
-                        iso3: IS41
-                        name: NAME_6
-                        numcode: 840
-                        states_required: false
-                        updated_at: '2021-08-20T11:02:29.297Z'
-                        zipcode_required: true
-                        created_at: '2021-08-20T11:02:29.297Z'
-                      relationships:
-                        states:
-                          data: []
+        '204':
+          description: Record deleted
         '404':
           description: Record not found
           content:
@@ -957,8 +2006,8 @@ paths:
                         name: foo-size-1
                         presentation: Size
                         position: 1
-                        created_at: '2021-08-20T11:02:29.373Z'
-                        updated_at: '2021-08-20T11:02:29.373Z'
+                        created_at: '2021-08-23T21:28:24.774Z'
+                        updated_at: '2021-08-23T21:28:24.774Z'
                         filterable: true
                       relationships:
                         option_values:
@@ -969,8 +2018,8 @@ paths:
                         name: foo-size-2
                         presentation: Size
                         position: 2
-                        created_at: '2021-08-20T11:02:29.375Z'
-                        updated_at: '2021-08-20T11:02:29.375Z'
+                        created_at: '2021-08-23T21:28:24.775Z'
+                        updated_at: '2021-08-23T21:28:24.775Z'
                         filterable: true
                       relationships:
                         option_values:
@@ -1022,8 +2071,8 @@ paths:
                         name: foo-size-5
                         presentation: Size
                         position: 1
-                        created_at: '2021-08-20T11:02:29.453Z'
-                        updated_at: '2021-08-20T11:02:29.453Z'
+                        created_at: '2021-08-23T21:28:24.807Z'
+                        updated_at: '2021-08-23T21:28:24.807Z'
                         filterable: true
                       relationships:
                         option_values:
@@ -1045,7 +2094,7 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/optiontype_params"
+              "$ref": "#/components/schemas/option_types_params"
   "/api/v2/platform/option_types/{id}":
     get:
       summary: Returns an OptionType
@@ -1081,8 +2130,8 @@ paths:
                         name: foo-size-6
                         presentation: Size
                         position: 1
-                        created_at: '2021-08-20T11:02:29.497Z'
-                        updated_at: '2021-08-20T11:02:29.497Z'
+                        created_at: '2021-08-23T21:28:24.829Z'
+                        updated_at: '2021-08-23T21:28:24.829Z'
                         filterable: true
                       relationships:
                         option_values:
@@ -1137,8 +2186,8 @@ paths:
                         name: Size-X
                         presentation: Size
                         position: 1
-                        created_at: '2021-08-20T11:02:29.580Z'
-                        updated_at: '2021-08-20T11:02:29.591Z'
+                        created_at: '2021-08-23T21:28:24.867Z'
+                        updated_at: '2021-08-23T21:28:24.871Z'
                         filterable: true
                       relationships:
                         option_values:
@@ -1174,7 +2223,7 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/optiontype_params"
+              "$ref": "#/components/schemas/option_types_params"
     delete:
       summary: Deletes an OptionType
       tags:
@@ -1252,8 +2301,8 @@ paths:
                         position: 1
                         name: Size-1
                         presentation: S
-                        created_at: '2021-08-20T11:02:29.758Z'
-                        updated_at: '2021-08-20T11:02:29.758Z'
+                        created_at: '2021-08-23T21:28:24.950Z'
+                        updated_at: '2021-08-23T21:28:24.950Z'
                       relationships:
                         option_type:
                           data:
@@ -1265,8 +2314,8 @@ paths:
                         position: 1
                         name: Size-2
                         presentation: S
-                        created_at: '2021-08-20T11:02:29.763Z'
-                        updated_at: '2021-08-20T11:02:29.763Z'
+                        created_at: '2021-08-23T21:28:24.952Z'
+                        updated_at: '2021-08-23T21:28:24.952Z'
                       relationships:
                         option_type:
                           data:
@@ -1319,8 +2368,8 @@ paths:
                         position: 1
                         name: Size-5
                         presentation: S
-                        created_at: '2021-08-20T11:02:29.842Z'
-                        updated_at: '2021-08-20T11:02:29.842Z'
+                        created_at: '2021-08-23T21:28:24.988Z'
+                        updated_at: '2021-08-23T21:28:24.988Z'
                       relationships:
                         option_type:
                           data:
@@ -1341,7 +2390,7 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/optionvalue_params"
+              "$ref": "#/components/schemas/option_values_params"
   "/api/v2/platform/option_values/{id}":
     get:
       summary: Returns an OptionValue
@@ -1377,8 +2426,8 @@ paths:
                         position: 1
                         name: Size-6
                         presentation: S
-                        created_at: '2021-08-20T11:02:29.890Z'
-                        updated_at: '2021-08-20T11:02:29.890Z'
+                        created_at: '2021-08-23T21:28:25.015Z'
+                        updated_at: '2021-08-23T21:28:25.015Z'
                       relationships:
                         option_type:
                           data:
@@ -1434,8 +2483,8 @@ paths:
                         position: 1
                         name: M
                         presentation: S
-                        created_at: '2021-08-20T11:02:29.959Z'
-                        updated_at: '2021-08-20T11:02:29.973Z'
+                        created_at: '2021-08-23T21:28:25.052Z'
+                        updated_at: '2021-08-23T21:28:25.056Z'
                       relationships:
                         option_type:
                           data:
@@ -1472,7 +2521,7 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/optionvalue_params"
+              "$ref": "#/components/schemas/option_values_params"
     delete:
       summary: Deletes an OptionValue
       tags:
@@ -1553,8 +2602,8 @@ paths:
                         lft: 1
                         rgt: 6
                         description:
-                        created_at: '2021-08-20T11:02:30.161Z'
-                        updated_at: '2021-08-20T11:02:30.221Z'
+                        created_at: '2021-08-23T21:28:25.145Z'
+                        updated_at: '2021-08-23T21:28:25.172Z'
                         meta_title:
                         meta_description:
                         meta_keywords:
@@ -1588,8 +2637,8 @@ paths:
                         lft: 2
                         rgt: 3
                         description:
-                        created_at: '2021-08-20T11:02:30.183Z'
-                        updated_at: '2021-08-20T11:02:30.187Z'
+                        created_at: '2021-08-23T21:28:25.156Z'
+                        updated_at: '2021-08-23T21:28:25.157Z'
                         meta_title:
                         meta_description:
                         meta_keywords:
@@ -1623,8 +2672,8 @@ paths:
                         lft: 4
                         rgt: 5
                         description:
-                        created_at: '2021-08-20T11:02:30.208Z'
-                        updated_at: '2021-08-20T11:02:30.212Z'
+                        created_at: '2021-08-23T21:28:25.167Z'
+                        updated_at: '2021-08-23T21:28:25.168Z'
                         meta_title:
                         meta_description:
                         meta_keywords:
@@ -1699,8 +2748,8 @@ paths:
                         lft: 2
                         rgt: 3
                         description:
-                        created_at: '2021-08-20T11:02:30.393Z'
-                        updated_at: '2021-08-20T11:02:30.397Z'
+                        created_at: '2021-08-23T21:28:25.251Z'
+                        updated_at: '2021-08-23T21:28:25.254Z'
                         meta_title:
                         meta_description:
                         meta_keywords:
@@ -1740,7 +2789,7 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/taxon_params"
+              "$ref": "#/components/schemas/taxons_params"
   "/api/v2/platform/taxons/{id}":
     get:
       summary: Returns a Taxon
@@ -1779,8 +2828,8 @@ paths:
                         lft: 2
                         rgt: 3
                         description:
-                        created_at: '2021-08-20T11:02:30.484Z'
-                        updated_at: '2021-08-20T11:02:30.488Z'
+                        created_at: '2021-08-23T21:28:25.291Z'
+                        updated_at: '2021-08-23T21:28:25.293Z'
                         meta_title:
                         meta_description:
                         meta_keywords:
@@ -1860,8 +2909,8 @@ paths:
                         lft: 2
                         rgt: 3
                         description:
-                        created_at: '2021-08-20T11:02:30.652Z'
-                        updated_at: '2021-08-20T11:02:30.675Z'
+                        created_at: '2021-08-23T21:28:25.371Z'
+                        updated_at: '2021-08-23T21:28:25.383Z'
                         meta_title:
                         meta_description:
                         meta_keywords:
@@ -1917,7 +2966,7 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/taxon_params"
+              "$ref": "#/components/schemas/taxons_params"
     delete:
       summary: Deletes a Taxon
       tags:
@@ -1992,9 +3041,9 @@ paths:
                     - id: '1'
                       type: user
                       attributes:
-                        email: jasper@dooley.co.uk
-                        created_at: '2021-08-20T11:02:31.076Z'
-                        updated_at: '2021-08-20T11:02:31.076Z'
+                        email: vernetta@huels.co.uk
+                        created_at: '2021-08-23T21:28:25.546Z'
+                        updated_at: '2021-08-23T21:28:25.546Z'
                         average_order_value: []
                         lifetime_value: []
                         store_credits: []
@@ -2006,9 +3055,9 @@ paths:
                     - id: '2'
                       type: user
                       attributes:
-                        email: shanice.breitenberg@labadie.ca
-                        created_at: '2021-08-20T11:02:31.087Z'
-                        updated_at: '2021-08-20T11:02:31.087Z'
+                        email: pansy_hirthe@smitham.us
+                        created_at: '2021-08-23T21:28:25.549Z'
+                        updated_at: '2021-08-23T21:28:25.549Z'
                         average_order_value: []
                         lifetime_value: []
                         store_credits: []
@@ -2020,9 +3069,9 @@ paths:
                     - id: '3'
                       type: user
                       attributes:
-                        email: tristan@reilly.co.uk
-                        created_at: '2021-08-20T11:02:31.090Z'
-                        updated_at: '2021-08-20T11:02:31.090Z'
+                        email: carmen.kerluke@kossschulist.com
+                        created_at: '2021-08-23T21:28:25.550Z'
+                        updated_at: '2021-08-23T21:28:25.550Z'
                         average_order_value: []
                         lifetime_value: []
                         store_credits: []
@@ -2075,9 +3124,9 @@ paths:
                       id: '2'
                       type: user
                       attributes:
-                        email: joan@little.info
-                        created_at: '2021-08-20T11:02:31.214Z'
-                        updated_at: '2021-08-20T11:02:31.214Z'
+                        email: marx_feil@borer.info
+                        created_at: '2021-08-23T21:28:25.597Z'
+                        updated_at: '2021-08-23T21:28:25.597Z'
                         average_order_value: []
                         lifetime_value: []
                         store_credits: []
@@ -2101,7 +3150,7 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/user_params"
+              "$ref": "#/components/schemas/users_params"
   "/api/v2/platform/users/{id}":
     get:
       summary: Returns an User
@@ -2134,9 +3183,9 @@ paths:
                       id: '2'
                       type: user
                       attributes:
-                        email: morris@goyettecormier.com
-                        created_at: '2021-08-20T11:02:31.290Z'
-                        updated_at: '2021-08-20T11:02:31.290Z'
+                        email: stefany@leannon.biz
+                        created_at: '2021-08-23T21:28:25.626Z'
+                        updated_at: '2021-08-23T21:28:25.626Z'
                         average_order_value: []
                         lifetime_value: []
                         store_credits: []
@@ -2193,8 +3242,8 @@ paths:
                       type: user
                       attributes:
                         email: john@example.com
-                        created_at: '2021-08-20T11:02:31.401Z'
-                        updated_at: '2021-08-20T11:02:31.417Z'
+                        created_at: '2021-08-23T21:28:25.669Z'
+                        updated_at: '2021-08-23T21:28:25.673Z'
                         average_order_value: []
                         lifetime_value: []
                         store_credits: []
@@ -2234,7 +3283,7 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/user_params"
+              "$ref": "#/components/schemas/users_params"
     delete:
       summary: Deletes an User
       tags:
@@ -2419,6 +3468,49 @@ components:
       required:
       - name
       - taxonomy_id
+    menu_params:
+      type: object
+      properties:
+        name:
+          type: string
+        location:
+          type: string
+        locale:
+          type: string
+      required:
+      - name
+      - location
+      - locale
+    menu_item_params:
+      type: object
+      properties:
+        name:
+          type: string
+        code:
+          type: string
+        subtitle:
+          type: string
+        destination:
+          type: string
+        new_window:
+          type: boolean
+        item_type:
+          type: string
+        linked_resource_type:
+          type: string
+        linked_resource_id:
+          type: integer
+      required:
+      - name
+    menu_item_reposition_params:
+      type: object
+      properties:
+        new_parent_id:
+          type: integer
+        new_position_idx:
+          type: integer
+      required:
+      - name
     resources_list:
       type: object
       properties: