datocms-plugin-sdk 0.6.15 → 0.6.17

package/src/SiteApiSchema.ts

@@ -1,4 +1,3 @@
-/* eslint-disable camelcase */
 /* tslint:disable */
 /**
  * This file was automatically generated by hyperschema-to-ts: DO NOT MODIFY IT
@@ -284,6 +283,23 @@ export type MenuItemIdentity = string;
  * `definition` "type".
  */
 export type ItemTypeType = 'item_type';
+/**
+ * JSON API type field
+ *
+ * This interface was referenced by `ItemTypeFilter`'s JSON-Schema via the
+ * `definition` "type".
+ */
+export 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 type ItemTypeFilterIdentity = string;
 /**
  * This interface was referenced by `MenuItem`'s JSON-Schema via the
  * `instances.hrefSchema` link.
@@ -352,6 +368,15 @@ export type FieldsetIdentity = string;
  * `definition` "type".
  */
 export type WorkflowType = 'workflow';
+/**
+ * This interface was referenced by `ItemType`'s JSON-Schema via the
+ * `create.hrefSchema` link.
+ */
+export 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
  *
@@ -369,6 +394,15 @@ export type JobType = 'job';
  * "id".
  */
 export type JobIdentity = string;
+/**
+ * This interface was referenced by `ItemType`'s JSON-Schema via the
+ * `destroy.hrefSchema` link.
+ */
+export 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
  *
@@ -532,10 +566,14 @@ export 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;
   /**
@@ -831,16 +869,32 @@ export type SearchResultIdentity = string;
  * `instances.hrefSchema` link.
  */
 export 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;
 };
 /**
@@ -925,23 +979,6 @@ export type WebhookCallInstancesHrefSchema = {
   };
   [k: string]: unknown;
 };
-/**
- * JSON API type field
- *
- * This interface was referenced by `ItemTypeFilter`'s JSON-Schema via the
- * `definition` "type".
- */
-export 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 type ItemTypeFilterIdentity = string;
 /**
  * JSON API type field
  *
@@ -2825,7 +2862,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;
 }
 
@@ -2840,6 +2877,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;
@@ -2861,6 +2905,17 @@ export interface ItemTypeData {
   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
  *
@@ -2886,8 +2941,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?: {
@@ -2895,6 +2950,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;
@@ -2922,12 +2984,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?: {
@@ -2935,6 +2997,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;
@@ -2989,6 +3058,7 @@ export interface ItemType {
   id: ItemTypeIdentity;
   attributes: ItemTypeAttributes;
   relationships: ItemTypeRelationships;
+  meta: ItemTypeMeta;
 }
 
 /**
@@ -3003,7 +3073,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 */
@@ -3043,6 +3113,8 @@ export interface ItemTypeAttributes {
    * model/block
    */
   hint: string | null;
+  /** Whether inverse relationships fields are expressed in GraphQL or not */
+  inverse_relationships_enabled: boolean;
 }
 
 /**
@@ -3130,6 +3202,20 @@ export interface WorkflowData {
   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.
@@ -3179,6 +3265,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 */
@@ -3269,6 +3357,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 */
@@ -3292,6 +3382,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;
+    };
   };
 }
 
@@ -3506,148 +3603,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>
+ * | Available validators           | `required`, `length`, `format`    |</details><details>
+ * <summary>Boolean (<code>boolean</code>)</summary>
  *
- * | Property | Value |
- *
- * | ------------------------------ | -------------------------------- | ------------------- |
- * | 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>
- *
- * | Property | Value |
+ * | Available validators           | `required`     |</details><details>
+ * <summary>JSON (<code>json</code>)</summary>
  *
- * | ------------------------------ | ------------------------------------------------------ | ------------------- |
- * | 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.
  *
@@ -3656,8 +3755,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.
  *
@@ -3666,14 +3765,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.
  *
@@ -3682,8 +3782,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.
  *
@@ -3694,8 +3794,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.
  *
@@ -3704,8 +3804,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.
  *
@@ -3714,8 +3814,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.
  *
@@ -3726,8 +3826,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.
  *
@@ -3754,8 +3854,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.
  *
@@ -3782,8 +3882,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.
  *
@@ -3793,8 +3893,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.
  *
@@ -3803,11 +3903,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.
@@ -3817,8 +3917,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.
  *
@@ -3829,8 +3929,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
@@ -3841,8 +3941,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
@@ -3853,20 +3953,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.
@@ -3894,8 +3996,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.
  *
@@ -3906,108 +4008,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>
@@ -4032,7 +4148,26 @@ 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;
   /**
@@ -4056,7 +4191,7 @@ export interface FieldAttributes {
     [k: string]: unknown;
   };
   /** Field appearance */
-  appeareance: {
+  appeareance?: {
     editor: string;
     parameters: {
       [k: string]: unknown;
@@ -4128,7 +4263,26 @@ 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 */
@@ -4295,7 +4449,26 @@ 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;
     };
@@ -4473,6 +4646,7 @@ export interface FieldsetCreateSchema {
  */
 export interface FieldsetCreateTargetSchema {
   data: Fieldset;
+  included?: ItemType[];
 }
 
 /**
@@ -5150,6 +5324,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 */
@@ -5243,6 +5421,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;
     };
@@ -5316,6 +5498,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;
     };
@@ -6046,7 +6232,7 @@ export interface UploadBatchAddTagsSchema {
     type: UploadType;
     attributes: {
       /** Tags */
-      tags?: string[];
+      tags: string[];
     };
   };
 }
@@ -6400,13 +6586,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;
@@ -6431,7 +6617,7 @@ export interface SearchResultData {
  */
 export interface SearchResultInstancesTargetSchema {
   data: SearchResult[];
-  meta?: {
+  meta: {
     total_count: number;
   };
 }
@@ -7056,10 +7242,54 @@ 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;
 }
@@ -7077,17 +7307,6 @@ export interface ItemTypeFilterRelationships {
   };
 }
 
-/**
- * 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.
@@ -7098,12 +7317,56 @@ 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 */
@@ -7133,14 +7396,64 @@ 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;
+      };
+    };
   };
 }
 
@@ -7324,6 +7637,8 @@ export interface SiteInvitation {
 export interface SiteInvitationAttributes {
   /** Email */
   email: string;
+  /** Whether this invitation has expired */
+  expired: boolean;
 }
 
 /**
@@ -7681,6 +7996,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 */
@@ -7754,9 +8071,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
@@ -7988,7 +8307,7 @@ export interface DailyUsageData {
  * `instances.targetSchema` link.
  */
 export interface DailyUsageInstancesTargetSchema {
-  data: DailyUsage;
+  data: DailyUsage[];
 }
 
 /**
@@ -8457,6 +8776,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: [
     {
@@ -8489,11 +8810,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: [
         {
@@ -8541,6 +8863,8 @@ export interface WorkflowUpdateSchema {
     attributes?: {
       /** The name of the workflow */
       name?: string;
+      /** Workflow API key */
+      api_key?: string;
       /** The stages of the workflow */
       stages?: [
         {