webflow-api 3.2.0 → 3.2.1

package/.mock/definition/collections.yml

@@ -7,7 +7,9 @@ service:
     list:
       path: /sites/{site_id}/collections
       method: GET
-      auth: true
+      auth:
+        - OAuth2:
+            - cms:read
       docs: |
         List of all Collections within a Site.
 
@@ -56,7 +58,9 @@ service:
     create:
       path: /sites/{site_id}/collections
       method: POST
-      auth: true
+      auth:
+        - OAuth2:
+            - cms:write
       docs: >
         Create a Collection for a site with collection fields.
 
@@ -159,7 +163,9 @@ service:
     get:
       path: /collections/{collection_id}
       method: GET
-      auth: true
+      auth:
+        - OAuth2:
+            - cms:read
       docs: |
         Get the full details of a collection from its ID.
 
@@ -312,7 +318,9 @@ service:
     delete:
       path: /collections/{collection_id}
       method: DELETE
-      auth: true
+      auth:
+        - OAuth2:
+            - cms:write
       docs: |
         Delete a collection using its ID.
 

package/.mock/definition/components.yml

@@ -7,7 +7,9 @@ service:
     list:
       path: /sites/{site_id}/components
       method: GET
-      auth: true
+      auth:
+        - OAuth2:
+            - components:read
       docs: |
         List of all components for a site.
 
@@ -48,6 +50,8 @@ service:
             site_id: 580e63e98c9a982ac9b8b741
           query-parameters:
             branchId: 68026fa68ef6dc744c75b833
+            limit: 1.1
+            offset: 1.1
           response:
             body:
               components:
@@ -76,7 +80,9 @@ service:
     get-content:
       path: /sites/{site_id}/components/{component_id}/dom
       method: GET
-      auth: true
+      auth:
+        - OAuth2:
+            - components:read
       docs: >
         Get static content from a component definition. This includes text
         nodes, image nodes, select nodes, text input nodes, submit button nodes,
@@ -109,9 +115,12 @@ service:
         query-parameters:
           localeId:
             type: optional<string>
-            docs: >-
-              Unique identifier for a specific locale. Applicable, when using
-              localization.
+            docs: >
+              Unique identifier for a specific Locale.
+
+
+              [Lear more about
+              localization.](/data/v2.0.0/docs/working-with-localization)
           branchId:
             type: optional<string>
             docs: Scope the operation to work on a specific branch.
@@ -140,6 +149,8 @@ service:
           query-parameters:
             localeId: 65427cf400e02b306eaa04a0
             branchId: 68026fa68ef6dc744c75b833
+            limit: 1.1
+            offset: 1.1
           response:
             body:
               componentId: 69118560-d0bc-15fc-bbf8-b8fe5f6535b5
@@ -189,7 +200,9 @@ service:
     update-content:
       path: /sites/{site_id}/components/{component_id}/dom
       method: POST
-      auth: true
+      auth:
+        - OAuth2:
+            - components:write
       docs: >
         This endpoint updates content within a component defintion for
         **secondary locales**. It supports updating up to 1000 nodes in a single
@@ -200,13 +213,18 @@ service:
 
         1. Use the [get component
         content](/data/reference/pages-and-components/components/get-content)
-        endpoint to identify available content nodes and their types
+        endpoint to identify available content nodes and their types.
 
         2. If your component definition has a component instance nested within
         it, retrieve the nested component instance's properties that you'll
         override using the [get component
         properties](/data/reference/pages-and-components/components/get-properties)
-        endpoint
+        endpoint.
+
+        3. DOM elements may include a `data-w-id` attribute. This attribute is
+        used by Webflow to maintain custom attributes and links across locales.
+        Always include the original `data-w-id` value in your update requests to
+        ensure consistent behavior across all locales.
 
 
         <Note>
@@ -230,9 +248,12 @@ service:
         query-parameters:
           localeId:
             type: optional<string>
