datocms-plugin-sdk 0.6.15 → 0.6.17

package/dist/types/SiteApiSchema.d.ts

@@ -281,6 +281,23 @@ export declare type MenuItemIdentity = string;
  * `definition` "type".
  */
 export declare type ItemTypeType = 'item_type';
+/**
+ * JSON API type field
+ *
+ * This interface was referenced by `ItemTypeFilter`'s JSON-Schema via the
+ * `definition` "type".
+ */
+export declare type ItemTypeFilterType = 'item_type_filter';
+/**
+ * ID of filter
+ *
+ * This interface was referenced by `ItemTypeFilter`'s JSON-Schema via the
+ * `definition` "identity".
+ *
+ * This interface was referenced by `ItemTypeFilter`'s JSON-Schema via the
+ * `definition` "id".
+ */
+export declare type ItemTypeFilterIdentity = string;
 /**
  * This interface was referenced by `MenuItem`'s JSON-Schema via the
  * `instances.hrefSchema` link.
@@ -349,6 +366,15 @@ export declare type FieldsetIdentity = string;
  * `definition` "type".
  */
 export declare type WorkflowType = 'workflow';
+/**
+ * This interface was referenced by `ItemType`'s JSON-Schema via the
+ * `create.hrefSchema` link.
+ */
+export declare type ItemTypeCreateHrefSchema = {
+    /** Skip the creation of a menu item linked to the model */
+    skip_menu_item_creation?: string;
+    [k: string]: unknown;
+};
 /**
  * JSON API type field
  *
@@ -366,6 +392,15 @@ export declare type JobType = 'job';
  * "id".
  */
 export declare type JobIdentity = string;
+/**
+ * This interface was referenced by `ItemType`'s JSON-Schema via the
+ * `destroy.hrefSchema` link.
+ */
+export declare type ItemTypeDestroyHrefSchema = {
+    /** Skip the deletion of the menu items linked to the model */
+    skip_menu_items_deletion?: string;
+    [k: string]: unknown;
+};
 /**
  * JSON API type field
  *
@@ -529,10 +564,14 @@ export declare type ItemInstancesHrefSchema = {
         [k: string]: unknown;
     };
     /**
-     * Fields used to order results. You _must_ specify also `filter[type]` with
+     * Fields used to order results. You **must** specify also `filter[type]` with
      * one element only to be able use this option. Format:
-     * `<field_name>_<DIRECTION(ASC|DESC)>`. You can pass multiple comma separated
-     * rules
+     * `<field_name>_(ASC|DESC)`, where `<field_name>` can be either the API key
+     * of a model's field, or one of the following meta columns: `id`,
+     * `_updated_at`, `_created_at`, `_status`, `_published_at`,
+     * `_first_published_at`, `_publication_scheduled_at`,
+     * `_unpublishing_scheduled_at`, `_is_valid`, `position` (only for sortable
+     * models). You can pass multiple comma separated rules.
      */
     order_by?: string;
     /**
@@ -828,16 +867,32 @@ export declare type SearchResultIdentity = string;
  * `instances.hrefSchema` link.
  */
 export declare type SearchResultInstancesHrefSchema = {
-    /** The query string to search */
-    q: string;
-    /** The build trigger ID on which the search will be performed */
-    build_trigger_id?: string;
-    /** Restrict the search on one locale */
-    locale?: string;
-    /** Maximum number of results to return (defaults to 20, maximum is 100) */
-    limit?: number;
-    /** Number of records to offset for the search */
-    offset?: string;
+    /** Attributes to manage results pagination */
+    page?: {
+        /** Index of first element to fetch (defaults to 0) */
+        offset?: number;
+        /** Number of elements to fetch (defaults to 20, maximum is 100) */
+        limit?: number;
+        [k: string]: unknown;
+    };
+    /** Attributes to filter search results */
+    filter: {
+        /**
+         * When any value is passed, it enables the fuzzy search: the Levenshtein
+         * Edit Distance is used to match more results.
+         */
+        fuzzy?: string;
+        /** Text to search */
+        query: string;
+        /**
+         * The build trigger ID on which the search will be performed. Required if
+         * more than one build trigger is present in a project
+         */
+        build_trigger_id?: string;
+        /** Restrict the search on pages in a specific locale */
+        locale?: string;
+        [k: string]: unknown;
+    };
     [k: string]: unknown;
 };
 /**
@@ -922,23 +977,6 @@ export declare type WebhookCallInstancesHrefSchema = {
     };
     [k: string]: unknown;
 };
-/**
- * JSON API type field
- *
- * This interface was referenced by `ItemTypeFilter`'s JSON-Schema via the
- * `definition` "type".
- */
-export declare type ItemTypeFilterType = 'item_type_filter';
-/**
- * ID of filter
- *
- * This interface was referenced by `ItemTypeFilter`'s JSON-Schema via the
- * `definition` "identity".
- *
- * This interface was referenced by `ItemTypeFilter`'s JSON-Schema via the
- * `definition` "id".
- */
-export declare type ItemTypeFilterIdentity = string;
 /**
  * JSON API type field
  *
@@ -2607,7 +2645,7 @@ export interface MenuItemAttributes {
     external_url: null | string;
     /** Ordering index */
     position: number;
