webflow-api 3.0.1 → 3.1.1

package/.mock/definition/collections.yml

@@ -13,7 +13,7 @@ service:
 
         Required scope | `cms:read`
       source:
-        openapi: ../../../referenced-specs/v2.yml
+        openapi: ../../../openapi/referenced-specs/v2.yml
       path-parameters:
         site_id:
           type: string
@@ -22,6 +22,7 @@ service:
       response:
         docs: Request was successful
         type: root.CollectionList
+        status-code: 200
       errors:
         - root.BadRequestError
         - root.UnauthorizedError
@@ -61,7 +62,7 @@ service:
 
         Required scope | `cms:write`
       source:
-        openapi: ../../../referenced-specs/v2.yml
+        openapi: ../../../openapi/referenced-specs/v2.yml
       path-parameters:
         site_id:
           type: string
@@ -80,14 +81,19 @@ service:
             slug:
               type: optional<string>
               docs: Part of a URL that identifier
+            fields:
+              type: optional<list<root.FieldCreate>>
+              docs: An array of custom fields to add to the collection
         content-type: application/json
       response:
         docs: Request was successful
         type: root.Collection
+        status-code: 200
       errors:
         - root.BadRequestError
         - root.UnauthorizedError
         - root.NotFoundError
+        - root.ConflictError
         - root.TooManyRequestsError
         - root.InternalServerError
       examples:
@@ -97,22 +103,51 @@ service:
             displayName: Blog Posts
             singularName: Blog Post
             slug: posts
+            fields:
+              - isRequired: true
+                type: PlainText
+                displayName: Title
+                helpText: The title of the blog post
+              - isRequired: true
+                type: RichText
+                displayName: Content
+                helpText: The content of the blog post
+              - isRequired: true
+                type: Reference
+                displayName: Author
+                helpText: The author of the blog post
+                metadata:
+                  collectionId: 23cc2d952d4e4631ffd4345d2743db4e
           response:
             body:
-              id: 580e63fc8c9a982ac9b8b745
+              id: 562ac0395358780a1f5e6fbd
               displayName: Blog Posts
               singularName: Blog Post
-              slug: post
+              slug: posts
               createdOn: '2016-10-24T19:41:48Z'
               lastUpdated: '2016-10-24T19:42:38Z'
               fields:
-                - id: 23cc2d952d4e4631ffd4345d2743db4e
+                - id: id
                   isRequired: true
                   isEditable: true
                   type: PlainText
-                  slug: name
-                  displayName: Name
-                  helpText: helpText
+                  slug: title
+                  displayName: Title
+                  helpText: The title of the blog post
+                - id: id
+                  isRequired: true
+                  isEditable: true
+                  type: RichText
+                  slug: content
+                  displayName: Content
+                  helpText: The content of the blog post
+                - id: id
+                  isRequired: true
+                  isEditable: true
+                  type: Reference
+                  slug: author
+                  displayName: Author
+                  helpText: The author of the blog post
     get:
       path: /collections/{collection_id}
       method: GET
@@ -122,7 +157,7 @@ service:
 
         Required scope | `cms:read`
       source:
-        openapi: ../../../referenced-specs/v2.yml
+        openapi: ../../../openapi/referenced-specs/v2.yml
       path-parameters:
         collection_id:
           type: string
@@ -131,6 +166,7 @@ service:
       response:
         docs: Request was successful
         type: root.Collection
+        status-code: 200
       errors:
         - root.BadRequestError
         - root.UnauthorizedError
@@ -155,7 +191,6 @@ service:
                   type: PlainText
                   slug: name
                   displayName: Name
-                  helpText: helpText
     delete:
       path: /collections/{collection_id}
       method: DELETE
@@ -165,7 +200,7 @@ service:
 
         Required scope | `cms:write`
       source:
-        openapi: ../../../referenced-specs/v2.yml
+        openapi: ../../../openapi/referenced-specs/v2.yml
       path-parameters:
         collection_id:
           type: string
@@ -181,5 +216,6 @@ service:
         - path-parameters:
             collection_id: 580e63fc8c9a982ac9b8b745
   source:
-    openapi: ../../../referenced-specs/v2.yml
+    openapi: ../../../openapi/referenced-specs/v2.yml
   display-name: Collections
+docs: Collections are CMS collections of items.

package/.mock/definition/components.yml

