spree_api 4.3.0.rc1 → 4.3.1

data/docs/v2/platform/index.yaml

@@ -2,6 +2,10 @@
 openapi: 3.0.1
 info:
   title: Platform API V2
+  contact:
+    name: Spark Solutions
+    url: https://sparksolutions.co
+    email: we@sparksolutions.co
   version: v2
 paths:
   "/api/v2/platform/addresses":
@@ -11,6 +15,8 @@ paths:
       - Addresses
       security:
       - bearer_auth: []
+      description: Returns a list of Addresses
+      operationId: addresses-list
       parameters:
       - name: page
         in: query
@@ -24,14 +30,14 @@ paths:
           type: integer
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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: user,country,state
         schema:
           type: string
       - name: filter
         in: query
-        descripton: ''
+        description: ''
         example: user_id_eq=1&firstname_cont=Joh
         schema:
           type: string
@@ -57,8 +63,8 @@ paths:
                         state_name:
                         alternative_phone: 555-555-0199
                         company: Company
-                        created_at: '2021-08-06T06:53:18.846Z'
-                        updated_at: '2021-08-06T06:53:18.846Z'
+                        created_at: '2021-08-30T22:29:07.024Z'
+                        updated_at: '2021-08-30T22:29:07.024Z'
                         deleted_at:
                         label:
                       relationships:
@@ -85,8 +91,8 @@ paths:
                         state_name:
                         alternative_phone: 555-555-0199
                         company: Company
-                        created_at: '2021-08-06T06:53:18.853Z'
-                        updated_at: '2021-08-06T06:53:18.853Z'
+                        created_at: '2021-08-30T22:29:07.026Z'
+                        updated_at: '2021-08-30T22:29:07.026Z'
                         deleted_at:
                         label:
                       relationships:
@@ -124,10 +130,12 @@ paths:
       - Addresses
       security:
       - bearer_auth: []
+      description: Creates an Address
+      operationId: create-address
       parameters:
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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: user,country,state
         schema:
@@ -141,7 +149,7 @@ paths:
                 Example:
                   value:
                     data:
-                      id: '5'
+                      id: '1'
                       type: address
                       attributes:
                         firstname: John
@@ -154,18 +162,18 @@ paths:
                         state_name:
                         alternative_phone: 555-555-0199
                         company: Company
-                        created_at: '2021-08-06T06:53:19.077Z'
-                        updated_at: '2021-08-06T06:53:19.077Z'
+                        created_at: '2021-08-30T22:29:07.137Z'
+                        updated_at: '2021-08-30T22:29:07.137Z'
                         deleted_at:
                         label:
                       relationships:
                         country:
                           data:
-                            id: '4'
+                            id: '2'
                             type: country
                         state:
                           data:
-                            id: '5'
+                            id: '1'
                             type: state
                         user:
                           data:
@@ -208,6 +216,8 @@ paths:
       - Addresses
       security:
       - bearer_auth: []
+      description: Returns an Address
+      operationId: show-address
       parameters:
       - name: id
         in: path
@@ -216,7 +226,7 @@ paths:
           type: string
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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: user,country,state
         schema:
@@ -230,7 +240,7 @@ paths:
                 Example:
                   value:
                     data:
-                      id: '6'
+                      id: '1'
                       type: address
                       attributes:
                         firstname: John
@@ -243,18 +253,18 @@ paths:
                         state_name:
                         alternative_phone: 555-555-0199
                         company: Company
-                        created_at: '2021-08-06T06:53:19.150Z'
-                        updated_at: '2021-08-06T06:53:19.150Z'
+                        created_at: '2021-08-30T22:29:07.160Z'
+                        updated_at: '2021-08-30T22:29:07.160Z'
                         deleted_at:
                         label:
                       relationships:
                         country:
                           data:
-                            id: '6'
+                            id: '1'
                             type: country
                         state:
                           data:
-                            id: '6'
+                            id: '1'
                             type: state
                         user:
                           data:
@@ -280,6 +290,8 @@ paths:
       - Addresses
       security:
       - bearer_auth: []
+      description: Updates an Address
+      operationId: update-address
       parameters:
       - name: id
         in: path
@@ -288,7 +300,7 @@ paths:
           type: string
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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: user,country,state
         schema:
@@ -302,7 +314,7 @@ paths:
                 Example:
                   value:
                     data:
-                      id: '8'
+                      id: '1'
                       type: address
                       attributes:
                         firstname: Jack
@@ -315,18 +327,18 @@ paths:
                         state_name:
                         alternative_phone: 555-555-0199
                         company: Company
-                        created_at: '2021-08-06T06:53:19.236Z'
-                        updated_at: '2021-08-06T06:53:19.247Z'
+                        created_at: '2021-08-30T22:29:07.192Z'
+                        updated_at: '2021-08-30T22:29:07.196Z'
                         deleted_at:
                         label:
                       relationships:
                         country:
                           data:
-                            id: '9'
+                            id: '1'
                             type: country
                         state:
                           data:
-                            id: '8'
+                            id: '1'
                             type: state
                         user:
                           data:
@@ -370,6 +382,8 @@ paths:
       - Addresses
       security:
       - bearer_auth: []
+      description: Deletes an Address
+      operationId: delete-address
       parameters:
       - name: id
         in: path
@@ -402,6 +416,8 @@ paths:
       - Classifications
       security:
       - bearer_auth: []
+      description: Returns a list of Classifications
+      operationId: classifications-list
       parameters:
       - name: page
         in: query
@@ -415,14 +431,14 @@ paths:
           type: integer
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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
       - name: filter
         in: query
-        descripton: ''
+        description: ''
         example: taxon_id_eq=1
         schema:
           type: string
@@ -439,8 +455,8 @@ paths:
                       type: classification
                       attributes:
                         position: 1
