@storyblok/management-api-client 0.2.1 → 0.2.3

package/dist/generated/stories/types.gen.d.cts

@@ -1,478 +1,838 @@
-declare namespace types_gen_d_exports {
-  export { Blok, ClientOptions, CompareVersionsData, CompareVersionsErrors, CompareVersionsResponse, CompareVersionsResponses, ComponentContent, CreateData, CreateErrors, CreateResponse, CreateResponses, DeleteData, DeleteErrors, DeleteResponse, DeleteResponses, DuplicateData, DuplicateErrors, DuplicateResponse, DuplicateResponses, ExportData, ExportErrors, ExportResponse, ExportResponses, GetData, GetErrors, GetResponse, GetResponses, GetUnpublishedDependenciesData, GetUnpublishedDependenciesErrors, GetUnpublishedDependenciesResponse, GetUnpublishedDependenciesResponses, ImportData, ImportErrors, ImportResponse, ImportResponses, ListData, ListErrors, ListResponse, ListResponses, Page, PerPage, PublishData, PublishErrors, PublishResponse, PublishResponses, RestoreVersionsData, RestoreVersionsErrors, RestoreVersionsResponse, RestoreVersionsResponses, SpaceId, Story, Story2, StoryCreateRequest, StoryCreateRequest2, StoryDuplicateRequest, StoryId, StoryUpdateRequest, StoryUpdateRequest2, StoryVersion, StoryVersion2, StoryVersionComparison, TranslateData, TranslateErrors, TranslateResponse, TranslateResponses, UnpublishData, UnpublishErrors, UnpublishResponse, UnpublishResponses, UnpublishedStory, UpdateStoryData, UpdateStoryErrors, UpdateStoryResponse, UpdateStoryResponses, VersionsData, VersionsErrors, VersionsResponse, VersionsResponses };
-}
-type Story = Story2;
-type StoryCreateRequest = StoryCreateRequest2;
-type StoryUpdateRequest = StoryUpdateRequest2;
+//#region src/generated/stories/types.gen.d.ts
+type StoryCreate = StoryCreate2;
+type StoryUpdate = StoryUpdate2;
 /**
- * Request body for duplicating a story
+ * Minimal story object for alternates
+ */
+type StoryAlternate = {
+  /**
+   * The numeric ID
+   */
+  id: number;
+  /**
+   * The complete name provided for the story
+   */
+  name: string;
+  /**
+   * The slug specific for the story
+   */
+  slug: string;
+  /**
+   * true if a story is currently published, even if it has unpublished changes
+   */
+  published: boolean;
+  /**
+   * The full slug of the story, combining the parent folder(s) and the designated story slug
+   */
+  full_slug: string;
+  /**
+   * true if the instance constitutes a folder
+   */
+  is_folder: boolean;
+  /**
+   * ID of the parent folder. 0 for root-level stories.
+   */
+  parent_id: number;
+};
+/**
+ * Asset field type - single asset (image, video, audio, or document)
  */