-    /** Opens link in new tab (used together with `external_url`) */
+    /** Opens link in new tab (to be used together with `external_url`) */
     open_in_new_tab: boolean;
 }
 /**
@@ -2621,6 +2659,13 @@ export interface MenuItemRelationships {
     item_type: {
         data: ItemTypeData | null;
     };
+    /**
+     * Item type filter associated with the menu item (to be used together with
+     * `item_type` relationship)
+     */
+    item_type_filter: {
+        data: ItemTypeFilterData | null;
+    };
     /** Parent menu item */
     parent: {
         data: null | MenuItemData;
@@ -2640,6 +2685,16 @@ export interface ItemTypeData {
     type: ItemTypeType;
     id: ItemTypeIdentity;
 }
+/**
+ * JSON API data
+ *
+ * This interface was referenced by `ItemTypeFilter`'s JSON-Schema via the
+ * `definition` "data".
+ */
+export interface ItemTypeFilterData {
+    type: ItemTypeFilterType;
+    id: ItemTypeFilterIdentity;
+}
 /**
  * JSON API data
  *
@@ -2664,8 +2719,8 @@ export interface MenuItemCreateSchema {
             /** The URL to which the menu item points to */
             external_url?: null | string;
             /** Ordering index */
-            position: number;
-            /** Opens link in new tab (used together with `external_url`) */
+            position?: number;
+            /** Opens link in new tab (to be used together with `external_url`) */
             open_in_new_tab?: boolean;
         };
         relationships?: {
@@ -2673,6 +2728,13 @@ export interface MenuItemCreateSchema {
             item_type?: {
                 data: ItemTypeData | null;
             };
+            /**
+             * Item type filter associated with the menu item (to be used together
+             * with `item_type` relationship)
+             */
+            item_type_filter?: {
+                data: ItemTypeFilterData | null;
+            };
             /** Parent menu item */
             parent?: {
                 data: null | MenuItemData;
@@ -2698,12 +2760,12 @@ export interface MenuItemUpdateSchema {
         /** JSON API attributes */
         attributes?: {
             /** The label of the menu item */
-            label: string;
+            label?: string;
             /** The URL to which the menu item points to */
             external_url?: null | string;
             /** Ordering index */
-            position: number;
-            /** Opens link in new tab (used together with `external_url`) */
+            position?: number;
+            /** Opens link in new tab (to be used together with `external_url`) */
             open_in_new_tab?: boolean;
         };
         relationships?: {
@@ -2711,6 +2773,13 @@ export interface MenuItemUpdateSchema {
             item_type?: {
                 data: ItemTypeData | null;
             };
+            /**
+             * Item type filter associated with the menu item (to be used together
+             * with `item_type` relationship)
+             */
+            item_type_filter?: {
+                data: ItemTypeFilterData | null;
+            };
             /** Parent menu item */
             parent?: {
                 data: null | MenuItemData;
@@ -2760,6 +2829,7 @@ export interface ItemType {
     id: ItemTypeIdentity;
     attributes: ItemTypeAttributes;
     relationships: ItemTypeRelationships;
+    meta: ItemTypeMeta;
 }
 /**
  * JSON API attributes
@@ -2773,7 +2843,7 @@ export interface ItemTypeAttributes {
     /** API key of the model */
     api_key: string;
     /** The way the model collection should be presented to the editors */
-    collection_appeareance: 'compact' | 'table';
+    collection_appeareance?: 'compact' | 'table';
     /** The way the model collection should be presented to the editors */
     collection_appearance: 'compact' | 'table';
     /** Whether the model is single-instance or not */
@@ -2808,6 +2878,8 @@ export interface ItemTypeAttributes {
      * model/block
      */
     hint: string | null;
+    /** Whether inverse relationships fields are expressed in GraphQL or not */
+    inverse_relationships_enabled: boolean;
 }
 /**
  * JSON API links
@@ -2889,6 +2961,19 @@ export interface WorkflowData {
     type: WorkflowType;
     id: WorkflowIdentity;
 }
+/**
+ * Meta information regarding the item type
+ *
+ * This interface was referenced by `ItemType`'s JSON-Schema via the
+ * `definition` "meta".
+ */
+export interface ItemTypeMeta {
+    /**
+     * If this model is single-instance, this tells the single-instance record has
+     * already been created or not
+     */
+    has_singleton_item: boolean;
+}
 /**
  * This interface was referenced by `ItemType`'s JSON-Schema via the
  * `create.schema` link.
@@ -2933,6 +3018,8 @@ export interface ItemTypeCreateSchema {
              * model/block
              */
             hint?: string | null;
+            /** Whether inverse relationships fields are expressed in GraphQL or not */
+            inverse_relationships_enabled?: boolean;
         };
         relationships?: {
             /** The field upon which the collection is sorted */
@@ -3016,6 +3103,8 @@ export interface ItemTypeUpdateSchema {
              * model/block
              */
             hint?: string | null;
+            /** Whether inverse relationships fields are expressed in GraphQL or not */
+            inverse_relationships_enabled?: boolean;
         };
         relationships?: {
             /** The field upon which the collection is sorted */
@@ -3039,6 +3128,13 @@ export interface ItemTypeUpdateSchema {
                 data: WorkflowData | null;
             };
         };
+        meta?: {
+            /**
+             * If this model is single-instance, this tells the single-instance record
+             * has already been created or not
+             */
+            has_singleton_item?: boolean;
+        };
     };
 }
 /**
@@ -3243,148 +3339,150 @@ export interface ItemTypeDestroyJobSchema {
  * }
  * ```
  *
- * ### Available field types<details><summary>Single-line string (<code>string</code>)</summary>
+ * ### Available field types<details>
+ * <summary>Single-line string (<code>string</code>)</summary>
  *
  * | Property                       | Value                                                |
- * | ------------------------------ | ---------------------------------------------------- | ------------------- | ------------------------------------------------------ |
+ * | ------------------------------ | ---------------------------------------------------- |
  * | Code                           | `string`                                             |
  * | Built-in editors for the field | `single_line`, `string_radio_group`, `string_select` |
- * | Available validators           | `required`, `unique`, `length`, `format`, `enum`     | </details><details> | <summary>Multi-line text (<code>text</code>)</summary> |
- *
- * | Property | Value |
+ * | Available validators           | `required`, `unique`, `length`, `format`, `enum`     |</details><details>
+ * <summary>Multi-line text (<code>text</code>)</summary>
  *
- * | ------------------------------ | --------------------------------- | ------------------- |
- * | Code | `text` |
+ * | Property                       | Value                             |
+ * | ------------------------------ | --------------------------------- |
+ * | Code                           | `text`                            |
  * | Built-in editors for the field | `markdown`, `wysiwyg`, `textarea` |
- * | Available validators | `required`, `length`, `format` | </details><details> |<summary>Boolean (<code>boolean</code>)</summary>
- *
- * | Property | Value |
+ * | Available validators           | `required`, `length`, `format`    |</details><details>
+ * <summary>Boolean (<code>boolean</code>)</summary>
  *
- * | ------------------------------ | -------------------------------- | ------------------- |
- * | Code | `boolean` |
+ * | Property                       | Value                            |
+ * | ------------------------------ | -------------------------------- |
+ * | Code                           | `boolean`                        |
  * | Built-in editors for the field | `boolean`, `boolean_radio_group` |
- * | Available validators | no validators available | </details><details> |<summary>Integer (<code>integer</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | -------------------------- | ------------------- |
- * | Code | `integer` |
- * | Built-in editors for the field | `integer` |
- * | Available validators | `required`, `number_range` | </details><details> |<summary>Float (<code>float</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | -------------------------- | ------------------- |
- * | Code | `float` |
- * | Built-in editors for the field | `float` |
- * | Available validators | `required`, `number_range` | </details><details> |<summary>Date (<code>date</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | ------------------------ | ------------------- |
- * | Code | `date` |
- * | Built-in editors for the field | `date_picker` |
- * | Available validators | `required`, `date_range` | </details><details> |<summary>Date time (<code>date_time</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | ----------------------------- | ------------------- |
- * | Code | `date_time` |
- * | Built-in editors for the field | `date_time_picker` |
- * | Available validators | `required`, `date_time_range` | </details><details> |<summary>Color (<code>color</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | -------------- | ------------------- |
- * | Code | `color` |
+ * | Available validators           | no validators available          |</details><details>
+ * <summary>Integer (<code>integer</code>)</summary>
+ *
+ * | Property                       | Value                      |
+ * | ------------------------------ | -------------------------- |
+ * | Code                           | `integer`                  |
+ * | Built-in editors for the field | `integer`                  |
+ * | Available validators           | `required`, `number_range` |</details><details>
+ * <summary>Float (<code>float</code>)</summary>
+ *
+ * | Property                       | Value                      |
+ * | ------------------------------ | -------------------------- |
+ * | Code                           | `float`                    |
+ * | Built-in editors for the field | `float`                    |
+ * | Available validators           | `required`, `number_range` |</details><details>
+ * <summary>Date (<code>date</code>)</summary>
+ *
+ * | Property                       | Value                    |
+ * | ------------------------------ | ------------------------ |
+ * | Code                           | `date`                   |
+ * | Built-in editors for the field | `date_picker`            |
+ * | Available validators           | `required`, `date_range` |</details><details>
+ * <summary>Date time (<code>date_time</code>)</summary>
+ *
+ * | Property                       | Value                         |
+ * | ------------------------------ | ----------------------------- |
+ * | Code                           | `date_time`                   |
+ * | Built-in editors for the field | `date_time_picker`            |
+ * | Available validators           | `required`, `date_time_range` |</details><details>
+ * <summary>Color (<code>color</code>)</summary>
+ *
+ * | Property                       | Value          |
+ * | ------------------------------ | -------------- |
+ * | Code                           | `color`        |
  * | Built-in editors for the field | `color_picker` |
- * | Available validators | `required` | </details><details> |<summary>JSON (<code>json</code>)</summary>
+ * | Available validators           | `required`     |</details><details>
+ * <summary>JSON (<code>json</code>)</summary>
  *
- * | Property | Value |
- *
- * | ------------------------------ | ------------------------------------------------------ | ------------------- |
- * | Code | `json` |
+ * | Property                       | Value                                                  |
+ * | ------------------------------ | ------------------------------------------------------ |
+ * | Code                           | `json`                                                 |
  * | Built-in editors for the field | `json`, `string_multi_select`, `string_checkbox_group` |
- * | Available validators | `required` | </details><details> |<summary>Location (<code>lat_lon</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | ---------- | ------------------- |
- * | Code | `lat_lon` |
- * | Built-in editors for the field | `map` |
- * | Available validators | `required` | </details><details> |<summary>SEO (<code>seo</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | -------------------------------------------------------------------------------------------- | ------------------- |
- * | Code | `seo` |
- * | Built-in editors for the field | `seo` |
- * | Available validators | `required_seo_fields`, `file_size`, `image_dimensions`, `title_length`, `description_length` | </details><details> |<summary>Slug (<code>slug</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | ----------------------------------- | ------------------- |
- * | Code | `slug` |
- * | Built-in editors for the field | `slug` |
- * | Required validators | `slug_title_field` |
- * | Other validators available | `required`, `length`, `slug_format` | </details><details> |<summary>External video (<code>video</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | ---------- | ------------------- |
- * | Code | `video` |
- * | Built-in editors for the field | `video` |
- * | Available validators | `required` | </details><details> |<summary>Single-asset (<code>file</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | ------------------------------------------------------------------------------ | ------------------- |
- * | Code | `file` |
- * | Built-in editors for the field | `file` |
- * | Available validators | `required`, `file_size`, `image_dimensions`, `extension`, `required_alt_title` | </details><details> |<summary>Asset gallery (<code>gallery</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | -------------------------------------------------------------------------- | ------------------- |
- * | Code | `gallery` |
- * | Built-in editors for the field | `gallery` |
- * | Available validators | `size`, `file_size`, `image_dimensions`, `extension`, `required_alt_title` | </details><details> |<summary>Single link (<code>link</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | --------------------------- | ------------------- |
- * | Code | `link` |
+ * | Available validators           | `required`                                             |</details><details>
+ * <summary>Location (<code>lat_lon</code>)</summary>
+ *
+ * | Property                       | Value      |
+ * | ------------------------------ | ---------- |
+ * | Code                           | `lat_lon`  |
+ * | Built-in editors for the field | `map`      |
+ * | Available validators           | `required` |</details><details>
+ * <summary>SEO (<code>seo</code>)</summary>
+ *
+ * | Property                       | Value                                                                                        |
+ * | ------------------------------ | -------------------------------------------------------------------------------------------- |
+ * | Code                           | `seo`                                                                                        |
+ * | Built-in editors for the field | `seo`                                                                                        |
+ * | Available validators           | `required_seo_fields`, `file_size`, `image_dimensions`, `title_length`, `description_length` |</details><details>
+ * <summary>Slug (<code>slug</code>)</summary>
+ *
+ * | Property                       | Value                               |
+ * | ------------------------------ | ----------------------------------- |
+ * | Code                           | `slug`                              |
+ * | Built-in editors for the field | `slug`                              |
+ * | Required validators            | `slug_title_field`                  |
+ * | Other validators available     | `required`, `length`, `slug_format` |</details><details>
+ * <summary>External video (<code>video</code>)</summary>
+ *
+ * | Property                       | Value      |
+ * | ------------------------------ | ---------- |
+ * | Code                           | `video`    |
+ * | Built-in editors for the field | `video`    |
+ * | Available validators           | `required` |</details><details>
+ * <summary>Single-asset (<code>file</code>)</summary>
+ *
+ * | Property                       | Value                                                                          |
+ * | ------------------------------ | ------------------------------------------------------------------------------ |
+ * | Code                           | `file`                                                                         |
+ * | Built-in editors for the field | `file`                                                                         |
+ * | Available validators           | `required`, `file_size`, `image_dimensions`, `extension`, `required_alt_title` |</details><details>
+ * <summary>Asset gallery (<code>gallery</code>)</summary>
+ *
+ * | Property                       | Value                                                                      |
+ * | ------------------------------ | -------------------------------------------------------------------------- |
+ * | Code                           | `gallery`                                                                  |
+ * | Built-in editors for the field | `gallery`                                                                  |
+ * | Available validators           | `size`, `file_size`, `image_dimensions`, `extension`, `required_alt_title` |</details><details>
+ * <summary>Single link (<code>link</code>)</summary>
+ *
+ * | Property                       | Value                       |
+ * | ------------------------------ | --------------------------- |
+ * | Code                           | `link`                      |
  * | Built-in editors for the field | `link_select`, `link_embed` |
- * | Default `editor` | `link_select` |
- * | Required validators | `item_item_type` |
- * | Other validators available | `required`, `unique` | </details><details> |<summary>Multiple links (<code>links</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | ----------------------------- | ------------------- |
- * | Code | `links` |
+ * | Default `editor`               | `link_select`               |
+ * | Required validators            | `item_item_type`            |
+ * | Other validators available     | `required`, `unique`        |</details><details>
+ * <summary>Multiple links (<code>links</code>)</summary>
+ *
+ * | Property                       | Value                         |
+ * | ------------------------------ | ----------------------------- |
+ * | Code                           | `links`                       |
  * | Built-in editors for the field | `links_select`, `links_embed` |
- * | Default `editor` | `links_select` |
- * | Required validators | `items_item_type` |
- * | Other validators available | `size` | </details><details> |<summary>Modular content (<code>rich_text</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | ------------------ | ------------------- |
- * | Code | `rich_text` |
- * | Built-in editors for the field | `rich_text` |
- * | Required validators | `rich_text_blocks` |
- * | Other validators available | `size` | </details><details> |<summary>Structured text (<code>structured_text</code>)</summary>
- *
- * | Property | Value |
- *
- * | ------------------------------ | ------------------------------------------------- | ---------- |
- * | Code | `structured_text` |
- * | Built-in editors for the field | `structured_text` |
- * | Required validators | `structured_text_blocks`, `structured_text_links` |
- * | Other validators available | `length` | </details> |
- *
- * ### Validators<details><summary><code>date_range</code></summary>
+ * | Default `editor`               | `links_select`                |
+ * | Required validators            | `items_item_type`             |
+ * | Other validators available     | `size`                        |</details><details>
+ * <summary>Modular content (<code>rich_text</code>)</summary>
+ *
+ * | Property                       | Value              |
+ * | ------------------------------ | ------------------ |
+ * | Code                           | `rich_text`        |
+ * | Built-in editors for the field | `rich_text`        |
+ * | Required validators            | `rich_text_blocks` |
+ * | Other validators available     | `size`             |</details><details>
+ * <summary>Structured text (<code>structured_text</code>)</summary>
+ *
+ * | Property                       | Value                                             |
+ * | ------------------------------ | ------------------------------------------------- |
+ * | Code                           | `structured_text`                                 |
+ * | Built-in editors for the field | `structured_text`                                 |
+ * | Required validators            | `structured_text_blocks`, `structured_text_links` |
+ * | Other validators available     | `length`                                          |</details>
+ *
+ * ### Validators<details>
+ * <summary><code>date_range</code></summary>
  *
  * Accept dates only inside a specified date range.
  *
@@ -3393,8 +3491,8 @@ export interface ItemTypeDestroyJobSchema {
  * | `min`     | ISO 8601 date |          | Minimum date |
  * | `max`     | ISO 8601 date |          | Maximum date |
  *
- * At least one of the parameters must be
- * specified.</details><details><summary><code>date_time_range</code></summary>
+ * At least one of the parameters must be specified.</details><details>
+ * <summary><code>date_time_range</code></summary>
  *
  * Accept date times only inside a specified date range.
  *
@@ -3403,14 +3501,15 @@ export interface ItemTypeDestroyJobSchema {
  * | `min`     | ISO 8601 datetime |          | Minimum datetime |
  * | `max`     | ISO 8601 datetime |          | Maximum datetime |
  *
- * At least one of the parameters must be
- * specified.</details><details><summary><code>enum</code></summary>
+ * At least one of the parameters must be specified.</details><details>
+ * <summary><code>enum</code></summary>
  *
  * Only accept a specific set of values
  *
  * | Parameter | Type            | Required | Description           |
- * | --------- | --------------- | -------- | --------------------- | ------------------- | ----------------------------------------- |
- * | `values`  | `Array<String>` | ✅       | Set of allowed values | </details><details> | <summary><code>extension</code></summary> |
+ * | --------- | --------------- | -------- | --------------------- |
+ * | `values`  | `Array<String>` | ✅       | Set of allowed values |</details><details>
+ * <summary><code>extension</code></summary>
  *
  * Only accept assets with specific file extensions.
  *
@@ -3419,8 +3518,8 @@ export interface ItemTypeDestroyJobSchema {
  * | `extensions`      | `Array<String>`                                                    |          | Set of allowed file extensions |
  * | `predefined_list` | one of `"image"`, `"transformable_image"`, `"video"`, `"document"` |          | Allowed file type              |
  *
- * Only one of the parameters must be
- * specified.</details><details><summary><code>file_size</code></summary>
+ * Only one of the parameters must be specified.</details><details>
+ * <summary><code>file_size</code></summary>
  *
  * Accept assets only inside a specified date range.
  *
@@ -3431,8 +3530,8 @@ export interface ItemTypeDestroyJobSchema {
  * | `max_value` | `Integer`                    |          | Numeric value for maximum filesize |
  * | `max_unit`  | one of `"B"`, `"KB"`, `"MB"` |          | Unit for maximum filesize          |
  *
- * At least one couple of value/unit must be
- * specified.</details><details><summary><code>format</code></summary>
+ * At least one couple of value/unit must be specified.</details><details>
+ * <summary><code>format</code></summary>
  *
  * Only accept strings having a specific format.
  *
@@ -3441,8 +3540,8 @@ export interface ItemTypeDestroyJobSchema {
  * | `custom_pattern`     | `Regexp`                  |          | Regular expression to be validated |
  * | `predefined_pattern` | one of `"email"`, `"url"` |          | Allowed format                     |
  *
- * Only one of the parameters must be
- * specified.</details><details><summary><code>slug_format</code></summary>
+ * Only one of the parameters must be specified.</details><details>
+ * <summary><code>slug_format</code></summary>
  *
  * Only accept slugs having a specific format.
  *
@@ -3451,8 +3550,8 @@ export interface ItemTypeDestroyJobSchema {
  * | `custom_pattern`     | `Regexp`         |          | Regular expression to be validated |
  * | `predefined_pattern` | `"webpage_slug"` |          | Allowed format                     |
  *
- * Only one of the parameters must be
- * specified.</details><details><summary><code>image_dimensions</code></summary>
+ * Only one of the parameters must be specified.</details><details>
+ * <summary><code>image_dimensions</code></summary>
  *
  * Accept assets only within a specified height/width range.
  *
@@ -3463,8 +3562,8 @@ export interface ItemTypeDestroyJobSchema {
  * | `height_min_value` | `Integer` |          | Numeric value for minimum width  |
  * | `height_max_value` | `Integer` |          | Numeric value for maximum height |
  *
- * At least one parameter must be
- * specified.</details><details><summary><code>item_item_type</code></summary>
+ * At least one parameter must be specified.</details><details>
+ * <summary><code>item_item_type</code></summary>
  *
  * Only accept references to records of the specified models.
  *
@@ -3491,8 +3590,8 @@ export interface ItemTypeDestroyJobSchema {
  *
  * - `"fail"`: Fail the operation and notify the user
  * - `"delete_references"`: Try to remove the reference to the deleted record (if
- *   the field has a `required` validation it will
- *   fail)</details><details><summary><code>items_item_type</code></summary>
+ *   the field has a `required` validation it will fail)</details><details>
+ * <summary><code>items_item_type</code></summary>
  *
  * Only accept references to records of the specified models.
  *
@@ -3519,8 +3618,8 @@ export interface ItemTypeDestroyJobSchema {
  *
  * - `"fail"`: Fail the operation and notify the user
  * - `"delete_references"`: Try to remove the reference to the deleted record (if
- *   the field has a `required` validation it will
- *   fail)</details><details><summary><code>length</code></summary>
+ *   the field has a `required` validation it will fail)</details><details>
+ * <summary><code>length</code></summary>
  *
  * Accept strings only with a specified number of characters.
  *
@@ -3530,8 +3629,8 @@ export interface ItemTypeDestroyJobSchema {
  * | `eq`      | `Integer` |          | Expected length |
  * | `max`     | `Integer` |          | Maximum length  |
  *
- * At least one parameter must be
- * specified.</details><details><summary><code>number_range</code></summary>
+ * At least one parameter must be specified.</details><details>
+ * <summary><code>number_range</code></summary>
  *
  * Accept numbers only inside a specified range.
  *
@@ -3540,11 +3639,11 @@ export interface ItemTypeDestroyJobSchema {
  * | `min`     | `Float` |          | Minimum value |
  * | `max`     | `Float` |          | Maximum value |
  *
- * At least one of the parameters must be
- * specified.</details><details><summary><code>required</code></summary>
+ * At least one of the parameters must be specified.</details><details>
+ * <summary><code>required</code></summary>
  *
- * Value must be specified or it won't be
- * valid.</details><details><summary><code>required_alt_title</code></summary>
+ * Value must be specified or it won't be valid.</details><details>
+ * <summary><code>required_alt_title</code></summary>
  *
  * Assets contained in the field are required to specify custom title or
  * alternate text, or they won't be valid.
@@ -3554,8 +3653,8 @@ export interface ItemTypeDestroyJobSchema {
  * | `title`   | `Boolean` |          | Whether the title for the asset must be specified          |
  * | `alt`     | `Boolean` |          | Whether the alternate text for the asset must be specified |
  *
- * At least one of the parameters must be
- * specified.</details><details><summary><code>required_seo_fields</code></summary>
+ * At least one of the parameters must be specified.</details><details>
+ * <summary><code>required_seo_fields</code></summary>
  *
  * SEO field is to specify one or more properties, or it won't be valid.
  *
@@ -3566,8 +3665,8 @@ export interface ItemTypeDestroyJobSchema {
  * | `image`        | `Boolean` |          | Whether the social sharing image must be specified |
  * | `twitter_card` | `Boolean` |          | Whether the type of Twitter card must be specified |
  *
- * At least one of the parameters must be
- * specified.</details><details><summary><code>title_length</code></summary>
+ * At least one of the parameters must be specified.</details><details>
+ * <summary><code>title_length</code></summary>
  *
  * Limits the length of the title for a SEO field. Search engines usually
  * truncate title tags to 60 character so it is a good practice to keep the
@@ -3578,8 +3677,8 @@ export interface ItemTypeDestroyJobSchema {
  * | `min`     | `Integer` |          | Minimum value |
  * | `max`     | `Integer` |          | Maximum value |
  *
- * At least one of the parameters must be
- * specified.</details><details><summary><code>description_length</code></summary>
+ * At least one of the parameters must be specified.</details><details>
+ * <summary><code>description_length</code></summary>
  *
  * Limits the length of the description for a SEO field. Search engines usually
  * truncate description tags to 160 character so it is a good practice to keep
@@ -3590,20 +3689,22 @@ export interface ItemTypeDestroyJobSchema {
  * | `min`     | `Integer` |          | Minimum value |
  * | `max`     | `Integer` |          | Maximum value |
  *
- * At least one of the parameters must be
- * specified.</details><details><summary><code>rich_text_blocks</code></summary>
+ * At least one of the parameters must be specified.</details><details>
+ * <summary><code>rich_text_blocks</code></summary>
  *
  * Only accept references to block records of the specified block models.
  *
  * | Parameter    | Type                    | Required | Description                    |
- * | ------------ | ----------------------- | -------- | ------------------------------ | ------------------- | ------------------------------------------------------ |
- * | `item_types` | `Array<Block Model ID>` | ✅       | Set of allowed Block Model IDs | </details><details> | <summary><code>structured_text_blocks</code></summary> |
+ * | ------------ | ----------------------- | -------- | ------------------------------ |
+ * | `item_types` | `Array<Block Model ID>` | ✅       | Set of allowed Block Model IDs |</details><details>
+ * <summary><code>structured_text_blocks</code></summary>
  *
  * Only accept references to block records of the specified block models.
  *
  * | Parameter    | Type                    | Required | Description                    |
- * | ------------ | ----------------------- | -------- | ------------------------------ | ------------------- | ----------------------------------------------------- |
- * | `item_types` | `Array<Block Model ID>` | ✅       | Set of allowed Block Model IDs | </details><details> | <summary><code>structured_text_links</code></summary> |
+ * | ------------ | ----------------------- | -------- | ------------------------------ |
+ * | `item_types` | `Array<Block Model ID>` | ✅       | Set of allowed Block Model IDs |</details><details>
+ * <summary><code>structured_text_links</code></summary>
  *
  * Only accept `itemLink` to `inlineItem` nodes for records of the specified
  * models.
@@ -3631,8 +3732,8 @@ export interface ItemTypeDestroyJobSchema {
  *
  * - `"fail"`: Fail the operation and notify the user
  * - `"delete_references"`: Try to remove the reference to the deleted record (if
- *   the field has a `required` validation it will
- *   fail)</details><details><summary><code>size</code></summary>
+ *   the field has a `required` validation it will fail)</details><details>
+ * <summary><code>size</code></summary>
  *
  * Only accept a number of items within the specified range.
  *
@@ -3643,108 +3744,122 @@ export interface ItemTypeDestroyJobSchema {
  * | `max`         | `Integer` |          | Maximum length                                     |
  * | `multiple_of` | `Integer` |          | The number of items must be multiple of this value |
  *
- * At least one parameter must be
- * specified.</details><details><summary><code>slug_title_field</code></summary>
+ * At least one parameter must be specified.</details><details>
+ * <summary><code>slug_title_field</code></summary>
  *
  * Specifies the ID of the _Single-line string_ field that will be used to
  * generate the slug
  *
  * | Parameter        | Type       | Required | Description                                      |
- * | ---------------- | ---------- | -------- | ------------------------------------------------ | ------------------- | -------------------------------------- |
- * | `title_field_id` | `Field ID` | ✅       | The field that will be used to generate the slug | </details><details> | <summary><code>unique</code></summary> |
+ * | ---------------- | ---------- | -------- | ------------------------------------------------ |
+ * | `title_field_id` | `Field ID` | ✅       | The field that will be used to generate the slug |</details><details>
+ * <summary><code>unique</code></summary>
  *
  * The value must be unique across the whole collection of records.</details>
  *
  * ### Configuration parameters for DatoCMS built-in field editors
  *
  * If a field editor is not specified in this table, just pass an empty object
- * `{}` as its configuration
- * parameters.<details><summary><code>boolean_radio_group</code></summary>
+ * `{}` as its configuration parameters.<details>
+ * <summary><code>boolean_radio_group</code></summary>
  *
  * Radio group input for _boolean_ fields.
  *
  * | Parameter        | Type                               | Required | Description                               |
- * | ---------------- | ---------------------------------- | -------- | ----------------------------------------- | ------------------- | -------------------------------------------------- |
+ * | ---------------- | ---------------------------------- | -------- | ----------------------------------------- |
  * | `positive_radio` | `{ label: string, hint?: string }` | ✅       | Radio input for positive choice (`true`)  |
- * | `negative_radio` | `{ label: string, hint?: string }` | ✅       | Radio input for negative choice (`false`) | </details><details> | <summary><code>string_radio_group</code></summary> |
+ * | `negative_radio` | `{ label: string, hint?: string }` | ✅       | Radio input for negative choice (`false`) |</details><details>
+ * <summary><code>string_radio_group</code></summary>
  *
  * Radio group input for _string_ fields.
  *
  * | Parameter | Type                                                     | Required | Description                 |
- * | --------- | -------------------------------------------------------- | -------- | --------------------------- | ------------------- | --------------------------------------------- |
- * | `radios`  | `Array<{ label: string, value: string, hint?: string }>` | ✅       | The different radio options | </details><details> | <summary><code>string_select</code></summary> |
+ * | --------- | -------------------------------------------------------- | -------- | --------------------------- |
+ * | `radios`  | `Array<{ label: string, value: string, hint?: string }>` | ✅       | The different radio options |</details><details>
+ * <summary><code>string_select</code></summary>
  *
  * Select input for _string_ fields.
  *
  * | Parameter | Type                                                     | Required | Description                  |
- * | --------- | -------------------------------------------------------- | -------- | ---------------------------- | ------------------- | --------------------------------------------------- |
- * | `options` | `Array<{ label: string, value: string, hint?: string }>` | ✅       | The different select options | </details><details> | <summary><code>string_multi_select</code></summary> |
+ * | --------- | -------------------------------------------------------- | -------- | ---------------------------- |
+ * | `options` | `Array<{ label: string, value: string, hint?: string }>` | ✅       | The different select options |</details><details>
+ * <summary><code>string_multi_select</code></summary>
  *
  * Select input for _JSON_ fields, to edit an array of strings.
  *
  * | Parameter | Type                                                     | Required | Description                  |
- * | --------- | -------------------------------------------------------- | -------- | ---------------------------- | ------------------- | ----------------------------------------------------- |
- * | `options` | `Array<{ label: string, value: string, hint?: string }>` | ✅       | The different select options | </details><details> | <summary><code>string_checkbox_group</code></summary> |
+ * | --------- | -------------------------------------------------------- | -------- | ---------------------------- |
+ * | `options` | `Array<{ label: string, value: string, hint?: string }>` | ✅       | The different select options |</details><details>
+ * <summary><code>string_checkbox_group</code></summary>
  *
  * Multiple chechboxes input for _JSON_ fields, to edit an array of strings.
  *
  * | Parameter | Type                                                     | Required | Description                  |
- * | --------- | -------------------------------------------------------- | -------- | ---------------------------- | ------------------- | ------------------------------------------- |
- * | `options` | `Array<{ label: string, value: string, hint?: string }>` | ✅       | The different select options | </details><details> | <summary><code>single_line</code></summary> |
+ * | --------- | -------------------------------------------------------- | -------- | ---------------------------- |
+ * | `options` | `Array<{ label: string, value: string, hint?: string }>` | ✅       | The different select options |</details><details>
+ * <summary><code>single_line</code></summary>
  *
  * Simple textual input for _Single-line string_ fields.
  *
  * | Parameter | Type      | Required | Description                                                                      |
- * | --------- | --------- | -------- | -------------------------------------------------------------------------------- | ------------------- | ---------------------------------------- |
- * | `heading` | `Boolean` | ✅       | Indicates if the field should be shown bigger, as a field representing a heading | </details><details> | <summary><code>markdown</code></summary> |
+ * | --------- | --------- | -------- | -------------------------------------------------------------------------------- |
+ * | `heading` | `Boolean` | ✅       | Indicates if the field should be shown bigger, as a field representing a heading |</details><details>
+ * <summary><code>markdown</code></summary>
  *
  * Markdown editor for _Multiple-paragraph text_ fields.
  *
  * | Parameter | Type            | Required | Description                                                                                                                                                                                                       |
- * | --------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | --------------------------------------- |
- * | `toolbar` | `Array<String>` | ✅       | Specify which buttons the toolbar should have. Valid values: `"heading"`, `"bold"`, `"italic"`, `"strikethrough"`, `"code"`, `"unordered_list"`, `"ordered_list"`, `"quote"`, `"link"`, `"image"`, `"fullscreen"` | </details><details> | <summary><code>wysiwyg</code></summary> |
+ * | --------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+ * | `toolbar` | `Array<String>` | ✅       | Specify which buttons the toolbar should have. Valid values: `"heading"`, `"bold"`, `"italic"`, `"strikethrough"`, `"code"`, `"unordered_list"`, `"ordered_list"`, `"quote"`, `"link"`, `"image"`, `"fullscreen"` |</details><details>
+ * <summary><code>wysiwyg</code></summary>
  *
  * HTML editor for _Multiple-paragraph text_ fields.
  *
  * | Parameter | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                     |
- * | --------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ---------------------------------------- |
- * | `toolbar` | `Array<String>` | ✅       | Specify which buttons the toolbar should have. Valid values: `"format"`, `"bold"`, `"italic"`, `"strikethrough"`, `"code"`, `"ordered_list"`, `"unordered_list"`, `"quote"`, `"table"`, `"link"`, `"image"`, `"show_source"`, `"undo"`, `"redo"`, `"align_left"`, `"align_center"`, `"align_right"`, `"align_justify"`, `"outdent"`, `"indent"`, `"fullscreen"` | </details><details> | <summary><code>textarea</code></summary> |
+ * | --------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+ * | `toolbar` | `Array<String>` | ✅       | Specify which buttons the toolbar should have. Valid values: `"format"`, `"bold"`, `"italic"`, `"strikethrough"`, `"code"`, `"ordered_list"`, `"unordered_list"`, `"quote"`, `"table"`, `"link"`, `"image"`, `"show_source"`, `"undo"`, `"redo"`, `"align_left"`, `"align_center"`, `"align_right"`, `"align_justify"`, `"outdent"`, `"indent"`, `"fullscreen"` |</details><details>
+ * <summary><code>textarea</code></summary>
  *
- * Basic textarea editor for _Multiple-paragraph text_
- * fields.</details><details><summary><code>color_picker</code></summary>
+ * Basic textarea editor for _Multiple-paragraph text_ fields.</details><details>
+ * <summary><code>color_picker</code></summary>
  *
  * Built-in editor for _Color_ fields.
  *
  * | Parameter       | Type                      | Required | Description                                               |
- * | --------------- | ------------------------- | -------- | --------------------------------------------------------- | ------------------- | ------------------------------------ |
+ * | --------------- | ------------------------- | -------- | --------------------------------------------------------- |
  * | `enable_alpha`  | `Boolean`                 | ✅       | Should the color picker allow to specify the alpha value? |
- * | `preset_colors` | `Array<Hex color string>` | ✅       | List of preset colors to offer to the user                | </details><details> | <summary><code>slug</code></summary> |
+ * | `preset_colors` | `Array<Hex color string>` | ✅       | List of preset colors to offer to the user                |</details><details>
+ * <summary><code>slug</code></summary>
  *
  * Built-in editor for _Slug_ fields.
  *
  * | Parameter    | Type     | Required | Description                                                                            |
- * | ------------ | -------- | -------- | -------------------------------------------------------------------------------------- | ------------------- | ----------------------------------------- |
- * | `url_prefix` | `String` |          | A prefix that will be shown in the editor's form to give some context to your editors. | </details><details> | <summary><code>rich_text</code></summary> |
+ * | ------------ | -------- | -------- | -------------------------------------------------------------------------------------- |
+ * | `url_prefix` | `String` |          | A prefix that will be shown in the editor's form to give some context to your editors. |</details><details>
+ * <summary><code>rich_text</code></summary>
  *
  * Built-in editor for _Modular content_ fields.
  *
  * | Parameter         | Type      | Required | Description                                                |
- * | ----------------- | --------- | -------- | ---------------------------------------------------------- | ------------------- | ----------------------------------------------- |
- * | `start_collapsed` | `Boolean` |          | Whether you want block records collapsed by default or not | </details><details> | <summary><code>structured_text</code></summary> |
+ * | ----------------- | --------- | -------- | ---------------------------------------------------------- |
+ * | `start_collapsed` | `Boolean` |          | Whether you want block records collapsed by default or not |</details><details>
+ * <summary><code>structured_text</code></summary>
  *
  * Built-in editor for _Structured text_ fields.
  *
- * | Parameter                 | Type            | Required | Description                                                                                                                                   |
- * | ------------------------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ------------------------------------------------------------------------- |
- * | `nodes`                   | `Array<String>` | ✅       | Specify which nodes the field should allow. Valid values: `"blockquote"`, `"code"`, `"heading"`, `"link"`, `"list"`, `"thematicBreak"`        |
- * | `marks`                   | `Array<String>` | ✅       | Specify which marks the field should allow. Valid values: `"strong"`, `"emphasis"`, `"underline"`, `"strikethrough"`, `"code"`, `"highlight"` |
- * | `blocks_start_collapsed`  | `Boolean`       |          | Whether you want block nodes collapsed by default or not                                                                                      |
- * | `show_links_target_blank` | `Boolean`       |          | Whether you want to show the "Open this link in a new tab?" checkbox, that fills in the `target: "_blank"` meta attribute for links           |
- * | `show_links_meta_editor`  | `Boolean`       |          | Whether you want to show the complete meta editor for links                                                                                   | </details><details> | <summary><code>link_select</code> and <code>links_select</code></summary> |
+ * | Parameter                 | Type             | Required | Description                                                                                                                                   |
+ * | ------------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+ * | `nodes`                   | `Array<String>`  | ✅       | Specify which nodes the field should allow. Valid values: `"blockquote"`, `"code"`, `"heading"`, `"link"`, `"list"`, `"thematicBreak"`        |
+ * | `marks`                   | `Array<String>`  | ✅       | Specify which marks the field should allow. Valid values: `"strong"`, `"emphasis"`, `"underline"`, `"strikethrough"`, `"code"`, `"highlight"` |
+ * | `heading_levels`          | `Array<Integer>` | ✅       | If `nodes` includes `"heading"`, specify which heading levels the field should allow. Valid values: numbers between 1 and 6                   |
+ * | `blocks_start_collapsed`  | `Boolean`        |          | Whether you want block nodes collapsed by default or not                                                                                      |
+ * | `show_links_target_blank` | `Boolean`        |          | Whether you want to show the "Open this link in a new tab?" checkbox, that fills in the `target: "_blank"` meta attribute for links           |
+ * | `show_links_meta_editor`  | `Boolean`        |          | Whether you want to show the complete meta editor for links                                                                                   |</details><details>
+ * <summary><code>link_select</code> and <code>links_select</code></summary>
  *
  * Use a select input with auto-completion to pick the records to reference
- * inside the field.</details><details><summary><code>link_embed</code> and
- * <code>links_embed</code></summary>
+ * inside the field.</details><details>
+ * <summary><code>link_embed</code> and <code>links_embed</code></summary>
  *
  * Use an expanded view with records' image preview to pick the records to
  * reference inside the field.</details>
@@ -3768,7 +3883,7 @@ export interface FieldAttributes {
     /** The label of the field */
     label: string;
     /** Type of input */
-    field_type: string;
+    field_type: 'string' | 'text' | 'boolean' | 'integer' | 'float' | 'date' | 'date_time' | 'color' | 'json' | 'lat_lon' | 'seo' | 'slug' | 'video' | 'file' | 'gallery' | 'link' | 'links' | 'rich_text' | 'structured_text';
     /** Whether the field needs to be multilanguage or not */
     localized: boolean;
     /**
@@ -3787,7 +3902,7 @@ export interface FieldAttributes {
         [k: string]: unknown;
     };
     /** Field appearance */
-    appeareance: {
+    appeareance?: {
         editor: string;
         parameters: {
             [k: string]: unknown;
@@ -3857,7 +3972,7 @@ export interface FieldCreateSchema {
             /** The label of the field */
             label: string;
             /** Type of input */
-            field_type: string;
+            field_type: 'string' | 'text' | 'boolean' | 'integer' | 'float' | 'date' | 'date_time' | 'color' | 'json' | 'lat_lon' | 'seo' | 'slug' | 'video' | 'file' | 'gallery' | 'link' | 'links' | 'rich_text' | 'structured_text';
             /** Field API key */
             api_key: string;
             /** Whether the field needs to be multilanguage or not */
@@ -4011,7 +4126,7 @@ export interface FieldUpdateSchema {
             /** Ordering index */
             position?: number;
             /** Type of input */
-            field_type?: string;
+            field_type?: 'string' | 'text' | 'boolean' | 'integer' | 'float' | 'date' | 'date_time' | 'color' | 'json' | 'lat_lon' | 'seo' | 'slug' | 'video' | 'file' | 'gallery' | 'link' | 'links' | 'rich_text' | 'structured_text';
             /** Field hint */
             hint?: string | null;
         };
@@ -4174,6 +4289,7 @@ export interface FieldsetCreateSchema {
  */
 export interface FieldsetCreateTargetSchema {
     data: Fieldset;
+    included?: ItemType[];
 }
 /**
  * This interface was referenced by `Fieldset`'s JSON-Schema via the
@@ -4756,6 +4872,10 @@ export interface ItemMeta {
     status: null | ('draft' | 'updated' | 'published');
     /** Whether the current record is valid or not */
     is_valid: boolean;
+    /** Whether the current version of the record is valid or not */
+    is_current_version_valid: null | boolean;
+    /** Whether the published version of record is valid or not */
+    is_published_version_valid: null | boolean;
     /** The ID of the current record version */
     current_version: string;
     /** Workflow stage in which the item is */
@@ -4845,6 +4965,10 @@ export interface ItemCreateSchema {
             status?: null | ('draft' | 'updated' | 'published');
             /** Whether the current record is valid or not */
             is_valid?: boolean;
+            /** Whether the current version of the record is valid or not */
+            is_current_version_valid?: null | boolean;
+            /** Whether the published version of the record is valid or not */
+            is_published_version_valid?: null | boolean;
             /** The ID of the current record version */
             current_version?: string;
         };
@@ -4914,6 +5038,10 @@ export interface ItemUpdateSchema {
              * example)
              */
             current_version?: string;
+            /** Whether the current version of the record is valid or not */
+            is_current_version_valid?: null | boolean;
+            /** Whether the published version of record is valid or not */
+            is_published_version_valid?: null | boolean;
             /** The new stage to move the record to */
             stage?: string | null;
         };
@@ -5596,7 +5724,7 @@ export interface UploadBatchAddTagsSchema {
         type: UploadType;
         attributes: {
             /** Tags */
-            tags?: string[];
+            tags: string[];
         };
     };
 }
@@ -5919,13 +6047,13 @@ export interface SearchResult {
  * `definition` "attributes".
  */
 export interface SearchResultAttributes {
-    /** Page title */
+    /** Title of the page */
     title: string;
-    /** First lines of body */
+    /** First 200 characters of page body, unformatted */
     body_excerpt: string;
     /** URL */
     url: string;
-    /** Score */
+    /** Search score */
     score: number;
     highlight: {
         title?: string[] | null;
@@ -5948,7 +6076,7 @@ export interface SearchResultData {
  */
 export interface SearchResultInstancesTargetSchema {
     data: SearchResult[];
-    meta?: {
+    meta: {
         total_count: number;
     };
 }
@@ -6530,10 +6658,52 @@ export interface ItemTypeFilter {
 export interface ItemTypeFilterAttributes {
     /** The name of the filter */
     name: string;
-    /** The actual filter */
+    /**
+     * The actual filter. It follows the form of the `filter` query parameter of
+     * the [List all
+     * records](https://www.datocms.com/docs/content-management-api/resources/item/instances)
+     * endpoint.
+     */
     filter: {
         [k: string]: unknown;
     };
+    /** The columns to show with this filter */
+    columns: [
+        {
+            /**
+             * Can be either the API key of a model's field, or one of the
+             * following meta columns: `id`, `_preview`, `_updated_at`,
+             * `_created_at`, `_creator`, `_status`, `_published_at`,
+             * `_first_published_at`, `_publication_scheduled_at`,
+             * `_unpublishing_scheduled_at`, `position` (only for sortable
+             * models), `_stage (only for models associated with a workflow).
+             */
+            name: string;
+            /** The percentage width for the column (float, from 0 to 1.0) */
+            width: number;
+        },
+        ...{
+            /**
+             * Can be either the API key of a model's field, or one of the
+             * following meta columns: `id`, `_preview`, `_updated_at`,
+             * `_created_at`, `_creator`, `_status`, `_published_at`,
+             * `_first_published_at`, `_publication_scheduled_at`,
+             * `_unpublishing_scheduled_at`, `position` (only for sortable
+             * models), `_stage (only for models associated with a workflow).
+             */
+            name: string;
+            /** The percentage width for the column (float, from 0 to 1.0) */
+            width: number;
+        }[]
+    ] | null;
+    /**
+     * The ordering to apply with this filter, or `null` for the default model
+     * ordering. It follows the form of the `order_by` query parameter of the
+     * [List all
+     * records](https://www.datocms.com/docs/content-management-api/resources/item/instances)
+     * endpoint.
+     */
+    order_by: string | null;
     /** Whether it's a shared filter or not */
     shared: boolean;
 }
@@ -6549,16 +6719,6 @@ export interface ItemTypeFilterRelationships {
         data: ItemTypeData;
     };
 }
-/**
- * JSON API data
- *
- * This interface was referenced by `ItemTypeFilter`'s JSON-Schema via the
- * `definition` "data".
- */
-export interface ItemTypeFilterData {
-    type: ItemTypeFilterType;
-    id: ItemTypeFilterIdentity;
-}
 /**
  * This interface was referenced by `ItemTypeFilter`'s JSON-Schema via the
  * `create.schema` link.
@@ -6569,12 +6729,54 @@ export interface ItemTypeFilterCreateSchema {
         attributes: {
             /** The name of the filter */
             name: string;
-            /** The actual filter */
-            filter: {
+            /**
+             * The actual filter. It follows the form of the `filter` query parameter
+             * of the [List all
+             * records](https://www.datocms.com/docs/content-management-api/resources/item/instances)
+             * endpoint.
+             */
+            filter?: {
                 [k: string]: unknown;
             };
+            /** The columns to show with this filter */
+            columns?: [
+                {
+                    /**
+                     * Can be either the API key of a model's field, or one of the
+                     * following meta columns: `id`, `_preview`, `_updated_at`,
+                     * `_created_at`, `_creator`, `_status`, `_published_at`,
+                     * `_first_published_at`, `_publication_scheduled_at`,
+                     * `_unpublishing_scheduled_at`, `position` (only for sortable
+                     * models), `_stage (only for models associated with a workflow).
+                     */
+                    name: string;
+                    /** The percentage width for the column (float, from 0 to 1.0) */
+                    width: number;
+                },
+                ...{
+                    /**
+                     * Can be either the API key of a model's field, or one of the
+                     * following meta columns: `id`, `_preview`, `_updated_at`,
+                     * `_created_at`, `_creator`, `_status`, `_published_at`,
+                     * `_first_published_at`, `_publication_scheduled_at`,
+                     * `_unpublishing_scheduled_at`, `position` (only for sortable
+                     * models), `_stage (only for models associated with a workflow).
+                     */
+                    name: string;
+                    /** The percentage width for the column (float, from 0 to 1.0) */
+                    width: number;
+                }[]
+            ] | null;
+            /**
+             * The ordering to apply with this filter, or `null` for the default model
+             * ordering. It follows the form of the `order_by` query parameter of the
+             * [List all
+             * records](https://www.datocms.com/docs/content-management-api/resources/item/instances)
+             * endpoint.
+             */
+            order_by?: string | null;
             /** Whether it's a shared filter or not */
-            shared: boolean;
+            shared?: boolean;
         };
         relationships: {
             /** Model associated with the filter */
@@ -6602,14 +6804,62 @@ export interface ItemTypeFilterUpdateSchema {
         /** JSON API attributes */
         attributes: {
             /** The name of the filter */
-            name: string;
+            name?: string;
+            /** The columns to show with this filter */
+            columns?: [
+                {
+                    /**
+                     * Can be either the API key of a model's field, or one of the
+                     * following meta columns: `id`, `_preview`, `_updated_at`,
+                     * `_created_at`, `_creator`, `_status`, `_published_at`,
+                     * `_first_published_at`, `_publication_scheduled_at`,
+                     * `_unpublishing_scheduled_at`, `position` (only for sortable
+                     * models), `_stage (only for models associated with a workflow).
+                     */
+                    name: string;
+                    /** The percentage width for the column (float, from 0 to 1.0) */
+                    width: number;
+                },
+                ...{
+                    /**
+                     * Can be either the API key of a model's field, or one of the
+                     * following meta columns: `id`, `_preview`, `_updated_at`,
+                     * `_created_at`, `_creator`, `_status`, `_published_at`,
+                     * `_first_published_at`, `_publication_scheduled_at`,
+                     * `_unpublishing_scheduled_at`, `position` (only for sortable
+                     * models), `_stage (only for models associated with a workflow).
+                     */
+                    name: string;
+                    /** The percentage width for the column (float, from 0 to 1.0) */
+                    width: number;
+                }[]
+            ] | null;
+            /**
+             * The ordering to apply with this filter, or `null` for the default model
+             * ordering. It follows the form of the `order_by` query parameter of the
+             * [List all
+             * records](https://www.datocms.com/docs/content-management-api/resources/item/instances)
+             * endpoint.
+             */
+            order_by?: string | null;
             /** Whether it's a shared filter or not */
             shared?: boolean;
-            /** The actual filter */
-            filter: {
+            /**
+             * The actual filter. It follows the form of the `filter` query parameter
+             * of the [List all
+             * records](https://www.datocms.com/docs/content-management-api/resources/item/instances)
+             * endpoint.
+             */
+            filter?: {
                 [k: string]: unknown;
             };
         };
+        relationships?: {
+            /** Model associated with the filter */
+            item_type: {
+                data: ItemTypeData;
+            };
+        };
     };
 }
 /**
@@ -6777,6 +7027,8 @@ export interface SiteInvitation {
 export interface SiteInvitationAttributes {
     /** Email */
     email: string;
+    /** Whether this invitation has expired */
+    expired: boolean;
 }
 /**
  * JSON API links
@@ -7103,6 +7355,8 @@ export interface SsoSettings {
 export interface SsoSettingsAttributes {
     /** URL of Identity Provider SAML Metadata endpoint */
     idp_saml_metadata_url: null | string;
+    /** Identity Provider SAML Metadata */
+    idp_saml_metadata_xml?: null | string;
     /** DatoCMS SCIM base URL */
     scim_base_url: string;
     /** DatoCMS SAML ACS URL */
@@ -7171,9 +7425,11 @@ export interface SsoSettingsUpdateSchema {
         id?: SsoSettingsIdentity;
         attributes?: {
             /** URL of Identity Provider SAML Metadata endpoint */
-            idp_saml_metadata_url: null | string;
+            idp_saml_metadata_url?: null | string;
+            /** Identity Provider SAML Metadata */
+            idp_saml_metadata_xml?: null | string;
         };
-        relationships: {
+        relationships?: {
             /**
              * The default role assigned to SSO users that do not belong to any SSO
              * group
@@ -7390,7 +7646,7 @@ export interface DailyUsageData {
  * `instances.targetSchema` link.
  */
 export interface DailyUsageInstancesTargetSchema {
-    data: DailyUsage;
+    data: DailyUsage[];
 }
 /**
  * You can use counters to analyze your project's data consumption over a period
@@ -7832,6 +8088,8 @@ export interface Workflow {
 export interface WorkflowAttributes {
     /** The name of the workflow */
     name: string;
+    /** Workflow API key */
+    api_key: string;
     /** The stages of the workflow */
     stages: [
         {
@@ -7863,11 +8121,12 @@ export interface WorkflowAttributes {
 export interface WorkflowCreateSchema {
     data: {
         type: WorkflowType;
-        id: WorkflowIdentity;
         /** JSON API attributes */
         attributes: {
             /** The name of the workflow */
             name: string;
+            /** Workflow API key */
+            api_key: string;
             /** The stages of the workflow */
             stages: [
                 {
@@ -7913,6 +8172,8 @@ export interface WorkflowUpdateSchema {
         attributes?: {
             /** The name of the workflow */
             name?: string;
+            /** Workflow API key */
+            api_key?: string;
             /** The stages of the workflow */
             stages?: [
                 {