-                        created_at: '2021-08-06T06:53:19.739Z'
-                        updated_at: '2021-08-06T06:53:19.739Z'
+                        created_at: '2021-08-30T22:29:07.400Z'
+                        updated_at: '2021-08-30T22:29:07.400Z'
                       relationships:
                         product:
                           data:
@@ -454,8 +470,8 @@ paths:
                       type: classification
                       attributes:
                         position: 1
-                        created_at: '2021-08-06T06:53:19.836Z'
-                        updated_at: '2021-08-06T06:53:19.836Z'
+                        created_at: '2021-08-30T22:29:07.447Z'
+                        updated_at: '2021-08-30T22:29:07.447Z'
                       relationships:
                         product:
                           data:
@@ -489,10 +505,12 @@ paths:
       - Classifications
       security:
       - bearer_auth: []
+      description: Creates a Classification
+      operationId: create-classification
       parameters:
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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:
@@ -506,20 +524,20 @@ paths:
                 Example:
                   value:
                     data:
-                      id: '5'
+                      id: '1'
                       type: classification
                       attributes:
                         position: 1
-                        created_at: '2021-08-06T06:53:20.242Z'
-                        updated_at: '2021-08-06T06:53:20.242Z'
+                        created_at: '2021-08-30T22:29:07.600Z'
+                        updated_at: '2021-08-30T22:29:07.600Z'
                       relationships:
                         product:
                           data:
-                            id: '5'
+                            id: '1'
                             type: product
                         taxon:
                           data:
-                            id: '10'
+                            id: '2'
                             type: taxon
         '422':
           description: invalid request
@@ -546,6 +564,8 @@ paths:
       - Classifications
       security:
       - bearer_auth: []
+      description: Returns a Classification
+      operationId: show-classification
       parameters:
       - name: id
         in: path
@@ -554,7 +574,7 @@ paths:
           type: string
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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:
@@ -568,20 +588,20 @@ paths:
                 Example:
                   value:
                     data:
-                      id: '6'
+                      id: '1'
                       type: classification
                       attributes:
                         position: 1
-                        created_at: '2021-08-06T06:53:20.399Z'
-                        updated_at: '2021-08-06T06:53:20.399Z'
+                        created_at: '2021-08-30T22:29:07.667Z'
+                        updated_at: '2021-08-30T22:29:07.667Z'
                       relationships:
                         product:
                           data:
-                            id: '6'
+                            id: '1'
                             type: product
                         taxon:
                           data:
-                            id: '12'
+                            id: '2'
                             type: taxon
         '404':
           description: Record not found
@@ -605,6 +625,8 @@ paths:
       - Classifications
       security:
       - bearer_auth: []
+      description: Updates a Classification
+      operationId: update-classification
       parameters:
       - name: id
         in: path
@@ -613,7 +635,7 @@ paths:
           type: string
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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:
@@ -627,20 +649,20 @@ paths:
                 Example:
                   value:
                     data:
-                      id: '8'
+                      id: '1'
                       type: classification
                       attributes:
                         position: 1
-                        created_at: '2021-08-06T06:53:20.705Z'
-                        updated_at: '2021-08-06T06:53:20.705Z'
+                        created_at: '2021-08-30T22:29:07.783Z'
+                        updated_at: '2021-08-30T22:29:07.783Z'
                       relationships:
                         product:
                           data:
-                            id: '8'
+                            id: '1'
                             type: product
                         taxon:
                           data:
-                            id: '16'
+                            id: '2'
                             type: taxon
         '422':
           description: invalid request
@@ -680,6 +702,8 @@ paths:
       - Classifications
       security:
       - bearer_auth: []
+      description: Deletes a Classification
+      operationId: delete-classification
       parameters:
       - name: id
         in: path
@@ -712,6 +736,8 @@ paths:
       - Classifications
       security:
       - bearer_auth: []
+      operationId: reposition-classification
+      description: Reposition a Classification
       parameters:
       - name: id
         in: path
@@ -720,7 +746,7 @@ paths:
           type: string
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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:
@@ -734,20 +760,20 @@ paths:
                 Example:
                   value:
                     data:
-                      id: '13'
+                      id: '1'
                       type: classification
                       attributes:
                         position: 2
-                        created_at: '2021-08-06T06:53:21.437Z'
-                        updated_at: '2021-08-06T06:53:21.461Z'
+                        created_at: '2021-08-30T22:29:08.086Z'
+                        updated_at: '2021-08-30T22:29:08.095Z'
                       relationships:
                         product:
                           data:
-                            id: '13'
+                            id: '1'
                             type: product
                         taxon:
                           data:
-                            id: '26'
+                            id: '2'
                             type: taxon
         '422':
           description: invalid request
@@ -786,6 +812,8 @@ paths:
       - Countries
       security:
       - bearer_auth: []
+      operationId: countries-list
+      description: Returns a list of Countries
       responses:
         '200':
           description: Records returned
@@ -795,7 +823,7 @@ paths:
                 Example:
                   value:
                     data:
-                    - id: '34'
+                    - id: '1'
                       type: country
                       attributes:
                         iso_name: UNITED STATES
@@ -804,13 +832,13 @@ paths:
                         name: United States of America
                         numcode: 840
                         states_required: true
-                        updated_at: '2021-08-06T06:53:21.782Z'
+                        updated_at: '2021-08-30T22:29:08.218Z'
                         zipcode_required: true
-                        created_at: '2021-08-06T06:53:21.782Z'
+                        created_at: '2021-08-30T22:29:08.218Z'
                       relationships:
                         states:
                           data: []
-                    - id: '35'
+                    - id: '2'
                       type: country
                       attributes:
                         iso_name: ISO_NAME_2
@@ -819,13 +847,13 @@ paths:
                         name: NAME_2
                         numcode: 840
                         states_required: false
-                        updated_at: '2021-08-06T06:53:21.793Z'
+                        updated_at: '2021-08-30T22:29:08.222Z'
                         zipcode_required: true