@@ -0,0 +1,479 @@
+imports:
+  root: __package__.yml
+service:
+  auth: false
+  base-path: ''
+  endpoints:
+    list:
+      path: /sites/{site_id}/components
+      method: GET
+      auth: true
+      docs: |
+        List of all components for a site.
+
+        Required scope | `components:read`
+      source:
+        openapi: ../../../openapi/referenced-specs/v2.yml
+      path-parameters:
+        site_id:
+          type: string
+          docs: Unique identifier for a Site
+      display-name: List Components
+      request:
+        name: ComponentsListRequest
+        query-parameters:
+          limit:
+            type: optional<double>
+            docs: 'Maximum number of records to be returned (max limit: 100)'
+          offset:
+            type: optional<double>
+            docs: >-
+              Offset used for pagination if the results have more than limit
+              records
+      response:
+        docs: Request was successful
+        type: root.ComponentList
+        status-code: 200
+      errors:
+        - root.BadRequestError
+        - root.UnauthorizedError
+        - root.NotFoundError
+        - root.TooManyRequestsError
+        - root.InternalServerError
+      examples:
+        - path-parameters:
+            site_id: 580e63e98c9a982ac9b8b741
+          response:
+            body:
+              components:
+                - id: 6596da6045e56dee495bcbba
+                  name: Primary Button
+                  group: Buttons
+                  description: A default button component that can be used across the site
+                  readonly: true
+                - id: 658205daa3e8206a523b5ad4
+                  name: Secondary Button
+                  group: Buttons
+                  description: >-
+                    A secondary button component that can be used across the
+                    site
+                  readonly: true
+                - id: 6258612d1ee792848f805dcf
+                  name: Card
+                  readonly: true
+                - id: 68a2b1d1ee792848f805dcf
+                  name: Nav
+                  readonly: true
+              pagination:
+                limit: 20
+                offset: 0
+                total: 4
+    get-content:
+      path: /sites/{site_id}/components/{component_id}/dom
+      method: GET
+      auth: true
+      docs: >
+        Get static content from a component definition. This includes text
+        nodes, image nodes and nested component instances.
+
+        To retrieve dynamic content set by component properties, use the [get
+        component
+        properties](/data/reference/pages-and-components/components/get-properties)
+        endpoint.
+
+
+        <Note>If you do not provide a Locale ID in your request, the response
+        will return any content that can be localized from the Primary
+        locale.</Note>
+
+
+        Required scope | `components:read`
+      source:
+        openapi: ../../../openapi/referenced-specs/v2.yml
+      path-parameters:
+        site_id:
+          type: string
+          docs: Unique identifier for a Site
+        component_id:
+          type: string
+          docs: Unique identifier for a Component
+      display-name: Get Component Content
+      request:
+        name: ComponentsGetContentRequest
+        query-parameters:
+          localeId:
+            type: optional<string>
+            docs: >-
+              Unique identifier for a specific locale. Applicable, when using
+              localization.
+          limit:
+            type: optional<double>
+            docs: 'Maximum number of records to be returned (max limit: 100)'
+          offset:
+            type: optional<double>
+            docs: >-
+              Offset used for pagination if the results have more than limit
+              records
+      response:
+        docs: Request was successful
+        type: root.ComponentDom
+        status-code: 200
+      errors:
+        - root.BadRequestError
+        - root.UnauthorizedError
+        - root.NotFoundError
+        - root.TooManyRequestsError
+        - root.InternalServerError
+      examples:
+        - name: ComponentDOM
+          path-parameters:
+            site_id: 580e63e98c9a982ac9b8b741
+            component_id: 8505ba55-ef72-629e-f85c-33e4b703d48b
+          query-parameters:
+            localeId: 65427cf400e02b306eaa04a0
+          response:
+            body:
+              componentId: 69118560-d0bc-15fc-bbf8-b8fe5f6535b5
+              nodes:
+                - id: id
+                  text: {}
+                  attributes:
+                    key: value
+                  type: text
+                - id: id
+                  text: {}
+                  attributes:
+                    key: value
+                  type: text
+                - id: id
+                  image: {}
+                  attributes:
+                    key: value
+                  type: image
+                - id: id
+                  componentId: componentId
+                  propertyOverrides:
+                    - propertyId: 7dd14c08-2e96-8d3d-2b19-b5c03642a0f0
+                  type: component-instance
+              pagination:
+                limit: 4
+                offset: 0
+                total: 4
+        - name: LocalizedComponentDOM
+          path-parameters:
+            site_id: 580e63e98c9a982ac9b8b741
+            component_id: 8505ba55-ef72-629e-f85c-33e4b703d48b
+          query-parameters:
+            localeId: 65427cf400e02b306eaa04a0
+          response:
+            body:
+              componentId: 69118560-d0bc-15fc-bbf8-b8fe5f6535b5
+              nodes:
+                - id: id
+                  image: {}
+                  attributes:
+                    key: value
+                  type: image
+                - id: id
+                  text: {}
+                  attributes:
+                    key: value
+                  type: text
+                - id: id
+                  componentId: componentId
+                  propertyOverrides:
+                    - propertyId: 7dd14c08-2e96-8d3d-2b19-b5c03642a0f0
+                  type: component-instance
+              pagination:
+                limit: 100
+                offset: 0
+                total: 3
+    update-content:
+      path: /sites/{site_id}/components/{component_id}/dom
+      method: POST
+      auth: true
+      docs: >
+        This endpoint updates content within a component defintion for
+        **secondary locales**. It supports updating up to 1000 nodes in a single
+        request.
+
+
+        Before making updates:
+
+        1. Use the [get component
+        content](/data/reference/pages-and-components/components/get-content)
+        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
+
+
+        <Note>
+          This endpoint is specifically for localizing component definitions. Ensure that the specified `localeId` is a valid **secondary locale** for the site otherwise the request will fail.
+        </Note>
+
+
+        Required scope | `components:write`
+      source:
+        openapi: ../../../openapi/referenced-specs/v2.yml
+      path-parameters:
+        site_id:
+          type: string
+          docs: Unique identifier for a Site
+        component_id:
+          type: string
+          docs: Unique identifier for a Component
+      display-name: Update Component Content
+      request:
+        name: ComponentDomWrite
+        query-parameters:
+          localeId:
+            type: optional<string>
+            docs: >-
+              Unique identifier for a specific locale. Applicable, when using
+              localization.
+        body:
+          properties:
+            nodes:
+              docs: >-
+                List of DOM Nodes with the new content that will be updated in
+                each node.
+              type: list<ComponentDomWriteNodesItem>
+        content-type: application/json
+      response:
+        docs: Request was successful
+        type: ComponentsUpdateContentResponse
+        status-code: 200
+      errors:
+        - root.BadRequestError
+        - root.UnauthorizedError
+        - root.ForbiddenError
+        - root.NotFoundError
+        - root.TooManyRequestsError
+        - root.InternalServerError
+      examples:
+        - path-parameters:
+            site_id: 580e63e98c9a982ac9b8b741
+            component_id: 8505ba55-ef72-629e-f85c-33e4b703d48b
+          query-parameters:
+            localeId: 65427cf400e02b306eaa04a0
+          request:
+            nodes:
+              - nodeId: a245c12d-995b-55ee-5ec7-aa36a6cad623
+                text: <h1>The Hitchhiker's Guide to the Galaxy</h1>
+              - nodeId: a245c12d-995b-55ee-5ec7-aa36a6cad627
+                text: >-
+                  <div><h3>Don't Panic!</h3><p>Always know where your towel
+                  is.</p></div>
+              - nodeId: a245c12d-995b-55ee-5ec7-aa36a6cad629
+                propertyOverrides:
+                  - propertyId: 7dd14c08-2e96-8d3d-2b19-b5c03642a0f0
+                    text: <div><h1>Time is an <em>illusion</em></h1></div>
+                  - propertyId: 7dd14c08-2e96-8d3d-2b19-b5c03642a0f1
+                    text: Life, the Universe and Everything
+          response:
+            body:
+              errors:
+                - errors
+    get-properties:
+      path: /sites/{site_id}/components/{component_id}/properties
+      method: GET
+      auth: true
+      docs: >
+        Get the default property values of a component definition.
+
+
+        <Note>If you do not include a `localeId` in your request, the response
+        will return any properties that can be localized from the Primary
+        locale.</Note>
+
+
+        Required scope | `components:read`
+      source:
+        openapi: ../../../openapi/referenced-specs/v2.yml
+      path-parameters:
+        site_id:
+          type: string
+          docs: Unique identifier for a Site
+        component_id:
+          type: string
+          docs: Unique identifier for a Component
+      display-name: Get Component Properties
+      request:
+        name: ComponentsGetPropertiesRequest
+        query-parameters:
+          localeId:
+            type: optional<string>
+            docs: >-
+              Unique identifier for a specific locale. Applicable, when using
+              localization.
+          limit:
+            type: optional<double>
+            docs: 'Maximum number of records to be returned (max limit: 100)'
+          offset:
+            type: optional<double>
+            docs: >-
+              Offset used for pagination if the results have more than limit
+              records
+      response:
+        docs: Request was successful
+        type: root.ComponentProperties
+        status-code: 200
+      errors:
+        - root.BadRequestError
+        - root.UnauthorizedError
+        - root.NotFoundError
+        - root.TooManyRequestsError
+        - root.InternalServerError
+      examples:
+        - path-parameters:
+            site_id: 580e63e98c9a982ac9b8b741
+            component_id: 8505ba55-ef72-629e-f85c-33e4b703d48b
+          query-parameters:
+            localeId: 65427cf400e02b306eaa04a0
+          response:
+            body:
+              componentId: 658205daa3e8206a523b5ad4
+              properties:
+                - propertyId: a245c12d-995b-55ee-5ec7-aa36a6cad623
+                  type: Plain Text
+                  label: Title
+                  text:
+                    text: The Hitchhiker's Guide to the Galaxy
+                - propertyId: a245c12d-995b-55ee-5ec7-aa36a6cad627
+                  type: Rich Text
+                  label: Content
+                  text:
+                    html: >-
+                      <div><h3>Don't Panic!</h3><p>Always know where your towel
+                      is.</p></div>
+              pagination:
+                limit: 2
+                offset: 0
+                total: 2
+    update-properties:
+      path: /sites/{site_id}/components/{component_id}/properties
+      method: POST
+      auth: true
+      docs: >
+        Update the default property values of a component definition in a
+        specificed locale.
+
+
+        Before making updates, 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.
+
+
+        <Note>The request requires a secondary locale ID. If a `localeId` is
+        missing, the request will not be processed and will result in an
+        error.</Note>
+
+
+        Required scope | `components:write`
+      source:
+        openapi: ../../../openapi/referenced-specs/v2.yml
+      path-parameters:
+        site_id:
+          type: string
+          docs: Unique identifier for a Site
+        component_id:
+          type: string
+          docs: Unique identifier for a Component
+      display-name: Update Component Properties
+      request:
+        name: ComponentPropertiesWrite
+        query-parameters:
+          localeId:
+            type: optional<string>
+            docs: >-
+              Unique identifier for a specific locale. Applicable, when using
+              localization.
+        body:
+          properties:
+            properties:
+              docs: >-
+                A list of component properties to update within the specified
+                secondary locale.
+              type: list<ComponentPropertiesWritePropertiesItem>
+        content-type: application/json
+      response:
+        docs: Request was successful
+        type: ComponentsUpdatePropertiesResponse
+        status-code: 200
+      errors:
+        - root.BadRequestError
+        - root.UnauthorizedError
+        - root.NotFoundError
+        - root.TooManyRequestsError
+        - root.InternalServerError
+      examples:
+        - path-parameters:
+            site_id: 580e63e98c9a982ac9b8b741
+            component_id: 8505ba55-ef72-629e-f85c-33e4b703d48b
+          query-parameters:
+            localeId: 65427cf400e02b306eaa04a0
+          request:
+            properties:
+              - propertyId: a245c12d-995b-55ee-5ec7-aa36a6cad623
+                text: The Hitchhiker’s Guide to the Galaxy
+              - propertyId: a245c12d-995b-55ee-5ec7-aa36a6cad627
+                text: >-
+                  <div><h3>Dont Panic!</h3><p>Always know where your towel
+                  is.</p></div>
+          response:
+            body:
+              errors:
+                - errors
+  source:
+    openapi: ../../../openapi/referenced-specs/v2.yml
+types:
+  ComponentDomWriteNodesItem:
+    discriminated: false
+    union:
+      - root.TextNodeWrite
+      - root.ComponentInstanceNodePropertyOverridesWrite
+    source:
+      openapi: ../../../openapi/referenced-specs/v2.yml
+    inline: true
+  ComponentsUpdateContentResponse:
+    properties:
+      errors:
+        docs: A list of error messages, if any.
+        type: list<string>
+    source:
+      openapi: ../../../openapi/referenced-specs/v2.yml
+  ComponentPropertiesWritePropertiesItem:
+    properties:
+      propertyId:
+        type: string
+        docs: The ID of the property.
+      text:
+        type: string
+        docs: >
+          The new string or HTML value used to update the component property in
+          the secondary locale.
+
+
+          The provided value must be compatible with the type of the component
+          property.
+
+
+          For example, attempting to update a single-line plain-text property
+          with a multi-line 
+
+          value will result in an error.
+    source:
+      openapi: ../../../openapi/referenced-specs/v2.yml
+    inline: true
+  ComponentsUpdatePropertiesResponse:
+    properties:
+      errors:
+        docs: A list of error messages, if any.
+        type: list<string>
+    source:
+      openapi: ../../../openapi/referenced-specs/v2.yml

package/.mock/definition/ecommerce.yml

@@ -13,7 +13,7 @@ service:
 
         Required scope | `ecommerce:read`
       source:
-        openapi: ../../../referenced-specs/v2.yml
+        openapi: ../../../openapi/referenced-specs/v2.yml
       path-parameters:
         site_id:
           type: string
@@ -22,6 +22,7 @@ service:
       response:
         docs: Request was successful
         type: root.EcommerceSettings
+        status-code: 200
       errors:
         - root.BadRequestError
         - root.UnauthorizedError
@@ -39,4 +40,4 @@ service:
               createdOn: '2018-10-04T15:21:02Z'
               defaultCurrency: USD
   source:
-    openapi: ../../../referenced-specs/v2.yml
+    openapi: ../../../openapi/referenced-specs/v2.yml