-            docs: >-
-              Unique identifier for a specific locale. Applicable, when using
-              localization.
+            docs: >
+              Unique identifier for a specific Locale.
+
+
+              [Lear more about
+              localization.](/data/v2.0.0/docs/working-with-localization)
           branchId:
             type: optional<string>
             docs: Scope the operation to work on a specific branch.
@@ -294,7 +315,9 @@ service:
     get-properties:
       path: /sites/{site_id}/components/{component_id}/properties
       method: GET
-      auth: true
+      auth:
+        - OAuth2:
+            - components:read
       docs: >
         Get the default property values of a component definition.
 
@@ -320,9 +343,12 @@ service:
         query-parameters:
           localeId:
             type: optional<string>
-            docs: >-
-              Unique identifier for a specific locale. Applicable, when using
-              localization.
+            docs: >
+              Unique identifier for a specific Locale.
+
+
+              [Lear more about
+              localization.](/data/v2.0.0/docs/working-with-localization)
           branchId:
             type: optional<string>
             docs: Scope the operation to work on a specific branch.
@@ -351,6 +377,8 @@ service:
           query-parameters:
             localeId: 65427cf400e02b306eaa04a0
             branchId: 68026fa68ef6dc744c75b833
+            limit: 1.1
+            offset: 1.1
           response:
             body:
               componentId: 658205daa3e8206a523b5ad4
@@ -374,17 +402,26 @@ service:
     update-properties:
       path: /sites/{site_id}/components/{component_id}/properties
       method: POST
-      auth: true
+      auth:
+        - OAuth2:
+            - components:write
       docs: >
         Update the default property values of a component definition in a
         specificed locale.
 
 