-                        created_at: '2021-08-06T06:53:21.793Z'
+                        created_at: '2021-08-30T22:29:08.222Z'
                       relationships:
                         states:
                           data: []
-                    - id: '36'
+                    - id: '3'
                       type: country
                       attributes:
                         iso_name: ISO_NAME_3
@@ -834,9 +862,9 @@ paths:
                         name: NAME_3
                         numcode: 840
                         states_required: false
-                        updated_at: '2021-08-06T06:53:21.796Z'
+                        updated_at: '2021-08-30T22:29:08.223Z'
                         zipcode_required: true
-                        created_at: '2021-08-06T06:53:21.796Z'
+                        created_at: '2021-08-30T22:29:08.223Z'
                       relationships:
                         states:
                           data: []
@@ -865,6 +893,8 @@ paths:
       - Countries
       security:
       - bearer_auth: []
+      operationId: show-country
+      description: Returns a Country
       parameters:
       - name: id
         in: path
@@ -880,7 +910,7 @@ paths:
                 Example:
                   value:
                     data:
-                      id: '41'
+                      id: '2'
                       type: country
                       attributes:
                         iso_name: ISO_NAME_6
@@ -889,9 +919,9 @@ paths:
                         name: NAME_6
                         numcode: 840
                         states_required: false
-                        updated_at: '2021-08-06T06:53:21.864Z'
+                        updated_at: '2021-08-30T22:29:08.259Z'
                         zipcode_required: true
-                        created_at: '2021-08-06T06:53:21.864Z'
+                        created_at: '2021-08-30T22:29:08.259Z'
                       relationships:
                         states:
                           data: []
@@ -911,13 +941,15 @@ paths:
                 Example:
                   value:
                     error: The access token is invalid
-  "/api/v2/platform/taxons":
+  "/api/v2/platform/menu_items":
     get:
-      summary: Returns a list of Taxons
+      summary: Returns a list of Menu Items
       tags:
-      - Taxons
+      - Menu Items
       security:
       - bearer_auth: []
+      description: Returns a list of Menu Items
+      operationId: menu-items-list
       parameters:
       - name: page
         in: query
@@ -931,15 +963,15 @@ paths:
           type: integer
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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: taxonomy,parent,children
+        example: linked_resource
         schema:
           type: string
       - name: filter
         in: query
-        descripton: ''
-        example: taxonomy_id_eq=1&name_cont=Shirts
+        description: ''
+        example: menu_item_name_eq=Women
         schema:
           type: string
       responses:
@@ -951,121 +983,322 @@ paths:
                 Example:
                   value:
                     data:
-                    - id: '32'
-                      type: taxon
+                    - id: '1'
+                      type: menu_item
                       attributes:
-                        position: 0
-                        name: taxon_16
-                        permalink: taxonomy-16/taxon-16
+                        name: Corporis deleniti vel necessitatibus laborum aliquid.
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Container
+                        linked_resource_type: URL
+                        code:
+                        lft: 1
+                        rgt: 16
+                        depth: 0
+                        created_at: '2021-08-30T22:29:08.302Z'
+                        updated_at: '2021-08-30T22:29:08.383Z'
+                        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
-                        description:
-                        created_at: '2021-08-06T06:53:21.978Z'
-                        updated_at: '2021-08-06T06:53:21.982Z'
-                        meta_title:
-                        meta_description:
-                        meta_keywords:
                         depth: 1
-                        pretty_name: taxonomy_16 -> taxon_16
-                        seo_title: taxon_16
+                        created_at: '2021-08-30T22:29:08.314Z'
+                        updated_at: '2021-08-30T22:29:08.316Z'
+                        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: '31'
-                            type: taxon
-                        taxonomy:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
                           data:
-                            id: '16'
-                            type: taxonomy
                         children:
                           data: []
-                        image:
-                          data:
-                            id: '16'
-                            type: taxon_image
-                    - id: '33'
-                      type: taxon
+                    - id: '3'
+                      type: menu_item
                       attributes:
-                        position: 0
-                        name: taxon_17
-                        permalink: taxonomy-16/taxon-17
+                        name: Link no. 2 To Somewhere
+                        subtitle:
+                        destination:
+                        new_window: false
+                        item_type: Link
+                        linked_resource_type: URL
+                        code:
                         lft: 4
                         rgt: 5
-                        description:
-                        created_at: '2021-08-06T06:53:22.008Z'
-                        updated_at: '2021-08-06T06:53:22.013Z'
-                        meta_title:
-                        meta_description:
-                        meta_keywords:
                         depth: 1
-                        pretty_name: taxonomy_16 -> taxon_17
-                        seo_title: taxon_17
+                        created_at: '2021-08-30T22:29:08.325Z'
+                        updated_at: '2021-08-30T22:29:08.327Z'
+                        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: '31'
-                            type: taxon
-                        taxonomy:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
                           data:
-                            id: '16'
-                            type: taxonomy
                         children:
                           data: []
-                        image:
+                    - 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-30T22:29:08.336Z'
+                        updated_at: '2021-08-30T22:29:08.337Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
                           data:
-                            id: '17'
-                            type: taxon_image
-                    - id: '31'
-                      type: taxon
+                            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:
-                        position: 0
-                        name: taxonomy_16
-                        permalink: taxonomy-16
-                        lft: 1
-                        rgt: 6
-                        description:
-                        created_at: '2021-08-06T06:53:21.950Z'
-                        updated_at: '2021-08-06T06:53:22.027Z'
-                        meta_title:
-                        meta_description:
-                        meta_keywords:
-                        depth: 0
-                        pretty_name: taxonomy_16
-                        seo_title: taxonomy_16
-                        is_root: true
-                        is_child: false
-                        is_leaf: false
+                        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-30T22:29:08.346Z'
+                        updated_at: '2021-08-30T22:29:08.348Z'
+                        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:
-                        taxonomy:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
                           data:
-                            id: '16'
-                            type: taxonomy
                         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-30T22:29:08.356Z'
+                        updated_at: '2021-08-30T22:29:08.358Z'
+                        link:
+                        is_container: false
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        icon:
                           data:
-                          - id: '32'
-                            type: taxon
-                          - id: '33'
-                            type: taxon
-                        image:
+                            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-30T22:29:08.367Z'
+                        updated_at: '2021-08-30T22:29:08.369Z'
+                        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-30T22:29:08.377Z'
+                        updated_at: '2021-08-30T22:29:08.379Z'
+                        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: 3
-                      total_count: 3
+                      count: 8
+                      total_count: 8
                       total_pages: 1
                     links:
-                      self: http://www.example.com/api/v2/platform/taxons?page=1&per_page=&include=&filter=
-                      next: http://www.example.com/api/v2/platform/taxons?include=&page=1&per_page=
-                      prev: http://www.example.com/api/v2/platform/taxons?include=&page=1&per_page=
-                      last: http://www.example.com/api/v2/platform/taxons?include=&page=1&per_page=
-                      first: http://www.example.com/api/v2/platform/taxons?include=&page=1&per_page=
+                      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:
@@ -1075,17 +1308,19 @@ paths:
                   value:
                     error: The access token is invalid
     post:
-      summary: Creates a Taxon
+      summary: Creates a Menu Item
       tags:
-      - Taxons
+      - Menu Items
       security:
       - bearer_auth: []
+      description: Creates a Menu Item
+      operationId: create-menu-item
       parameters:
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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: taxonomy,parent,children
+        example: linked_resource
         schema:
           type: string
       responses:
@@ -1097,39 +1332,41 @@ paths:
                 Example:
                   value:
                     data:
-                      id: '38'
-                      type: taxon
+                      id: '5'
+                      type: menu_item
                       attributes:
-                        position: 0
-                        name: taxon_20
-                        permalink: taxonomy-18/taxon-20
-                        lft: 2
-                        rgt: 3
-                        description:
-                        created_at: '2021-08-06T06:53:22.225Z'
-                        updated_at: '2021-08-06T06:53:22.231Z'
-                        meta_title:
-                        meta_description:
-                        meta_keywords:
+                        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
-                        pretty_name: taxonomy_18 -> taxon_20
-                        seo_title: taxon_20
+                        created_at: '2021-08-30T22:29:08.554Z'
+                        updated_at: '2021-08-30T22:29:08.556Z'
+                        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: '37'
-                            type: taxon
-                        taxonomy:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
                           data:
-                            id: '18'
-                            type: taxonomy
                         children:
                           data: []
-                        image:
-                          data:
         '422':
           description: invalid request
           content:
@@ -1137,24 +1374,29 @@ paths:
               examples:
                 Example:
                   value:
-                    error: Name can't be blank and Taxonomy can't be blank
+                    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
-                      taxonomy:
+                      menu:
                       - can't be blank
+                      item_type:
+                      - is not included in the list
       requestBody:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/taxon_params"
-  "/api/v2/platform/taxons/{id}":
+              "$ref": "#/components/schemas/menu_item_params"
+  "/api/v2/platform/menu_items/{id}":
     get:
-      summary: Returns a Taxon
+      summary: Returns a Menu Item
       tags:
-      - Taxons
+      - Menu Items
       security:
       - bearer_auth: []
+      description: Returns a Menu Item
+      operationId: show-menu-item
       parameters:
       - name: id
         in: path
@@ -1163,9 +1405,9 @@ paths:
           type: string
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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: taxonomy,parent,children
+        example: linked_resource
         schema:
           type: string
       responses:
@@ -1177,43 +1419,43 @@ paths:
                 Example:
                   value:
                     data:
-                      id: '40'
-                      type: taxon
+                      id: '5'
+                      type: menu_item
                       attributes:
-                        position: 0
-                        name: taxon_21
-                        permalink: taxonomy-19/taxon-21
-                        lft: 2
-                        rgt: 3
-                        description:
-                        created_at: '2021-08-06T06:53:22.320Z'
-                        updated_at: '2021-08-06T06:53:22.324Z'
-                        meta_title:
-                        meta_description:
-                        meta_keywords:
+                        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
-                        pretty_name: taxonomy_19 -> taxon_21
-                        seo_title: taxon_21
+                        created_at: '2021-08-30T22:29:08.665Z'
+                        updated_at: '2021-08-30T22:29:08.667Z'
+                        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: '39'
-                            type: taxon
-                        taxonomy:
+                            id: '1'
+                            type: menu_item
+                        linked_resource:
                           data:
-                            id: '19'
-                            type: taxonomy
                         children:
                           data: []
-                        products:
-                          data: []
-                        image:
-                          data:
-                            id: '20'
-                            type: taxon_image
         '404':
           description: Record not found
           content:
@@ -1231,11 +1473,13 @@ paths:
                   value:
                     error: The access token is invalid
     put:
-      summary: Updates a Taxon
+      summary: Updates a Menu Item
       tags:
-      - Taxons
+      - Menu Items
       security:
       - bearer_auth: []
+      description: Updates a Menu Item
+      operationId: update-menu-item
       parameters:
       - name: id
         in: path
@@ -1244,9 +1488,9 @@ paths:
           type: string
       - name: include
         in: query
-        descripton: 'Select which associated resources you would like to fetch, see:
+        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: taxonomy,parent,children
+        example: linked_resource
         schema:
           type: string
       responses:
@@ -1258,20 +1502,1498 @@ paths:
                 Example:
                   value:
                     data:
-                      id: '44'
-                      type: taxon
+                      id: '5'
+                      type: menu_item
                       attributes:
-                        position: 0
-                        name: T-Shirts
-                        permalink: taxonomy-21/taxon-23
-                        lft: 2
-                        rgt: 3
-                        description:
-                        created_at: '2021-08-06T06:53:22.511Z'
-                        updated_at: '2021-08-06T06:53:22.542Z'
-                        meta_title:
-                        meta_description:
-                        meta_keywords:
+                        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-30T22:29:08.831Z'
+                        updated_at: '2021-08-30T22:29:08.843Z'
+                        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_item_params"
+    delete:
+      summary: Deletes a Menu Item
+      tags:
+      - Menu Items
+      security:
+      - bearer_auth: []
+      description: Deletes a Menu Item
+      operationId: delete-menu-item
+      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:
+      - Menu Items
+      security:
+      - bearer_auth: []
+      operationId: reposition-menu-item
+      description: Reposition a Menu Item
+      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-30T22:29:09.230Z'
+                        updated_at: '2021-08-30T22:29:09.241Z'
+                        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: []
+      description: Returns a list of Menus
+      operationId: menus-list
+      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: menu_items
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: location_eq=header
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          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-30T22:29:09.361Z'
+                        updated_at: '2021-08-30T22:29:09.390Z'
+                      relationships:
+                        menu_items:
+                          data:
+                          - 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-30T22:29:09.365Z'
+                        updated_at: '2021-08-30T22:29:09.411Z'
+                      relationships:
+                        menu_items:
+                          data:
+                          - 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:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: The access token is invalid
+    post:
+      summary: Creates a Menu
+      tags:
+      - Menus
+      security:
+      - bearer_auth: []
+      description: Creates a Menu
+      operationId: create-menu
+      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: menu_items
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          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-30T22:29:09.492Z'
+                        updated_at: '2021-08-30T22:29:09.495Z'
+                      relationships:
+                        menu_items:
+                          data:
+                          - id: '1'
+                            type: menu_item
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    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
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/menu_params"
+  "/api/v2/platform/menus/{id}":
+    get:
+      summary: Returns a Menu
+      tags:
+      - Menus
+      security:
+      - bearer_auth: []
+      description: Returns a Menu
+      operationId: show-menu
+      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: menu_items
+        schema:
+          type: string
+      responses:
+        '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-30T22:29:09.523Z'
+                        updated_at: '2021-08-30T22:29:09.527Z'
+                      relationships:
+                        menu_items:
+                          data:
+                          - id: '1'
+                            type: menu_item
+        '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 Menu
+      tags:
+      - Menus
+      security:
+      - bearer_auth: []
+      description: Updates a Menu
+      operationId: update-menu
+      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: menu_items
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          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-30T22:29:09.565Z'
+                        updated_at: '2021-08-30T22:29:09.568Z'
+                      relationships:
+                        menu_items:
+                          data:
+                          - id: '1'
+                            type: menu_item
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    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:
+            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_params"
+    delete:
+      summary: Deletes a Menu
+      tags:
+      - Menus
+      security:
+      - bearer_auth: []
+      description: Deletes a Menu
+      operationId: delete-menu
+      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/option_types":
+    get:
+      summary: Returns a list of Option Types
+      tags:
+      - Option Types
+      security:
+      - bearer_auth: []
+      description: Returns a list of Option Types
+      operationId: option-types-list
+      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: ''
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: option_type_id_eq=1&name_cont=Size
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: option_type
+                      attributes:
+                        name: foo-size-1
+                        presentation: Size
+                        position: 1
+                        created_at: '2021-08-30T22:29:09.672Z'
+                        updated_at: '2021-08-30T22:29:09.672Z'
+                        filterable: true
+                      relationships:
+                        option_values:
+                          data: []
+                    - id: '2'
+                      type: option_type
+                      attributes:
+                        name: foo-size-2
+                        presentation: Size
+                        position: 2
+                        created_at: '2021-08-30T22:29:09.673Z'
+                        updated_at: '2021-08-30T22:29:09.673Z'
+                        filterable: true
+                      relationships:
+                        option_values:
+                          data: []
+                    meta:
+                      count: 2
+                      total_count: 2
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/option_types?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/option_types?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/option_types?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/option_types?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/option_types?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 an Option Type
+      tags:
+      - Option Types
+      security:
+      - bearer_auth: []
+      description: Creates an Option Type
+      operationId: create-option-type
+      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: ''
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: option_type
+                      attributes:
+                        name: foo-size-5
+                        presentation: Size
+                        position: 1
+                        created_at: '2021-08-30T22:29:09.706Z'
+                        updated_at: '2021-08-30T22:29:09.706Z'
+                        filterable: true
+                      relationships:
+                        option_values:
+                          data: []
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank and Presentation can't be blank
+                    errors:
+                      name:
+                      - can't be blank
+                      presentation:
+                      - can't be blank
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/option_type_params"
+  "/api/v2/platform/option_types/{id}":
+    get:
+      summary: Returns an Option Type
+      tags:
+      - Option Types
+      security:
+      - bearer_auth: []
+      description: Returns an Option Type
+      operationId: show-option-type
+      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: ''
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: option_type
+                      attributes:
+                        name: foo-size-6
+                        presentation: Size
+                        position: 1
+                        created_at: '2021-08-30T22:29:09.726Z'
+                        updated_at: '2021-08-30T22:29:09.726Z'
+                        filterable: true
+                      relationships:
+                        option_values:
+                          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 an Option Type
+      tags:
+      - Option Types
+      security:
+      - bearer_auth: []
+      description: Updates an Option Type
+      operationId: update-option-type
+      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: ''
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: option_type
+                      attributes:
+                        name: Size-X
+                        presentation: Size
+                        position: 1
+                        created_at: '2021-08-30T22:29:09.758Z'
+                        updated_at: '2021-08-30T22:29:09.762Z'
+                        filterable: true
+                      relationships:
+                        option_values:
+                          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/option_type_params"
+    delete:
+      summary: Deletes an Option Type
+      tags:
+      - Option Types
+      security:
+      - bearer_auth: []
+      description: Deletes an Option Type
+      operationId: delete-option-type
+      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/option_values":
+    get:
+      summary: Returns a list of Option Values
+      tags:
+      - Option Values
+      security:
+      - bearer_auth: []
+      description: Returns a list of Option Values
+      operationId: option-values-list
+      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: option_type
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: option_type_id_eq=1&name_cont=M
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: option_value
+                      attributes:
+                        position: 1
+                        name: Size-1
+                        presentation: S
+                        created_at: '2021-08-30T22:29:09.842Z'
+                        updated_at: '2021-08-30T22:29:09.842Z'
+                      relationships:
+                        option_type:
+                          data:
+                            id: '1'
+                            type: option_type
+                    - id: '2'
+                      type: option_value
+                      attributes:
+                        position: 1
+                        name: Size-2
+                        presentation: S
+                        created_at: '2021-08-30T22:29:09.845Z'
+                        updated_at: '2021-08-30T22:29:09.845Z'
+                      relationships:
+                        option_type:
+                          data:
+                            id: '2'
+                            type: option_type
+                    meta:
+                      count: 2
+                      total_count: 2
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/option_values?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/option_values?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/option_values?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/option_values?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/option_values?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 an Option Value
+      tags:
+      - Option Values
+      security:
+      - bearer_auth: []
+      description: Creates an Option Value
+      operationId: create-option-value
+      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: option_type
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: option_value
+                      attributes:
+                        position: 1
+                        name: Size-5
+                        presentation: S
+                        created_at: '2021-08-30T22:29:09.880Z'
+                        updated_at: '2021-08-30T22:29:09.880Z'
+                      relationships:
+                        option_type:
+                          data:
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank and Presentation can't be blank
+                    errors:
+                      name:
+                      - can't be blank
+                      presentation:
+                      - can't be blank
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/option_value_params"
+  "/api/v2/platform/option_values/{id}":
+    get:
+      summary: Returns an Option Value
+      tags:
+      - Option Values
+      security:
+      - bearer_auth: []
+      description: Returns an Option Value
+      operationId: show-option-value
+      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: option_type
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: option_value
+                      attributes:
+                        position: 1
+                        name: Size-6
+                        presentation: S
+                        created_at: '2021-08-30T22:29:09.906Z'
+                        updated_at: '2021-08-30T22:29:09.906Z'
+                      relationships:
+                        option_type:
+                          data:
+                            id: '1'
+                            type: option_type
+        '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 an Option Value
+      tags:
+      - Option Values
+      security:
+      - bearer_auth: []
+      description: Updates an Option Value
+      operationId: update-option-value
+      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: option_type
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '1'
+                      type: option_value
+                      attributes:
+                        position: 1
+                        name: M
+                        presentation: S
+                        created_at: '2021-08-30T22:29:09.941Z'
+                        updated_at: '2021-08-30T22:29:09.946Z'
+                      relationships:
+                        option_type:
+                          data:
+                            id: '1'
+                            type: option_type
+        '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/option_value_params"
+    delete:
+      summary: Deletes an Option Value
+      tags:
+      - Option Values
+      security:
+      - bearer_auth: []
+      description: Deletes an Option Value
+      operationId: delete-option-value
+      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/taxons":
+    get:
+      summary: Returns a list of Taxons
+      tags:
+      - Taxons
+      security:
+      - bearer_auth: []
+      description: Returns a list of Taxons
+      operationId: taxons-list
+      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: taxonomy,parent,children
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: taxonomy_id_eq=1&name_cont=Shirts
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: taxon
+                      attributes:
+                        position: 0
+                        name: taxonomy_16
+                        permalink: taxonomy-16
+                        lft: 1
+                        rgt: 6
+                        description:
+                        created_at: '2021-08-30T22:29:10.032Z'
+                        updated_at: '2021-08-30T22:29:10.059Z'
+                        meta_title:
+                        meta_description:
+                        meta_keywords:
+                        depth: 0
+                        pretty_name: taxonomy_16
+                        seo_title: taxonomy_16
+                        is_root: true
+                        is_child: false
+                        is_leaf: false
+                      relationships:
+                        parent:
+                          data:
+                        taxonomy:
+                          data:
+                            id: '1'
+                            type: taxonomy
+                        children:
+                          data:
+                          - id: '2'
+                            type: taxon
+                          - id: '3'
+                            type: taxon
+                        image:
+                          data:
+                    - id: '2'
+                      type: taxon
+                      attributes:
+                        position: 0
+                        name: taxon_16
+                        permalink: taxonomy-16/taxon-16
+                        lft: 2
+                        rgt: 3
+                        description:
+                        created_at: '2021-08-30T22:29:10.043Z'
+                        updated_at: '2021-08-30T22:29:10.044Z'
+                        meta_title:
+                        meta_description:
+                        meta_keywords:
+                        depth: 1
+                        pretty_name: taxonomy_16 -> taxon_16
+                        seo_title: taxon_16
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        parent:
+                          data:
+                            id: '1'
+                            type: taxon
+                        taxonomy:
+                          data:
+                            id: '1'
+                            type: taxonomy
+                        children:
+                          data: []
+                        image:
+                          data:
+                            id: '1'
+                            type: taxon_image
+                    - id: '3'
+                      type: taxon
+                      attributes:
+                        position: 0
+                        name: taxon_17
+                        permalink: taxonomy-16/taxon-17
+                        lft: 4
+                        rgt: 5
+                        description:
+                        created_at: '2021-08-30T22:29:10.053Z'
+                        updated_at: '2021-08-30T22:29:10.055Z'
+                        meta_title:
+                        meta_description:
+                        meta_keywords:
+                        depth: 1
+                        pretty_name: taxonomy_16 -> taxon_17
+                        seo_title: taxon_17
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        parent:
+                          data:
+                            id: '1'
+                            type: taxon
+                        taxonomy:
+                          data:
+                            id: '1'
+                            type: taxonomy
+                        children:
+                          data: []
+                        image:
+                          data:
+                            id: '2'
+                            type: taxon_image
+                    meta:
+                      count: 3
+                      total_count: 3
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/taxons?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/taxons?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/taxons?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/taxons?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/taxons?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 Taxon
+      tags:
+      - Taxons
+      security:
+      - bearer_auth: []
+      description: Creates a Taxon
+      operationId: create-taxon
+      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: taxonomy,parent,children
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: taxon
+                      attributes:
+                        position: 0
+                        name: taxon_20
+                        permalink: taxonomy-18/taxon-20
+                        lft: 2
+                        rgt: 3
+                        description:
+                        created_at: '2021-08-30T22:29:10.139Z'
+                        updated_at: '2021-08-30T22:29:10.141Z'
+                        meta_title:
+                        meta_description:
+                        meta_keywords:
+                        depth: 1
+                        pretty_name: taxonomy_18 -> taxon_20
+                        seo_title: taxon_20
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        parent:
+                          data:
+                            id: '1'
+                            type: taxon
+                        taxonomy:
+                          data:
+                            id: '1'
+                            type: taxonomy
+                        children:
+                          data: []
+                        image:
+                          data:
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Name can't be blank and Taxonomy can't be blank
+                    errors:
+                      name:
+                      - can't be blank
+                      taxonomy:
+                      - can't be blank
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/taxon_params"
+  "/api/v2/platform/taxons/{id}":
+    get:
+      summary: Returns a Taxon
+      tags:
+      - Taxons
+      security:
+      - bearer_auth: []
+      description: Returns a Taxon
+      operationId: show-taxon
+      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: taxonomy,parent,children
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: taxon
+                      attributes:
+                        position: 0
+                        name: taxon_21
+                        permalink: taxonomy-19/taxon-21
+                        lft: 2
+                        rgt: 3
+                        description:
+                        created_at: '2021-08-30T22:29:10.185Z'
+                        updated_at: '2021-08-30T22:29:10.186Z'
+                        meta_title:
+                        meta_description:
+                        meta_keywords:
+                        depth: 1
+                        pretty_name: taxonomy_19 -> taxon_21
+                        seo_title: taxon_21
+                        is_root: false
+                        is_child: true
+                        is_leaf: true
+                      relationships:
+                        parent:
+                          data:
+                            id: '1'
+                            type: taxon
+                        taxonomy:
+                          data:
+                            id: '1'
+                            type: taxonomy
+                        children:
+                          data: []
+                        products:
+                          data: []
+                        image:
+                          data:
+                            id: '1'
+                            type: taxon_image
+        '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 Taxon
+      tags:
+      - Taxons
+      security:
+      - bearer_auth: []
+      description: Updates a Taxon
+      operationId: update-taxon
+      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: taxonomy,parent,children
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: taxon
+                      attributes:
+                        position: 0
+                        name: T-Shirts
+                        permalink: taxonomy-21/taxon-23
+                        lft: 2
+                        rgt: 3
+                        description:
+                        created_at: '2021-08-30T22:29:10.259Z'
+                        updated_at: '2021-08-30T22:29:10.270Z'
+                        meta_title:
+                        meta_description:
+                        meta_keywords:
                         depth: 1
                         pretty_name: taxonomy_21 -> T-Shirts
                         seo_title: T-Shirts