-type StoryDuplicateRequest = {
-  story?: Story2 & {
+type AssetField = {
+  /**
+   * Identifies this as an asset field
+   */
+  fieldtype: 'asset';
+  /**
+   * Numeric ID of the asset
+   */
+  id: number | null;
+  /**
+   * Alternative text for the asset
+   */
+  alt: string | null;
+  /**
+   * Name of the asset
+   */
+  name?: string;
+  /**
+   * Focal point coordinates for cropping (format "123x456:789x1011")
+   */
+  focus?: string | null;
+  /**
+   * Title of the asset
+   */
+  title?: string | null;
+  /**
+   * Source attribution for the asset
+   */
+  source?: string | null;
+  /**
+   * URL to the asset file
+   */
+  filename: string;
+  /**
+   * Copyright information
+   */
+  copyright?: string | null;
+  /**
+   * Additional metadata for the asset
+   */
+  meta_data?: {
     [key: string]: unknown;
   };
   /**
-   * The id of the target folder
+   * Whether the asset is hosted externally
    */
-  target_dimension?: number;
+  is_external_url?: boolean;
+};
+/**
+ * Content object representing a component instance. Contains a _uid, a component technical name, and dynamic fields whose values depend on the component's schema field types (text, textarea, richtext, markdown, number, datetime, boolean, option, options, asset, multiasset, multilink, bloks, table, section, custom/plugin).
+ */
+type StoryContent = {
   /**
-   * If set to true, the current story's path attribute will used for the duplicated story
+   * Unique identifier for this component instance
    */
-  same_path?: boolean;
+  _uid: string;
+  /**
+   * Technical name of the component (content type or nestable block)
+   */
+  component: string;
+  /**
+   * Storyblok editor markup string for inline editing (present in draft/preview mode)
+   */
+  _editable?: string;
+  [key: string]: string | number | boolean | Array<string | AssetField | StoryContent> | AssetField | MultilinkField | TableField | RichtextField | PluginField | string | undefined;
 };
-type StoryVersion = StoryVersion2;
 /**
- * Comparison between two story versions
+ * Multilink field type - link to internal stories, external URLs, emails, etc.
  */
-type StoryVersionComparison = {
+type MultilinkField = {
   /**
-   * Source version ID
+   * Identifies this as a multilink field
    */
-  from_version?: number;
+  fieldtype: 'multilink';
   /**
-   * Target version ID
+   * UUID of the linked story (for internal links)
    */
-  to_version?: number;
+  id: string;
   /**
-   * Changes between versions
+   * URL for external links or email addresses
    */
-  changes?: {
-    /**
-     * Added fields
-     */
-    added?: Array<string>;
+  url: string;
+  /**
+   * Type of link
+   */
+  linktype: 'story' | 'url' | 'email' | 'asset';
+  /**
+   * Cached URL path for the linked story
+   */
+  cached_url: string;
+  /**
+   * Anchor/fragment identifier for the link
+   */
+  anchor?: string | null;
+  /**
+   * Link target attribute
+   */
+  target?: '_self' | '_blank' | null;
+};
+/**
+ * Table field type - structured table data
+ */
+type TableField = {
+  /**
+   * Table header cells
+   */
+  thead: Array<{
+    _uid: string;
+    component: '_table_head';
     /**
-     * Removed fields
+     * Header cell content
      */
-    removed?: Array<string>;
+    value?: string;
+  }>;
+  /**
+   * Table body rows
+   */
+  tbody: Array<{
+    _uid: string;
+    component: '_table_row';
     /**
-     * Modified fields
+     * Cells in this row
      */
-    modified?: Array<string>;
+    body?: Array<{
+      _uid: string;
+      component: '_table_col';
+      /**
+       * Cell content
+       */
+      value?: string;
+    }>;
+  }>;
+};
+/**
+ * Richtext field type - structured rich text document (ProseMirror format)
+ */
+type RichtextField = {
+  /**
+   * Root node type for richtext documents
+   */
+  type: 'doc';
+  /**
+   * Array of richtext nodes (paragraphs, headings, lists, bloks, etc.)
+   */
+  content?: Array<{
+    [key: string]: unknown;
+  }>;
+};
+/**
+ * Plugin/Custom field type - field plugin with custom structure
+ */
+type PluginField = {
+  /**
+   * Technical name of the field plugin
+   */
+  plugin: string;
+  /**
+   * Unique identifier for this plugin field instance
+   */
+  _uid?: string;
+  [key: string]: unknown | string | undefined;
+};
+/**
+ * Translated slug object (from Translatable Slugs app)
+ */
+type StoryTranslatedSlug = {
+  /**
+   * Translated slug path
+   */
+  path: string | null;
+  /**
+   * Language code of the current language
+   */
+  lang: string;
+  /**
+   * The complete name provided for the story
+   */
+  name?: string | null;
+  /**
+   * true if a story is currently published, even if it has unpublished changes
+   */
+  published?: boolean | null;
+};
+/**
+ * Localized path object (from Translatable Slugs app)
+ */
+type StoryLocalizedPath = {
+  /**
+   * Value of the real path defined in the story's entry configuration
+   */
+  path: string;
+  /**
+   * The complete name provided for the story
+   */
+  name?: string | null;
+  /**
+   * Language code of the current language
+   */
+  lang: string;
+  /**
+   * true if a story is currently published, even if it has unpublished changes
+   */
+  published?: boolean | null;
+};
+/**
+ * Common Storyblok story fields shared by Content Delivery and Management APIs
+ */
+type StoryBase = {
+  /**
+   * Numeric id of the story
+   */
+  readonly id: number;
+  /**
+   * The complete name provided for the story
+   */
+  name: string;
+  /**
+   * ID of the parent folder. 0 for root-level stories.
+   */
+  parent_id: number;
+  /**
+   * Group ID (UUID string), shared between stories defined as alternates
+   */
+  group_id: string;
+  /**
+   * An array containing objects that provide basic data of the stories defined as alternates of the current story
+   */
+  alternates: Array<StoryAlternate>;
+  /**
+   * Creation date yyyy-MM-dd'T'HH:mm:ssZ
+   */
+  created_at: string;
+  /**
+   * Date defined in the story's entry configuration YYYY-mm-dd
+   */
+  sort_by_date: string | null;
+  /**
+   * Array of tag names
+   */
+  tag_list: Array<string>;
+  /**
+   * Latest update date yyyy-MM-dd'T'HH:mm:ssZ
+   */
+  updated_at: string;
+  /**
+   * Latest publishing date yyyy-MM-dd'T'HH:mm:ssZ
+   */
+  published_at: string | null;
+  /**
+   * Generated UUID string
+   */
+  readonly uuid: string;
+  content: StoryContent;
+  /**
+   * The slug specific for the story
+   */
+  slug: string;
+  /**
+   * Value of the real path defined in the story's entry configuration (usually required for the Visual Editor)
+   */
+  path: string | null;
+  /**
+   * The full slug of the story, combining the parent folder(s) and the designated story slug
+   */
+  full_slug: string;
+  /**
+   * true if the story is defined as root for the folder
+   */
+  is_startpage: boolean;
+  /**
+   * Object to store non-editable data that is exclusively maintained with the Management API
+   */
+  meta_data: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * First publishing date yyyy-MM-dd'T'HH:mm:ssZ
+   */
+  first_published_at: string | null;
+  /**
+   * Array of translated slug objects (if the app Translatable Slugs is installed)
+   */
+  translated_slugs: Array<StoryTranslatedSlug> | null;
+  /**
+   * An array of translated path objects
+   */
+  localized_paths?: Array<StoryLocalizedPath>;
+  /**
+   * Numeric representation of the story's position in the folder
+   */
+  position: number;
+};
+/**
+ * Storyblok story object from the Management API.
+ */
+type StoryMapi = StoryBase & {
+  /**
+   * Deletion date and time.
+   */
+  deleted_at?: string | null;
+  /**
+   * Whether the entry is a folder.
+   */
+  is_folder?: boolean;
+  /**
+   * Whether the story is currently published.
+   */
+  published?: boolean;
+  /**
+   * Default content type for stories in this folder.
+   */
+  default_root?: string | null;
+  /**
+   * Whether the Visual Editor is disabled.
+   */
+  disable_fe_editor?: boolean;
+  /**
+   * Subset of parent folder info (resolved from parent_id).
+   */
+  parent?: {
+    [key: string]: unknown;
+  };
+  /**
+   * Whether the story has unpublished changes.
+   */
+  unpublished_changes?: boolean;
+  /**
+   * Latest import date.
+   */
+  imported_at?: string | null;
+  preview_token?: {
+    token?: string;
+    timestamp?: string;
+  };
+  /**
+   * Legacy UI feature replaced by favourite_for_user_ids.
+   */
+  pinned?: boolean;
+  breadcrumbs?: Array<{
+    id?: number;
+    name?: string;
+    parent_id?: number;
+    disable_fe_editor?: boolean;
+    path?: string;
+    slug?: string;
+    translated_slugs?: Array<StoryTranslatedSlug>;
+  }>;
+  last_author?: {
+    id?: number;
+    userid?: string;
+    friendly_name?: string;
+  };
+  /**
+   * ID of the last user who interacted with the story.
+   */
+  last_author_id?: number;
+  translated_slugs_attributes?: Array<{
+    id?: number;
+    lang?: string;
+    slug?: string;
+    name?: string;
+    published?: boolean;
+  }>;
+  /**
+   * ID of the current release.
+   */
+  release_id?: number;
+  /**
+   * Scheduled publishing date.
+   */
+  scheduled_dates?: string;
+  /**
+   * User IDs who saved the story as Favorite.
+   */
+  favourite_for_user_ids?: Array<number>;
+  /**
+   * User IDs assigned to a workflow stage.
+   */
+  user_ids?: Array<number>;
+  /**
+   * Space role IDs assigned to a workflow stage.
+   */
+  space_role_ids?: Array<number>;
+  /**
+   * Release IDs associated with the story.
+   */
+  release_ids?: Array<number>;
+  /**
+   * Version ID of the story's latest content within the release.
+   */
+  current_version_id?: number;
+  /**
+   * Version ID of the story's content when first added to a release.
+   */
+  base_version_id?: number;
+  /**
+   * Version ID of the story's current content outside the release.
+   */
+  main_version_id?: number;
+  /**
+   * Current workflow stage details.
+   */
+  stage?: {
+    workflow_id?: number;
+    workflow_stage_id?: number;
+    story_id?: number;
+    due_date?: string;
+    created_at?: string;
   };
 };
-type UnpublishedStory = Story2;
-type ComponentContent = Blok;
 /**
- * Generic component content structure that can be extended for specific component types. Supports deeply nested components in arrays and objects. Additional fields can be strings, numbers, booleans, objects, or arrays.
+ * Input for creating a story.
  */
-type Blok = {
+type StoryCreate2 = {
   /**
-   * Unique identifier for the content
+   * The numeric ID of the story. Can be passed in the body per the MAPI docs.
    */
-  _uid: string;
+  id?: number;
   /**
-   * The story type's technical name (e.g., 'page', 'teaser', 'grid', 'feature', etc.)
+   * The complete name provided for the story.
    */
-  component: string;
+  name: string;
   /**
-   * Storyblok editor markup for inline editing
+   * The slug specific for the story. Auto-generated as a UUID when omitted.
    */
-  _editable?: string;
-  [key: string]: (string | number | boolean | Array<Blok>) | string | undefined;
+  slug?: string;
+  content?: StoryContent;
+  /**
+   * ID of the parent folder.
+   */
+  parent_id?: number;
+  /**
+   * Value of the real path defined in the story's entry configuration (usually required for the Visual Editor).
+   */
+  path?: string | null;
+  /**
+   * true if the story is defined as root for the folder.
+   */
+  is_startpage?: boolean;
+  /**
+   * Array of tag names.
+   */
+  tag_list?: Array<string>;
+  /**
+   * Date defined in the story's entry configuration YYYY-mm-dd.
+   */
+  sort_by_date?: string | null;
+  /**
+   * Numeric representation of the story's position in the folder.
+   */
+  position?: number;
+  /**
+   * Object to store non-editable data that is exclusively maintained with the Management API.
+   */
+  meta_data?: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * Whether the entry is a folder.
+   */
+  is_folder?: boolean;
+  /**
+   * Default content type for stories in this folder.
+   */
+  default_root?: string | null;
+  /**
+   * Whether the Visual Editor is disabled.
+   */
+  disable_fe_editor?: boolean;
+  /**
+   * Translated slug entries to create, update, or delete.
+   */
+  translated_slugs_attributes?: Array<{
+    id?: number;
+    lang?: string;
+    slug?: string;
+    name?: string;
+    published?: boolean;
+  }>;
+};
+type StoryCreateRequest2 = {
+  story: StoryCreate2;
+  /**
+   * Should the story be published immediately (set 1 to publish)
+   */
+  publish?: number;
+  /**
+   * ID of the current release (can be requested with the from_release API parameter)
+   */
+  release_id?: number;
+};
+/**
+ * Input for updating a story.
+ */
+type StoryUpdate2 = {
+  /**
+   * The numeric ID of the story. Can be passed in the update body per the MAPI docs.
+   */
+  id?: number;
+  /**
+   * The complete name provided for the story.
+   */
+  name?: string;
+  /**
+   * The slug specific for the story.
+   */
+  slug?: string;
+  content?: StoryContent;
+  /**
+   * ID of the parent folder.
+   */
+  parent_id?: number;
+  /**
+   * Value of the real path defined in the story's entry configuration (usually required for the Visual Editor).
+   */
+  path?: string | null;
+  /**
+   * true if the story is defined as root for the folder.
+   */
+  is_startpage?: boolean;
+  /**
+   * Array of tag names.
+   */
+  tag_list?: Array<string>;
+  /**
+   * Date defined in the story's entry configuration YYYY-mm-dd.
+   */
+  sort_by_date?: string | null;
+  /**
+   * Numeric representation of the story's position in the folder.
+   */
+  position?: number;
+  /**
+   * Object to store non-editable data that is exclusively maintained with the Management API.
+   */
+  meta_data?: {
+    [key: string]: unknown;
+  } | null;
+  /**
+   * Whether the entry is a folder.
+   */
+  is_folder?: boolean;
+  /**
+   * Default content type for stories in this folder.
+   */
+  default_root?: string | null;
+  /**
+   * Whether the Visual Editor is disabled.
+   */
+  disable_fe_editor?: boolean;
+  /**
+   * Translated slug entries to create, update, or delete.
+   */
+  translated_slugs_attributes?: Array<{
+    id?: number;
+    lang?: string;
+    slug?: string;
+    name?: string;
+    published?: boolean;
+  }>;
+};
+type StoryUpdateRequest2 = {
+  story: StoryUpdate2;
+  /**
+   * Group ID (UUID string), shared between stories defined as alternates
+   */
+  group_id?: string;
+  /**
+   * If this is 1, the request can overwrite a locked story. Note that a user currently editing the story (which is why it was locked) will encounter a content conflict model. Importantly, note that force_update does not work when editing is locked for the workflow stage that the story currently is in
+   */
+  force_update?: '0' | '1';
+  /**
+   * Numeric ID of release (optional)
+   */
+  release_id?: number;
+  /**
+   * Should the story be published immediately (set 1 to publish)
+   */
+  publish?: number;
+  /**
+   * Language code to publish the story individually (must be enabled in the space settings)
+   */
+  lang?: string;
+};
+/**
+ * Request body for duplicating a story
+ */
+type StoryDuplicateRequestWritable = {
+  story?: StoryMapiWritable;
+  /**
+   * The id of the target folder
+   */
+  target_dimension?: number;
+  /**
+   * If set to true, the current story's path attribute will used for the duplicated story
+   */
+  same_path?: boolean;
 };
 /**
- * A Storyblok story object representing a content entry
+ * Common Storyblok story fields shared by Content Delivery and Management APIs
  */
-type Story2 = {
-  /**
-   * Numeric id of the story
-   */
-  readonly id: number;
+type StoryBaseWritable = {
   /**
    * The complete name provided for the story
    */
-  name?: string;
+  name: string;
   /**
-   * ID of the parent folder
+   * ID of the parent folder. 0 for root-level stories.
    */
-  parent_id?: number | null;
+  parent_id: number;
   /**
    * Group ID (UUID string), shared between stories defined as alternates
    */
-  group_id?: string;
+  group_id: string;
   /**
    * An array containing objects that provide basic data of the stories defined as alternates of the current story
    */
-  alternates?: Array<{
-    /**
-     * The numeric ID
-     */
-    id?: number;
-    /**
-     * The complete name provided for the story
-     */
-    name?: string;
-    /**
-     * The slug specific for the story
-     */
-    slug?: string;
-    /**
-     * true if a story is currently published, even if it has unpublished changes
-     */
-    published?: boolean;
-    /**
-     * The full slug of the story, combining the parent folder(s) and the designated story slug
-     */
-    full_slug?: string;
-    /**
-     * true if the instance constitutes a folder
-     */
-    is_folder?: boolean;
-  }>;
+  alternates: Array<StoryAlternate>;
   /**
    * Creation date yyyy-MM-dd'T'HH:mm:ssZ
    */
-  created_at?: string;
-  /**
-   * Deleted date YYYY-mm-dd HH:MM
-   */
-  deleted_at?: string | null;
+  created_at: string;
   /**
    * Date defined in the story's entry configuration YYYY-mm-dd
    */
-  sort_by_date?: string | null;
+  sort_by_date: string | null;
   /**
    * Array of tag names
    */
-  tag_list?: Array<string>;
+  tag_list: Array<string>;
   /**
    * Latest update date yyyy-MM-dd'T'HH:mm:ssZ
    */
-  updated_at?: string;
+  updated_at: string;
   /**
    * Latest publishing date yyyy-MM-dd'T'HH:mm:ssZ
    */
-  published_at?: string;
+  published_at: string | null;
+  content: StoryContent;
   /**
-   * Generated UUID string
+   * The slug specific for the story
    */
-  readonly uuid?: string;
+  slug: string;
   /**
-   * true if the instance constitutes a folder
+   * Value of the real path defined in the story's entry configuration (usually required for the Visual Editor)
    */
-  is_folder?: boolean;
+  path: string | null;
   /**
-   * An object containing the field data associated with the specific story type's specific content structure. Can contain deeply nested components in arrays and objects. Also includes a component property with the story type's technical name.
+   * The full slug of the story, combining the parent folder(s) and the designated story slug
    */
-  content?: Blok;
+  full_slug: string;
   /**
-   * true if a story is currently published, even if it has unpublished changes
+   * true if the story is defined as root for the folder
    */
-  published?: boolean;
+  is_startpage: boolean;
   /**
-   * The slug specific for the story
+   * Object to store non-editable data that is exclusively maintained with the Management API
    */
-  slug?: string;
+  meta_data: {
+    [key: string]: unknown;
+  } | null;
   /**
-   * Value of the real path defined in the story's entry configuration (usually, this value is only required for Storyblok's Visual Editor)
+   * First publishing date yyyy-MM-dd'T'HH:mm:ssZ
    */
-  path?: string | null;
+  first_published_at: string | null;
   /**
-   * The full slug of the story, combining the parent folder(s) and the designated story slug
+   * Array of translated slug objects (if the app Translatable Slugs is installed)
    */
-  full_slug?: string;
+  translated_slugs: Array<StoryTranslatedSlug> | null;
   /**
-   * Component name which will be used as default content type for this folders entries
+   * An array of translated path objects
    */
-  default_root?: string | null;
+  localized_paths?: Array<StoryLocalizedPath>;
   /**
-   * Is side by side editor disabled for all entries in folder
+   * Numeric representation of the story's position in the folder
    */
-  disable_fe_editor?: boolean;
+  position: number;
+};
+/**
+ * Storyblok story object from the Management API.
+ */
+type StoryMapiWritable = StoryBaseWritable & {
   /**
-   * Essential parent information as object (resolved from parent_id)
+   * Deletion date and time.
    */
-  parent?: {
-    [key: string]: unknown;
-  };
+  deleted_at?: string | null;
   /**
-   * true if the story is defined as root for the folder
+   * Whether the entry is a folder.
    */
-  is_startpage?: boolean;
+  is_folder?: boolean;
   /**
-   * Story has unpublished changes; saved but not published
+   * Whether the story is currently published.
    */
-  unpublished_changes?: boolean;
+  published?: boolean;
   /**
-   * Object to store non-editable data that is exclusively maintained with the Management API
+   * Default content type for stories in this folder.
    */
-  meta_data?: {
+  default_root?: string | null;
+  /**
+   * Whether the Visual Editor is disabled.
+   */
+  disable_fe_editor?: boolean;
+  /**
+   * Subset of parent folder info (resolved from parent_id).
+   */
+  parent?: {
     [key: string]: unknown;
-  } | null;
+  };
   /**
-   * Latest import date YYYY-mm-dd HH:MM
+   * Whether the story has unpublished changes.
    */
-  imported_at?: string | null;
+  unpublished_changes?: boolean;
   /**
-   * Preview token
+   * Latest import date.
    */
+  imported_at?: string | null;
   preview_token?: {
-    /**
-     * The token passed to the editor as preview parameter to allow edit mode verification
-     */
     token?: string;
-    /**
-     * Timestamp passed to the editor as preview parameter to allow edit mode verification
-     */
     timestamp?: string;
   };
   /**
-   * To pin the story in the toolbar
+   * Legacy UI feature replaced by favourite_for_user_ids.
    */
   pinned?: boolean;
-  /**
-   * Array of resolved subset of link objects (one per path segment / parent)
-   */
   breadcrumbs?: Array<{
-    /**
-     * Story ID
-     */
     id?: number;
-    /**
-     * The complete name provided for the story
-     */
     name?: string;
-    /**
-     * ID of the parent folder
-     */
-    parent_id?: number | null;
-    /**
-     * Is side by side editor disabled for all entries in folder
-     */
+    parent_id?: number;
     disable_fe_editor?: boolean;
-    /**
-     * Value of the real path defined in the story's entry configuration
-     */
     path?: string;
-    /**
-     * The slug specific for the story
-     */
     slug?: string;
-    /**
-     * Array of translated slug objects (if the app Translatable Slugs is installed)
-     */
-    translated_slugs?: Array<{
-      /**
-       * ID of the story
-       */
-      story_id?: number;
-      /**
-       * Language code of the current language
-       */
-      lang?: string;
-      /**
-       * The slug specific for the story
-       */
-      slug?: string;
-      /**
-       * The complete name provided for the story
-       */
-      name?: string;
-      /**
-       * true if a story is currently published, even if it has unpublished changes
-       */
-      published?: boolean;
-    }>;
+    translated_slugs?: Array<StoryTranslatedSlug>;
   }>;
-  /**
-   * First publishing date yyyy-MM-dd'T'HH:mm:ssZ
-   */
-  first_published_at?: string;
-  /**
-   * Last author
-   */
   last_author?: {
-    /**
-     * Last author user object numeric id
-     */
     id?: number;
-    /**
-     * Last author userid/username
-     */
     userid?: string;
-    /**
-     * Friendly name of last author
-     */
     friendly_name?: string;
   };
   /**
-   * Id of the last Author
+   * ID of the last user who interacted with the story.
    */
   last_author_id?: number;
-  /**
-   * Array of translated slug objects (if the app Translatable Slugs is installed)
-   */
-  translated_slugs?: Array<{
-    /**
-     * ID of the story
-     */
-    story_id?: number;
-    /**
-     * Language code of the current language
-     */
-    lang?: string;
-    /**
-     * The slug specific for the story
-     */
-    slug?: string;
-    /**
-     * The complete name provided for the story
-     */
-    name?: string;
-    /**
-     * true if a story is currently published, even if it has unpublished changes
-     */
-    published?: boolean;
-  }>;
-  /**
-   * Array of translated slug attributes objects (if the app Translatable Slugs is installed) to change translated slugs when creating or updating a story
-   */
   translated_slugs_attributes?: Array<{
-    /**
-     * The numeric ID
-     */
     id?: number;
-    /**
-     * Language code of the current language
-     */
     lang?: string;
-    /**
-     * The slug specific for the story
-     */
     slug?: string;
-    /**
-     * The complete name provided for the story
-     */
-    name?: string;
-    /**
-     * true if a story is currently published, even if it has unpublished changes
-     */
-    published?: boolean;
-  }>;
-  /**
-   * An array of translated path objects
-   */
-  localized_paths?: Array<{
-    /**
-     * Value of the real path defined in the story's entry configuration
-     */
-    path?: string;
-    /**
-     * The complete name provided for the story
-     */
     name?: string;
-    /**
-     * Language code of the current language
-     */
-    lang?: string;
-    /**
-     * true if a story is currently published, even if it has unpublished changes
-     */
     published?: boolean;
   }>;
   /**
-   * Numeric representation of the story's position in the folder
-   */
-  position?: number;
-  /**
-   * ID of the current release (can be requested with the from_release API parameter)
+   * ID of the current release.
    */
   release_id?: number;
   /**
-   * Scheduled publishing date YYYY-mm-dd HH:MM
+   * Scheduled publishing date.
    */
   scheduled_dates?: string;
   /**
-   * Array of user IDs who have added the story in their favorites
+   * User IDs who saved the story as Favorite.
    */
   favourite_for_user_ids?: Array<number>;
-};
-type StoryCreateRequest2 = {
-  story: Story2 & {
-    [key: string]: unknown;
-  };
-  /**
-   * Should the story be published immediately (set 1 to publish)
-   */
-  publish?: number;
-  /**
-   * ID of the current release (can be requested with the from_release API parameter)
-   */
-  release_id?: number;
-};
-type StoryUpdateRequest2 = {
-  story: Story2 & {
-    [key: string]: unknown;
-  };
-  /**
-   * Group ID (UUID string), shared between stories defined as alternates
-   */
-  group_id?: string;
-  /**
-   * If this is 1, the request can overwrite a locked story. Note that a user currently editing the story (which is why it was locked) will encounter a content conflict model. Importantly, note that force_update does not work when editing is locked for the workflow stage that the story currently is in
-   */
-  force_update?: '0' | '1';
   /**
-   * Numeric ID of release (optional)
+   * User IDs assigned to a workflow stage.
    */
-  release_id?: number;
+  user_ids?: Array<number>;
   /**
-   * Should the story be published immediately (set 1 to publish)
+   * Space role IDs assigned to a workflow stage.
    */
-  publish?: number;
+  space_role_ids?: Array<number>;
   /**
-   * Language code to publish the story individually (must be enabled in the space settings)
+   * Release IDs associated with the story.
    */
-  lang?: string;
-};
-/**
- * A story version object
- */
-type StoryVersion2 = {
+  release_ids?: Array<number>;
   /**
-   * Version ID
+   * Version ID of the story's latest content within the release.
    */
-  id?: number;
+  current_version_id?: number;
   /**
-   * Version name
+   * Version ID of the story's content when first added to a release.
    */
-  name?: string;
+  base_version_id?: number;
   /**
-   * Version creation date
+   * Version ID of the story's current content outside the release.
    */
-  created_at?: string;
+  main_version_id?: number;
   /**
-   * User who created the version
+   * Current workflow stage details.
    */
-  created_by?: {
-    /**
-     * User ID
-     */
-    id?: number;
-    /**
-     * User name
-     */
-    name?: string;
+  stage?: {
+    workflow_id?: number;
+    workflow_stage_id?: number;
+    story_id?: number;
+    due_date?: string;
+    created_at?: string;
   };
-  story?: Story2;
 };
-/**
- * The ID of the Storyblok space (can be integer or string)
- */
-type SpaceId = number | string;
-/**
- * Page number for pagination. Default is 1.
- */
-type Page = number;
-/**
- * Number of items per page. Default is 25.
- */
-type PerPage = number;
-/**
- * The ID of the story (can be integer or string)
- */
-type StoryId = number | string;
 type ListData = {
   body?: never;
   path: {
@@ -629,29 +989,14 @@ type ListData = {
   };
   url: '/v1/spaces/{space_id}/stories';
 };
-type ListErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Space not found
-   */
-  404: unknown;
-};
 type ListResponses = {
   /**
    * List of stories
    */
   200: {
-    stories?: Array<Story2>;
+    stories?: Array<StoryMapi>;
   };
 };
-type ListResponse = ListResponses[keyof ListResponses];
 type CreateData = {
   body: StoryCreateRequest2;
   path: {
@@ -686,69 +1031,24 @@ type CreateData = {
      */
     disable_fe_editor?: boolean;
   };
-  url: '/v1/spaces/{space_id}/stories';
-};
-type CreateErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Space not found
-   */
-  404: unknown;
-};
-type CreateResponses = {
-  /**
-   * Story created
-   */
-  201: {
-    story?: Story2;
-  };
-};
-type CreateResponse = CreateResponses[keyof CreateResponses];
-type DeleteData = {
-  body?: never;
-  path: {
-    /**
-     * The ID of the Storyblok space (can be integer or string)
-     */
-    space_id: number | string;
-    /**
-     * The ID of the story (can be integer or string)
-     */
-    story_id: number | string;
-  };
-  query?: never;
-  url: '/v1/spaces/{space_id}/stories/{story_id}';
+  url: '/v1/spaces/{space_id}/stories';
 };
-type DeleteErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
+type CreateResponses = {
   /**
-   * Story not found
+   * Story created
    */
-  404: unknown;
+  201: {
+    story?: StoryMapi;
+  };
 };
 type DeleteResponses = {
   /**
    * Story deleted
    */
   200: {
-    story?: Story2;
+    story?: StoryMapi;
   };
 };
-type DeleteResponse = DeleteResponses[keyof DeleteResponses];
 type GetData = {
   body?: never;
   path: {
@@ -773,30 +1073,15 @@ type GetData = {
   };
   url: '/v1/spaces/{space_id}/stories/{story_id}';
 };
-type GetErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Story not found
-   */
-  404: unknown;
-};
 type GetResponses = {
   /**
    * Story details
    */
   200: {
-    story?: Story2;
+    story?: StoryMapi;
   };
 };
-type GetResponse = GetResponses[keyof GetResponses];
-type UpdateStoryData = {
+type UpdateData = {
   body: StoryUpdateRequest2;
   path: {
     /**
@@ -828,31 +1113,16 @@ type UpdateStoryData = {
   };
   url: '/v1/spaces/{space_id}/stories/{story_id}';
 };
-type UpdateStoryErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Story not found
-   */
-  404: unknown;
-};
-type UpdateStoryResponses = {
+type UpdateResponses = {
   /**
    * Story updated
    */
   200: {
-    story?: Story2;
+    story?: StoryMapi;
   };
 };
-type UpdateStoryResponse = UpdateStoryResponses[keyof UpdateStoryResponses];
 type DuplicateData = {
-  body: StoryDuplicateRequest;
+  body: StoryDuplicateRequestWritable;
   path: {
     /**
      * The ID of the Storyblok space (can be integer or string)
@@ -879,29 +1149,14 @@ type DuplicateData = {
   };
   url: '/v1/spaces/{space_id}/stories/{story_id}/duplicate';
 };
-type DuplicateErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Story not found
-   */
-  404: unknown;
-};
 type DuplicateResponses = {
   /**
    * Story duplicated
    */
   200: {
-    story?: Story2;
+    story?: StoryMapi;
   };
 };
-type DuplicateResponse = DuplicateResponses[keyof DuplicateResponses];
 type PublishData = {
   body?: never;
   path: {
@@ -926,234 +1181,14 @@ type PublishData = {
   };
   url: '/v1/spaces/{space_id}/stories/{story_id}/publish';
 };
-type PublishErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Story not found
-   */
-  404: unknown;
-};
 type PublishResponses = {
   /**
    * Story published
    */
   200: {
-    story?: Story2;
-  };
-};
-type PublishResponse = PublishResponses[keyof PublishResponses];
-type UnpublishData = {
-  body?: never;
-  path: {
-    /**
-     * The ID of the Storyblok space (can be integer or string)
-     */
-    space_id: number | string;
-    /**
-     * The ID of the story (can be integer or string)
-     */
-    story_id: number | string;
-  };
-  query?: {
-    /**
-     * Accept a list of languages codes separated by a comma
-     */
-    lang?: string;
-    /**
-     * Release ID for scheduled unpublishing
-     */
-    release_id?: number;
-  };
-  url: '/v1/spaces/{space_id}/stories/{story_id}/unpublish';
-};
-type UnpublishErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Story not found
-   */
-  404: unknown;
-};
-type UnpublishResponses = {
-  /**
-   * Story unpublished
-   */
-  200: {
-    story?: Story2;
-  };
-};
-type UnpublishResponse = UnpublishResponses[keyof UnpublishResponses];
-type ExportData = {
-  body?: never;
-  path: {
-    /**
-     * The ID of the Storyblok space (can be integer or string)
-     */
-    space_id: number | string;
-    /**
-     * The ID of the story (can be integer or string)
-     */
-    story_id: number | string;
-  };
-  query?: {
-    version?: '1' | '2';
-    /**
-     * The language code for which the export should happen
-     */
-    lang_code?: string;
-    /**
-     * If the values of the lang_code should be exported or not
-     */
-    export_lang?: boolean;
-  };
-  url: '/v1/spaces/{space_id}/stories/{story_id}/export.json';
-};
-type ExportErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Story not found
-   */
-  404: unknown;
-};
-type ExportResponses = {
-  /**
-   * Export data with field keys and values
-   */
-  200: {
-    [key: string]: unknown;
-  };
-};
-type ExportResponse = ExportResponses[keyof ExportResponses];
-type ImportData = {
-  body: {
-    story: Story2 & {
-      [key: string]: unknown;
-    };
-  };
-  path: {
-    /**
-     * The ID of the Storyblok space (can be integer or string)
-     */
-    space_id: number | string;
-    /**
-     * The ID of the story (can be integer or string)
-     */
-    story_id: number | string;
-  };
-  query?: {
-    version?: '1' | '2';
-    /**
-     * A language code
-     */
-    lang_code?: string;
-    /**
-     * It shows to import language code or not
-     */
-    import_lang?: boolean;
-  };
-  url: '/v1/spaces/{space_id}/stories/{story_id}/import.json';
-};
-type ImportErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Story not found
-   */
-  404: unknown;
-};
-type ImportResponses = {
-  /**
-   * Story imported
-   */
-  200: {
-    story?: Story2;
-  };
-};
-type ImportResponse = ImportResponses[keyof ImportResponses];
-type TranslateData = {
-  body: {
-    /**
-     * The official language code (e.g., en, de, fr) used for localization
-     */
-    lang: string;
-    /**
-     * The custom language identifier defined in the Space Settings under Internationalization
-     */
-    code: string;
-    /**
-     * Indicates whether the current value should replace the existing value for the specified language
-     */
-    overwrite?: boolean;
-    /**
-     * Release ID of the story
-     */
-    release_id?: number;
-  };
-  path: {
-    /**
-     * The ID of the Storyblok space (can be integer or string)
-     */
-    space_id: number | string;
-    /**
-     * The ID of the story (can be integer or string)
-     */
-    story_id: number | string;
-  };
-  query?: never;
-  url: '/v1/spaces/{space_id}/stories/{story_id}/ai_translate';
-};
-type TranslateErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Story not found
-   */
-  404: unknown;
-};
-type TranslateResponses = {
-  /**
-   * Story translated
-   */
-  200: {
-    /**
-     * A single story object, containing the translated fields in its content property
-     */
-    story?: Story2;
+    story?: StoryMapi;
   };
 };
-type TranslateResponse = TranslateResponses[keyof TranslateResponses];
 type VersionsData = {
   body?: never;
   path: {
@@ -1187,20 +1222,6 @@ type VersionsData = {
   };
   url: '/v1/spaces/{space_id}/story_versions';
 };
-type VersionsErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Story not found
-   */
-  404: unknown;
-};
 type VersionsResponses = {
   /**
    * Story versions
@@ -1268,9 +1289,9 @@ type VersionsResponses = {
        */
       release_id?: number;
       /**
-       * ID of the parent folder
+       * ID of the parent folder. 0 for root-level stories.
        */
-      parent_id?: number | null;
+      parent_id?: number;
       /**
        * This object contains the Story's content when the show_content parameter is used
        */
@@ -1280,145 +1301,6 @@ type VersionsResponses = {
     }>;
   };
 };
-type VersionsResponse = VersionsResponses[keyof VersionsResponses];
-type RestoreVersionsData = {
-  body?: never;
-  path: {
-    /**
-     * The ID of the Storyblok space (can be integer or string)
-     */
-    space_id: number | string;
-    /**
-     * The ID of the story (can be integer or string)
-     */
-    story_id: number | string;
-  };
-  query: {
-    /**
-     * When set to true, the version passed is treated as a new story version, while setting it to false treats it as a legacy version. Read the note on the get story versions endpoint to learn how to differentiate between new and legacy versions
-     */
-    versions_v2: boolean;
-    /**
-     * The ID of the story version
-     */
-    version: string;
-    /**
-     * Release ID for version restoration
-     */
-    release_id?: number;
-  };
-  url: '/v1/spaces/{space_id}/stories/{story_id}/restore_with';
-};
-type RestoreVersionsErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Story or version not found
-   */
-  404: unknown;
-};
-type RestoreVersionsResponses = {
-  /**
-   * Story version restored
-   */
-  200: {
-    story?: Story2;
-  };
-};
-type RestoreVersionsResponse = RestoreVersionsResponses[keyof RestoreVersionsResponses];
-type CompareVersionsData = {
-  body?: never;
-  path: {
-    /**
-     * The ID of the Storyblok space (can be integer or string)
-     */
-    space_id: number | string;
-    /**
-     * The ID of the story (can be integer or string)
-     */
-    story_id: number | string;
-  };
-  query: {
-    /**
-     * Story version id
-     */
-    version: number;
-  };
-  url: '/v1/spaces/{space_id}/stories/{story_id}/compare';
-};
-type CompareVersionsErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Story not found
-   */
-  404: unknown;
-};
-type CompareVersionsResponses = {
-  /**
-   * Version comparison
-   */
-  200: StoryVersionComparison;
-};
-type CompareVersionsResponse = CompareVersionsResponses[keyof CompareVersionsResponses];
-type GetUnpublishedDependenciesData = {
-  body: {
-    /**
-     * List of story IDs
-     */
-    story_ids: Array<number>;
-    /**
-     * ID of a release. If this is passed, the endpoint looks for unpublished dependencies in this specific release.
-     */
-    release_id?: number;
-  };
-  path: {
-    /**
-     * The ID of the Storyblok space (can be integer or string)
-     */
-    space_id: number | string;
-  };
-  query?: never;
-  url: '/v1/spaces/{space_id}/stories/unpublished_dependencies';
-};
-type GetUnpublishedDependenciesErrors = {
-  /**
-   * Bad request
-   */
-  400: unknown;
-  /**
-   * Unauthorized
-   */
-  401: unknown;
-  /**
-   * Space not found
-   */
-  404: unknown;
-};
-type GetUnpublishedDependenciesResponses = {
-  /**
-   * Unpublished dependencies
-   */
-  200: {
-    unpublished_stories?: Array<Story2>;
-  };
-};
-type GetUnpublishedDependenciesResponse = GetUnpublishedDependenciesResponses[keyof GetUnpublishedDependenciesResponses];
-type ClientOptions = {
-  baseUrl: 'https://mapi.storyblok.com' | 'https://api-us.storyblok.com' | 'https://api-ca.storyblok.com' | 'https://api-ap.storyblok.com' | 'https://app.storyblokchina.cn' | (string & {});
-};
 //#endregion
-export { Blok, ClientOptions, CompareVersionsData, CompareVersionsErrors, CompareVersionsResponse, CompareVersionsResponses, ComponentContent, CreateData, CreateErrors, CreateResponse, CreateResponses, DeleteData, DeleteErrors, DeleteResponse, DeleteResponses, DuplicateData, DuplicateErrors, DuplicateResponse, DuplicateResponses, ExportData, ExportErrors, ExportResponse, ExportResponses, GetData, GetErrors, GetResponse, GetResponses, GetUnpublishedDependenciesData, GetUnpublishedDependenciesErrors, GetUnpublishedDependenciesResponse, GetUnpublishedDependenciesResponses, ImportData, ImportErrors, ImportResponse, ImportResponses, ListData, ListErrors, ListResponse, ListResponses, Page, PerPage, PublishData, PublishErrors, PublishResponse, PublishResponses, RestoreVersionsData, RestoreVersionsErrors, RestoreVersionsResponse, RestoreVersionsResponses, SpaceId, Story, Story2, StoryCreateRequest, StoryCreateRequest2, StoryDuplicateRequest, StoryId, StoryUpdateRequest, StoryUpdateRequest2, StoryVersion, StoryVersion2, StoryVersionComparison, TranslateData, TranslateErrors, TranslateResponse, TranslateResponses, UnpublishData, UnpublishErrors, UnpublishResponse, UnpublishResponses, UnpublishedStory, UpdateStoryData, UpdateStoryErrors, UpdateStoryResponse, UpdateStoryResponses, VersionsData, VersionsErrors, VersionsResponse, VersionsResponses, types_gen_d_exports };
+export { AssetField, CreateData, CreateResponses, DeleteResponses, DuplicateData, DuplicateResponses, GetData, GetResponses, ListData, ListResponses, MultilinkField, PluginField, PublishData, PublishResponses, RichtextField, StoryAlternate, StoryContent, StoryCreate, StoryLocalizedPath, StoryMapi, StoryTranslatedSlug, StoryUpdate, TableField, UpdateData, UpdateResponses, VersionsData, VersionsResponses };
 //# sourceMappingURL=types.gen.d.cts.map