-        Before making updates, use the [get component
+        Before making updates:
+
+        1. Use the [get component
         properties](/data/reference/pages-and-components/components/get-properties)
         endpoint to identify properties that can be updated in a secondary
         locale.
 
+        2. Rich Text properties may include a `data-w-id` attribute. This
+        attribute is used by Webflow to maintain links across locales. Always
+        include the original `data-w-id` value in your update requests to ensure
+        consistent behavior across all locales.
+
 
         <Note>The request requires a secondary locale ID. If a `localeId` is
         missing, the request will not be processed and will result in an
@@ -407,9 +444,12 @@ service:
         query-parameters:
           localeId:
             type: optional<string>
-            docs: >-
-              Unique identifier for a specific locale. Applicable, when using
-              localization.
+            docs: >
+              Unique identifier for a specific Locale.
+
+
+              [Lear more about
+              localization.](/data/v2.0.0/docs/working-with-localization)
           branchId:
             type: optional<string>
             docs: Scope the operation to work on a specific branch.
@@ -456,12 +496,12 @@ types:
   ComponentDomWriteNodesItem:
     discriminated: false
     union:
-      - type: root.Text Node
-      - type: root.Component Instance
+      - type: root.TextNodeWrite
+      - type: root.ComponentInstanceNodePropertyOverridesWrite
       - type: root.Select
-      - type: root.Text Input
-      - type: root.Submit Button
-      - type: root.Search Button
+      - type: root.TextInputNodeWrite
+      - type: root.SubmitButtonNodeWrite
+      - type: root.SearchButtonNodeWrite
     source:
       openapi: ../../../openapi/referenced-specs/v2.yml
     inline: true

package/.mock/definition/ecommerce.yml

@@ -7,7 +7,9 @@ service:
     get-settings:
       path: /sites/{site_id}/ecommerce/settings
       method: GET
-      auth: true
+      auth:
+        - OAuth2:
+            - ecommerce:read
       docs: |
         Retrieve ecommerce settings for a site.
 

package/.mock/definition/forms.yml

@@ -7,7 +7,9 @@ service:
     list:
       path: /sites/{site_id}/forms
       method: GET
-      auth: true
+      auth:
+        - OAuth2:
+            - forms:read
       docs: |
         List forms for a given site.
 
@@ -45,6 +47,9 @@ service:
       examples:
         - path-parameters:
             site_id: 580e63e98c9a982ac9b8b741
+          query-parameters:
+            limit: 1.1
+            offset: 1.1
           response:
             body:
               forms:
@@ -94,7 +99,9 @@ service:
     get:
       path: /forms/{form_id}
       method: GET
-      auth: true
+      auth:
+        - OAuth2:
+            - forms:read
       docs: |
         Get information about a given form.
 
@@ -149,7 +156,9 @@ service:
     list-submissions:
       path: /forms/{form_id}/submissions
       method: GET
-      auth: true
+      auth:
+        - OAuth2:
+            - forms:read
       docs: |
         List form submissions for a given form
 
@@ -192,6 +201,9 @@ service:
       examples:
         - path-parameters:
             form_id: 580e63e98c9a982ac9b8b741
+          query-parameters:
+            offset: 1.1
+            limit: 1.1
           response:
             body:
               formSubmissions:
@@ -218,7 +230,9 @@ service:
     get-submission:
       path: /form_submissions/{form_submission_id}
       method: GET
-      auth: true
+      auth:
+        - OAuth2:
+            - forms:read
       docs: |
         Get information about a given form submissio.
 
@@ -257,7 +271,9 @@ service:
     delete-submission:
       path: /form_submissions/{form_submission_id}
       method: DELETE
-      auth: true
+      auth:
+        - OAuth2:
+            - forms:write
       docs: |
         Delete a form submission
 
@@ -284,7 +300,9 @@ service:
     update-submission:
       path: /form_submissions/{form_submission_id}
       method: PATCH
-      auth: true
+      auth:
+        - OAuth2:
+            - forms:write
       docs: |
         Update hidden fields on a form submission
 
@@ -335,7 +353,9 @@ service:
     list-submissions-by-site:
       path: /sites/{site_id}/form_submissions
       method: GET
-      auth: true
+      auth:
+        - OAuth2:
+            - forms:read
       docs: >
         List form submissions for a given site. This endpoint differs from the
         existing [List Form Submissions
@@ -385,6 +405,8 @@ service:
             site_id: 580e63e98c9a982ac9b8b741
           query-parameters:
             elementId: 18259716-3e5a-646a-5f41-5dc4b9405aa0
+            offset: 1.1
+            limit: 1.1
           response:
             body:
               formSubmissions:

package/.mock/definition/inventory.yml

@@ -5,9 +5,11 @@ service:
   base-path: ''
   endpoints:
     list:
-      path: /collections/{collection_id}/items/{item_id}/inventory
+      path: /collections/{sku_collection_id}/items/{sku_id}/inventory
       method: GET
-      auth: true
+      auth:
+        - OAuth2:
+            - ecommerce:read
       docs: |
         List the current inventory levels for a particular SKU item.
 
@@ -15,12 +17,14 @@ service:
       source:
         openapi: ../../../openapi/referenced-specs/v2.yml
       path-parameters:
-        collection_id:
+        sku_collection_id:
           type: string
-          docs: Unique identifier for a Collection
-        item_id:
+          docs: >-
+            Unique identifier for a SKU collection. Use the List Collections API
+            to find this ID.
+        sku_id:
           type: string
-          docs: Unique identifier for an Item
+          docs: Unique identifier for a SKU
       display-name: List Inventory
       response:
         docs: Request was successful
@@ -36,17 +40,19 @@ service:
         - root.InternalServerError
       examples:
         - path-parameters:
-            collection_id: 580e63fc8c9a982ac9b8b745
-            item_id: 580e64008c9a982ac9b8b754
+            sku_collection_id: 6377a7c4b7a79608c34a46f7
+            sku_id: 5e8518516e147040726cc415
           response:
             body:
               id: 5bfedb42bab0ad90fa7dad39
               quantity: 100
               inventoryType: finite
     update:
-      path: /collections/{collection_id}/items/{item_id}/inventory
+      path: /collections/{sku_collection_id}/items/{sku_id}/inventory
       method: PATCH
-      auth: true
+      auth:
+        - OAuth2:
+            - ecommerce:write
       docs: >
         Updates the current inventory levels for a particular SKU item. 
 
@@ -65,12 +71,14 @@ service:
       source:
         openapi: ../../../openapi/referenced-specs/v2.yml
       path-parameters:
-        collection_id:
+        sku_collection_id:
           type: string
-          docs: Unique identifier for a Collection
-        item_id:
+          docs: >-
+            Unique identifier for a SKU collection. Use the List Collections API
+            to find this ID.
+        sku_id:
           type: string
-          docs: Unique identifier for an Item
+          docs: Unique identifier for a SKU
       display-name: Update Item Inventory
       request:
         name: InventoryUpdateRequest
@@ -100,8 +108,8 @@ service:
         - root.InternalServerError
       examples:
         - path-parameters:
-            collection_id: 580e63fc8c9a982ac9b8b745
-            item_id: 580e64008c9a982ac9b8b754
+            sku_collection_id: 6377a7c4b7a79608c34a46f7
+            sku_id: 5e8518516e147040726cc415
           request:
             inventoryType: infinite
           response:
@@ -140,5 +148,5 @@ webhooks:
         payload:
           triggerType: ecomm_inventory_changed
           payload:
-            ref: ./schemas/inventory.yml#/InventoryItem/example
+            \$ref: ./schemas/inventory.yml#/InventoryItem/example
     docs: Information about updated ecommerce inventory values

package/.mock/definition/items.yml

@@ -15,7 +15,7 @@ webhooks:
             workspaceId: 625860a7a6c16d624927122f
             siteId: 65427cf400e02b306eaa049c
             collectionId: 664243617fcc8b464b23c4ee
-            cmsLocaleId: 681442a144bb80bd00480fda
+            lastPublished: '2023-03-17T18:47:35Z'
             lastUpdated: '2023-03-17T18:47:35Z'
             createdOn: '2023-03-17T18:47:35Z'
             isArchived: false
@@ -34,18 +34,13 @@ webhooks:
       - payload:
           triggerType: collection_item_changed
           payload:
-            id: 580e64008c9a982ac9b8b754
-            workspaceId: 625860a7a6c16d624927122f
-            siteId: 65427cf400e02b306eaa049c
-            collectionId: 664243617fcc8b464b23c4ee
-            cmsLocaleId: 681442a144bb80bd00480fda
-            lastUpdated: '2023-03-17T18:47:35Z'
-            createdOn: '2023-03-17T18:47:35Z'
-            isArchived: false
-            isDraft: false
+            id: id
+            workspaceId: workspaceId
+            siteId: siteId
+            collectionId: collectionId
             fieldData:
-              name: Pan-Galactic Gargle Blaster
-              slug: pan-galactic-gargle-blaster
+              name: name
+              slug: slug
     docs: Information about an updated collection item
   collection_item_deleted:
     audiences: []
@@ -67,11 +62,28 @@ webhooks:
             isArchived: false
             isDraft: false
             fieldData:
-              name: Anna Gunn
-              slug: anna-gunn
-              _locale: 681442a144bb80bd00480fda
-              _noSearch: false
+              name: Earth
+              slug: earth
+              description: Mostly harmless
+              color: '#0000FF'
+              type: planet
+              galaxy: Milky Way
     docs: Information about a deleted collection item
+  collection_item_published:
+    audiences: []
+    method: POST
+    display-name: Collection Item Published
+    headers: {}
+    payload: root.CollectionItemPublished
+    examples:
+      - payload:
+          triggerType: collection_item_published
+          payload:
+            id: 6321ca84df3949bfc6752327
+            siteId: 65427cf400e02b306eaa049c
+            workspaceId: 625860a7a6c16d624927122f
+            collectionId: 664243617fcc8b464b23c4ee
+    docs: Information about a collection item that was published
   collection_item_unpublished:
     audiences: []
     method: POST