@@ -1279,20 +3001,226 @@ paths:
                         is_child: true
                         is_leaf: true
                       relationships:
-                        parent:
+                        parent:
+                          data:
+                            id: '1'
+                            type: taxon
+                        taxonomy:
+                          data:
+                            id: '1'
+                            type: taxonomy
+                        children:
+                          data: []
+                        image:
+                          data:
+                            id: '1'
+                            type: taxon_image
+        '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/taxon_params"
+    delete:
+      summary: Deletes a Taxon
+      tags:
+      - Taxons
+      security:
+      - bearer_auth: []
+      description: Deletes a Taxon
+      operationId: delete-taxon
+      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/users":
+    get:
+      summary: Returns a list of Users
+      tags:
+      - Users
+      security:
+      - bearer_auth: []
+      description: Returns a list of Users
+      operationId: users-list
+      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: ship_address,bill_address
+        schema:
+          type: string
+      - name: filter
+        in: query
+        description: ''
+        example: user_id_eq=1&email_cont=spree@example.com
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Records returned
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                    - id: '1'
+                      type: user
+                      attributes:
+                        email: delmy@little.name
+                        created_at: '2021-08-30T22:29:10.502Z'
+                        updated_at: '2021-08-30T22:29:10.502Z'
+                        average_order_value: []
+                        lifetime_value: []
+                        store_credits: []
+                      relationships:
+                        bill_address:
                           data:
-                            id: '43'
-                            type: taxon
-                        taxonomy:
+                        ship_address:
                           data:
-                            id: '21'
-                            type: taxonomy
-                        children:
-                          data: []
-                        image:
+                    - id: '2'
+                      type: user
+                      attributes:
+                        email: yoko_brakus@walker.com
+                        created_at: '2021-08-30T22:29:10.506Z'
+                        updated_at: '2021-08-30T22:29:10.506Z'
+                        average_order_value: []
+                        lifetime_value: []
+                        store_credits: []
+                      relationships:
+                        bill_address:
+                          data:
+                        ship_address:
+                          data:
+                    - id: '3'
+                      type: user
+                      attributes:
+                        email: florida.stoltenberg@legros.com
+                        created_at: '2021-08-30T22:29:10.507Z'
+                        updated_at: '2021-08-30T22:29:10.507Z'
+                        average_order_value: []
+                        lifetime_value: []
+                        store_credits: []
+                      relationships:
+                        bill_address:
+                          data:
+                        ship_address:
+                          data:
+                    meta:
+                      count: 3
+                      total_count: 3
+                      total_pages: 1
+                    links:
+                      self: http://www.example.com/api/v2/platform/users?page=1&per_page=&include=&filter=
+                      next: http://www.example.com/api/v2/platform/users?include=&page=1&per_page=
+                      prev: http://www.example.com/api/v2/platform/users?include=&page=1&per_page=
+                      last: http://www.example.com/api/v2/platform/users?include=&page=1&per_page=
+                      first: http://www.example.com/api/v2/platform/users?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 an User
+      tags:
+      - Users
+      security:
+      - bearer_auth: []
+      description: Creates an User
+      operationId: create-user
+      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: ship_address,bill_address
+        schema:
+          type: string
+      responses:
+        '201':
+          description: record created
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: user
+                      attributes:
+                        email: marcie@ondrickavandervort.com
+                        created_at: '2021-08-30T22:29:10.549Z'
+                        updated_at: '2021-08-30T22:29:10.549Z'
+                        average_order_value: []
+                        lifetime_value: []
+                        store_credits: []
+                      relationships:
+                        bill_address:
+                          data:
+                        ship_address:
                           data:
-                            id: '22'
-                            type: taxon_image
         '422':
           description: invalid request
           content:
@@ -1300,10 +3228,131 @@ paths:
               examples:
                 Example:
                   value:
-                    error: Name can't be blank
+                    error: Bill address belongs to other user
                     errors:
-                      name:
-                      - can't be blank
+                      bill_address_id:
+                      - belongs to other user
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/user_params"
+  "/api/v2/platform/users/{id}":
+    get:
+      summary: Returns an User
+      tags:
+      - Users
+      security:
+      - bearer_auth: []
+      description: Returns an User
+      operationId: show-user
+      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: ship_address,bill_address
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Record found
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: user
+                      attributes:
+                        email: anita@hilll.name
+                        created_at: '2021-08-30T22:29:10.578Z'
+                        updated_at: '2021-08-30T22:29:10.578Z'
+                        average_order_value: []
+                        lifetime_value: []
+                        store_credits: []
+                      relationships:
+                        bill_address:
+                          data:
+                        ship_address:
+                          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 an User
+      tags:
+      - Users
+      security:
+      - bearer_auth: []
+      description: Updates an User
+      operationId: update-user
+      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: ship_address,bill_address
+        schema:
+          type: string
+      responses:
+        '200':
+          description: record updated
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    data:
+                      id: '2'
+                      type: user
+                      attributes:
+                        email: john@example.com
+                        created_at: '2021-08-30T22:29:10.622Z'
+                        updated_at: '2021-08-30T22:29:10.627Z'
+                        average_order_value: []
+                        lifetime_value: []
+                        store_credits: []
+                      relationships:
+                        bill_address:
+                          data:
+                        ship_address:
+                          data:
+        '422':
+          description: invalid request
+          content:
+            application/vnd.api+json:
+              examples:
+                Example:
+                  value:
+                    error: Bill address belongs to other user
+                    errors:
+                      bill_address_id:
+                      - belongs to other user
         '404':
           description: Record not found
           content:
@@ -1324,13 +3373,15 @@ paths:
         content:
           application/json:
             schema:
-              "$ref": "#/components/schemas/taxon_params"
+              "$ref": "#/components/schemas/user_params"
     delete:
-      summary: Deletes a Taxon
+      summary: Deletes an User
       tags:
-      - Taxons
+      - Users
       security:
       - bearer_auth: []
+      description: Deletes an User
+      operationId: delete-user
       parameters:
       - name: id
         in: path
@@ -1361,6 +3412,16 @@ servers:
   variables:
     defaultHost:
       default: localhost:3000
+tags:
+- name: Addresses
+- name: Classifications
+- name: Countries
+- name: Menu Items
+- name: Menus
+- name: Option Types
+- name: Option Values
+- name: Taxons
+- name: Users
 components:
   securitySchemes:
     bearer_auth:
@@ -1405,16 +3466,153 @@ components:
           type: string
         position:
           type: integer
+    option_type_params:
+      type: object
+      properties:
+        name:
+          type: string
+        presentation:
+          type: string
+      required:
+      - name
+      - presentation
+    option_value_params:
+      type: object
+      properties:
+        name:
+          type: string
+        presentation:
+          type: string
+        option_values_attributes:
+          type: string
+      required:
+      - name
+      - presentation
+    product_params:
+      type: object
+      properties:
+        name:
+          type: string
+        description:
+          type: string
+        available_on:
+          type: string
+        discontinue_on:
+          type: string
+        permalink:
+          type: string
+        meta_description:
+          type: string
+        meta_keywords:
+          type: string
+        price:
+          type: string
+        sku:
+          type: string
+        deleted_at:
+          type: string
+        prototype_id:
+          type: string
+        option_values_hash:
+          type: string
+        weight:
+          type: string
+        height:
+          type: string
+        width:
+          type: string
+        depth:
+          type: string
+        shipping_category_id:
+          type: string
+        tax_category_id:
+          type: string
+        cost_currency:
+          type: string
+        cost_price:
+          type: string
+        compare_at_price:
+          type: string
+        option_type_ids:
+          type: string
+        taxon_ids:
+          type: string
+      required:
+      - name
+      - price
+      - shipping_category_id
+    user_params:
+      type: object
+      properties:
+        email:
+          type: string
+        password:
+          type: string
+        password_confirmation:
+          type: string
+        ship_address_id:
+          type: string
+        bill_address_id:
+          type: string
+      required:
+      - email
+      - password
+      - password_confirmation
     taxon_params:
       type: object
       properties:
         taxonomy_id:
           type: string
+        parent_id:
+          type: string
         name:
           type: string
       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: