@shortcut/client 1.1.0 → 2.0.0

package/lib/generated/data-contracts.d.ts

@@ -1,16 +1,42 @@
-export interface BasicWorkspaceInfo {
-    url_slug: string;
+/** Request parameters for specifying how to pre-populate a task through a template. */
+interface BaseTaskParams {
+    /**
+     * The Task description.
+     * @minLength 1
+     * @maxLength 2048
+     */
+    description: string;
+    /** True/false boolean indicating whether the Task is completed. Defaults to false. */
+    complete?: boolean;
+    /** An array of UUIDs for any members you want to add as Owners on this new Task. */
+    owner_ids?: string[];
+    /**
+     * This field can be set to another unique ID. In the case that the Task has been imported from another tool, the ID in the other tool can be indicated here.
+     * @maxLength 128
+     */
+    external_id?: string;
+}
+interface BasicWorkspaceInfo {
+    /** @format uuid */
+    id: string;
+    /** @format date-time */
+    created_at: string;
+    /** @format int64 */
+    default_workflow_id: number;
     estimate_scale: number[];
+    name: string;
+    url_slug: string;
+    utc_offset: string;
 }
 /** Branch refers to a VCS branch. Branches are feature branches associated with Shortcut Stories. */
-export interface Branch {
+interface Branch {
     /** A string description of this resource. */
     entity_type: string;
     /** A true/false boolean indicating if the Branch has been deleted. */
     deleted: boolean;
     /** The name of the Branch. */
     name: string;
-    /** A true/false boolean indicating if the Branch is persistent; e.g. master. */
+    /** This field is deprecated, and will always be false. */
     persistent: boolean;
     /**
      * The time/date the Branch was updated.
@@ -39,8 +65,8 @@ export interface Branch {
      */
     created_at?: string | null;
 }
-/** A Category can be used to associate Milestones. */
-export interface Category {
+/** A Category can be used to associate Objectives. */
+interface Category {
     /** A true/false boolean indicating if the Category has been archived. */
     archived: boolean;
     /** A string description of this resource. */
@@ -56,7 +82,7 @@ export interface Category {
     name: string;
     /** The Global ID of the Category. */
     global_id: string;
-    /** The type of entity this Category is associated with; currently Milestone is the only type of Category. */
+    /** The type of entity this Category is associated with; currently Milestone or Objective is the only type of Category. */
     type: string;
     /**
      * The time/date that the Category was updated.
@@ -77,7 +103,7 @@ export interface Category {
     created_at: string;
 }
 /** Commit refers to a VCS commit and all associated details. */
-export interface Commit {
+interface Commit {
     /** A string description of this resource. */
     entity_type: string;
     /**
@@ -121,10 +147,11 @@ export interface Commit {
     /** The Commit message. */
     message: string;
 }
-export interface CreateCategory {
+interface CreateCategory {
     /**
      * The name of the new Category.
      * @minLength 1
+     * @maxLength 128
      */
     name: string;
     /**
@@ -137,16 +164,18 @@ export interface CreateCategory {
     /**
      * This field can be set to another unique ID. In the case that the Category has been imported from another tool, the ID in the other tool can be indicated here.
      * @minLength 1
+     * @maxLength 128
      */
     external_id?: string;
-    /** The type of entity this Category is associated with; currently Milestone is the only type of Category. */
-    type: 'milestone';
+    /** The type of entity this Category is associated with; currently Milestone or Objective is the only type of Category. */
+    type?: any;
 }
-/** Request parameters for creating a Category with a Milestone. */
-export interface CreateCategoryParams {
+/** Request parameters for creating a Category with a Objective. */
+interface CreateCategoryParams {
     /**
      * The name of the new Category.
      * @minLength 1
+     * @maxLength 128
      */
     name: string;
     /**
@@ -159,10 +188,11 @@ export interface CreateCategoryParams {
     /**
      * This field can be set to another unique ID. In the case that the Category has been imported from another tool, the ID in the other tool can be indicated here.
      * @minLength 1
+     * @maxLength 128
      */
     external_id?: string;
 }
-export interface CreateCommentComment {
+interface CreateCommentComment {
     /**
      * The comment text.
      * @minLength 1
@@ -184,14 +214,18 @@ export interface CreateCommentComment {
      * @format date-time
      */
     updated_at?: string;
-    /** This field can be set to another unique ID. In the case that the comment has been imported from another tool, the ID in the other tool can be indicated here. */
+    /**
+     * This field can be set to another unique ID. In the case that the comment has been imported from another tool, the ID in the other tool can be indicated here.
+     * @maxLength 128
+     */
     external_id?: string;
 }
-/** Request paramaters for creating an entirely new entity template. */
-export interface CreateEntityTemplate {
+/** Request parameters for creating an entirely new entity template. */
+interface CreateEntityTemplate {
     /**
      * The name of the new entity template
      * @minLength 1
+     * @maxLength 128
      */
     name: string;
     /**
@@ -202,7 +236,7 @@ export interface CreateEntityTemplate {
     /** A map of story attributes this template populates. */
     story_contents: CreateStoryContents;
 }
-export interface CreateEpic {
+interface CreateEpic {
     /**
      * The Epic's description.
      * @maxLength 100000
@@ -215,6 +249,8 @@ export interface CreateEpic {
      * @format date-time
      */
     completed_at_override?: string;
+    /** An array of IDs for Objectives to which this Epic is related. */
+    objective_ids?: number[];
     /**
      * The Epic's name.
      * @minLength 1
@@ -227,9 +263,9 @@ export interface CreateEpic {
      */
     planned_start_date?: string | null;
     /** `Deprecated` The Epic's state (to do, in progress, or done); will be ignored when `epic_state_id` is set. */
-    state?: 'in progress' | 'to do' | 'done';
+    state?: "in progress" | "to do" | "done";
     /**
-     * The ID of the Milestone this Epic is related to.
+     * `Deprecated` The ID of the Milestone this Epic is related to. Use `objective_ids`.
      * @format int64
      */
     milestone_id?: number | null;
@@ -249,7 +285,7 @@ export interface CreateEpic {
      */
     started_at_override?: string;
     /**
-     * The ID of the group to associate with the epic.
+     * `Deprecated` The ID of the group to associate with the epic. Use `group_ids`.
      * @format uuid
      */
     group_id?: string | null;
@@ -260,9 +296,19 @@ export interface CreateEpic {
     updated_at?: string;
     /** An array of UUIDs for any Members you want to add as Followers on this new Epic. */
     follower_ids?: string[];
+    /** An array of UUIDS for Groups to which this Epic is related. */
+    group_ids?: string[];
+    /**
+     * The ID of the Story that was converted to an Epic.
+     * @format int64
+     */
+    converted_from_story_id?: number | null;
     /** An array of UUIDs for any members you want to add as Owners on this new Epic. */
     owner_ids?: string[];
-    /** This field can be set to another unique ID. In the case that the Epic has been imported from another tool, the ID in the other tool can be indicated here. */
+    /**
+     * This field can be set to another unique ID. In the case that the Epic has been imported from another tool, the ID in the other tool can be indicated here.
+     * @maxLength 128
+     */
     external_id?: string;
     /**
      * The Epic's deadline.
@@ -275,7 +321,7 @@ export interface CreateEpic {
      */
     created_at?: string;
 }
-export interface CreateEpicComment {
+interface CreateEpicComment {
     /**
      * The comment text.
      * @minLength 1
@@ -297,11 +343,35 @@ export interface CreateEpicComment {
      * @format date-time
      */
     updated_at?: string;
-    /** This field can be set to another unique ID. In the case that the comment has been imported from another tool, the ID in the other tool can be indicated here. */
+    /**
+     * This field can be set to another unique ID. In the case that the comment has been imported from another tool, the ID in the other tool can be indicated here.
+     * @maxLength 128
+     */
     external_id?: string;
 }
-export interface CreateGroup {
-    /** The description of the Group. */
+interface CreateEpicHealth {
+    /** The health status of the Epic. */
+    status: "At Risk" | "On Track" | "Off Track" | "No Health";
+    /** The description of the Health status. */
+    text?: string;
+}
+interface CreateGenericIntegration {
+    /**
+     * @maxLength 2048
+     * @pattern ^https?://.+$
+     */
+    webhook_url: string;
+    /**
+     * @minLength 1
+     * @maxLength 128
+     */
+    secret?: string;
+}
+interface CreateGroup {
+    /**
+     * The description of the Group.
+     * @maxLength 4096
+     */
     description?: string;
     /**
      * The Member ids to add to this Group.
@@ -330,14 +400,14 @@ export interface CreateGroup {
      */
     color?: string;
     /** The color key you wish to use for the Group in the system. */
-    color_key?: 'blue' | 'purple' | 'midnight-blue' | 'orange' | 'yellow-green' | 'brass' | 'gray' | 'fuchsia' | 'yellow' | 'pink' | 'sky-blue' | 'green' | 'red' | 'black' | 'slate' | 'turquoise';
+    color_key?: "blue" | "purple" | "midnight-blue" | "orange" | "yellow-green" | "brass" | "gray" | "fuchsia" | "yellow" | "pink" | "sky-blue" | "green" | "red" | "black" | "slate" | "turquoise";
     /**
      * The Icon id for the avatar of this Group.
      * @format uuid
      */
     display_icon_id?: string;
 }
-export interface CreateIteration {
+interface CreateIteration {
     /** An array of UUIDs for any Members you want to add as Followers. */
     follower_ids?: string[];
     /** An array of UUIDs for any Groups you want to add as Followers. Currently, only one Group association is presented in our web UI. */
@@ -367,14 +437,17 @@ export interface CreateIteration {
     end_date: string;
 }
 /** Request parameters for creating a Label on a Shortcut Story. */
-export interface CreateLabelParams {
+interface CreateLabelParams {
     /**
      * The name of the new Label.
      * @minLength 1
      * @maxLength 128
      */
     name: string;
-    /** The description of the new Label. */
+    /**
+     * The description of the new Label.
+     * @maxLength 1024
+     */
     description?: string;
     /**
      * The hex color to be displayed with the Label (for example, "#ff0000").
@@ -386,11 +459,15 @@ export interface CreateLabelParams {
     /**
      * This field can be set to another unique ID. In the case that the Label has been imported from another tool, the ID in the other tool can be indicated here.
      * @minLength 1
+     * @maxLength 128
      */
     external_id?: string;
 }
-export interface CreateLinkedFile {
-    /** The description of the file. */
+interface CreateLinkedFile {
+    /**
+     * The description of the file.
+     * @maxLength 512
+     */
     description?: string;
     /**
      * The ID of the linked story.
@@ -410,7 +487,7 @@ export interface CreateLinkedFile {
      */
     thumbnail_url?: string;
     /** The integration type of the file (e.g. google, dropbox, box). */
-    type: 'google' | 'url' | 'dropbox' | 'box' | 'onedrive';
+    type: "google" | "url" | "dropbox" | "box" | "onedrive";
     /**
      * The filesize, if the integration provided it.
      * @format int64
@@ -421,7 +498,10 @@ export interface CreateLinkedFile {
      * @format uuid
      */
     uploader_id?: string;
-    /** The content type of the image (e.g. txt/plain). */
+    /**
+     * The content type of the image (e.g. txt/plain).
+     * @maxLength 128
+     */
     content_type?: string;
     /**
      * The URL of linked file.
@@ -430,7 +510,7 @@ export interface CreateLinkedFile {
      */
     url: string;
 }
-export interface CreateMilestone {
+interface CreateMilestone {
     /**
      * The name of the Milestone.
      * @minLength 1
@@ -443,7 +523,7 @@ export interface CreateMilestone {
      */
     description?: string;
     /** The workflow state that the Milestone is in. */
-    state?: 'in progress' | 'to do' | 'done';
+    state?: "in progress" | "to do" | "done";
     /**
      * A manual override for the time/date the Milestone was started.
      * @format date-time
@@ -457,11 +537,38 @@ export interface CreateMilestone {
     /** An array of IDs of Categories attached to the Milestone. */
     categories?: CreateCategoryParams[];
 }
-export interface CreateOrDeleteStoryReaction {
+interface CreateObjective {
+    /**
+     * The name of the Objective.
+     * @minLength 1
+     * @maxLength 256
+     */
+    name: string;
+    /**
+     * The Objective's description.
+     * @maxLength 100000
+     */
+    description?: string;
+    /** The workflow state that the Objective is in. */
+    state?: "in progress" | "to do" | "done";
+    /**
+     * A manual override for the time/date the Objective was started.
+     * @format date-time
+     */
+    started_at_override?: string;
+    /**
+     * A manual override for the time/date the Objective was completed.
+     * @format date-time
+     */
+    completed_at_override?: string;
+    /** An array of IDs of Categories attached to the Objective. */
+    categories?: CreateCategoryParams[];
+}
+interface CreateOrDeleteStoryReaction {
     /** The emoji short-code to add / remove. E.g. `:thumbsup::skin-tone-4:`. */
     emoji: string;
 }
-export interface CreateProject {
+interface CreateProject {
     /**
      * The Project description.
      * @maxLength 100000
@@ -492,7 +599,10 @@ export interface CreateProject {
     updated_at?: string;
     /** An array of UUIDs for any members you want to add as Owners on this new Epic. */
     follower_ids?: string[];
-    /** This field can be set to another unique ID. In the case that the Project has been imported from another tool, the ID in the other tool can be indicated here. */
+    /**
+     * This field can be set to another unique ID. In the case that the Project has been imported from another tool, the ID in the other tool can be indicated here.
+     * @maxLength 128
+     */
     external_id?: string;
     /**
      * The ID of the team the project belongs to.
@@ -504,7 +614,10 @@ export interface CreateProject {
      * @format int64
      */
     iteration_length?: number;
-    /** The Project abbreviation used in Story summaries. Should be kept to 3 characters at most. */
+    /**
+     * The Project abbreviation used in Story summaries. Should be kept to 3 characters at most.
+     * @maxLength 63
+     */
     abbreviation?: string;
     /**
      * Defaults to the time/date it is created but can be set to reflect another date.
@@ -512,45 +625,44 @@ export interface CreateProject {
      */
     created_at?: string;
 }
-export interface CreateStories {
+interface CreateStories {
     /** An array of stories to be created. */
     stories: CreateStoryParams[];
 }
-export interface CreateStoryComment {
+interface CreateStoryComment {
+    /**
+     * The comment text.
+     * @maxLength 100000
+     */
+    text: string;
     /**
      * The Member ID of the Comment's author. Defaults to the user identified by the API token.
      * @format uuid
      */
     author_id?: string;
-    /** Marks the comment as a blocker that can be surfaced to permissions or teams mentioned in the comment. Can only be used on a top-level comment. */
-    blocker?: boolean;
+    /**
+     * Defaults to the time/date the comment is created, but can be set to reflect another date.
+     * @format date-time
+     */
+    created_at?: string;
     /**
      * Defaults to the time/date the comment is last updated, but can be set to reflect another date.
      * @format date-time
      */
     updated_at?: string;
-    /** This field can be set to another unique ID. In the case that the comment has been imported from another tool, the ID in the other tool can be indicated here. */
+    /**
+     * This field can be set to another unique ID. In the case that the comment has been imported from another tool, the ID in the other tool can be indicated here.
+     * @maxLength 1024
+     */
     external_id?: string;
     /**
      * The ID of the Comment that this comment is threaded under.
      * @format int64
      */
     parent_id?: number | null;
-    /** Marks the comment as an unblocker to its  blocker parent. Can only be set on a threaded comment who has a parent with `blocker` set. */
-    unblocks_parent?: boolean;
-    /**
-     * Defaults to the time/date the comment is created, but can be set to reflect another date.
-     * @format date-time
-     */
-    created_at?: string;
-    /**
-     * The comment text.
-     * @maxLength 100000
-     */
-    text: string;
 }
 /** Request parameters for creating a Comment on a Shortcut Story. */
-export interface CreateStoryCommentParams {
+interface CreateStoryCommentParams {
     /**
      * The comment text.
      * @maxLength 100000
@@ -571,43 +683,36 @@ export interface CreateStoryCommentParams {
      * @format date-time
      */
     updated_at?: string;
-    /** This field can be set to another unique ID. In the case that the comment has been imported from another tool, the ID in the other tool can be indicated here. */
+    /**
+     * This field can be set to another unique ID. In the case that the comment has been imported from another tool, the ID in the other tool can be indicated here.
+     * @maxLength 1024
+     */
     external_id?: string;
     /**
      * The ID of the Comment that this comment is threaded under.
      * @format int64
      */
     parent_id?: number | null;
-    /** Marks the comment as a blocker that can be surfaced to permissions or teams mentioned in the comment. Can only be used on a top-level comment. */
-    blocker?: boolean;
-    /** Marks the comment as an unblocker to its  blocker parent. Can only be set on a threaded comment who has a parent with `blocker` set. */
-    unblocks_parent?: boolean;
 }
 /** A map of story attributes this template populates. */
-export interface CreateStoryContents {
+interface CreateStoryContents {
     /** The description of the story. */
     description?: string;
-    /** A string description of this resource. */
-    entity_type?: string;
     /** An array of labels to be populated by the template. */
     labels?: CreateLabelParams[];
     /** The type of story (feature, bug, chore). */
     story_type?: string;
     /** An array of maps specifying a CustomField ID and CustomFieldEnumValue ID that represents an assertion of some value for a CustomField. */
     custom_fields?: CustomFieldValueParams[];
-    /** An array of linked files attached to the story. */
-    linked_files?: LinkedFile[];
     /**
      * An array of the attached file IDs to be populated.
      * @uniqueItems true
      */
     file_ids?: number[];
     /**
-     * The ID of the workflow.
-     * @format int64
+     * The name of the story.
+     * @maxLength 512
      */
-    workflow_id?: number | null;
-    /** The name of the story. */
     name?: string;
     /**
      * The ID of the epic the to be populated.
@@ -616,25 +721,25 @@ export interface CreateStoryContents {
     epic_id?: number | null;
     /** An array of external links to be populated. */
     external_links?: string[];
+    /** An array of sub-tasks connected to the story */
+    sub_tasks?: CreateSubTaskParams[];
     /**
      * The ID of the iteration the to be populated.
      * @format int64
      */
     iteration_id?: number | null;
     /** An array of tasks to be populated by the template. */
-    tasks?: EntityTemplateTask[];
-    /** An array of label ids attached to the story. */
-    label_ids?: number[];
+    tasks?: BaseTaskParams[];
     /**
      * The ID of the group to be populated.
      * @format uuid
      */
     group_id?: string | null;
     /**
-     * The ID of the workflow state the story is currently in.
+     * The ID of the workflow state to be populated.
      * @format int64
      */
-    workflow_state_id?: number;
+    workflow_state_id?: number | null;
     /** An array of UUIDs for any Members listed as Followers. */
     follower_ids?: string[];
     /** An array of UUIDs of the owners of this story. */
@@ -644,8 +749,6 @@ export interface CreateStoryContents {
      * @format int64
      */
     estimate?: number | null;
-    /** An array of files attached to the story. */
-    files?: UploadedFile[];
     /**
      * The ID of the project the story belongs to.
      * @format int64
@@ -662,9 +765,208 @@ export interface CreateStoryContents {
      */
     deadline?: string | null;
 }
-export interface CreateStoryLink {
+/** Request parameters for creating a story from a story template. These parameters are merged with the values derived from the template. */
+interface CreateStoryFromTemplateParams {
+    /**
+     * The description of the story.
+     * @maxLength 100000
+     */
+    description?: string;
+    /** Controls the story's archived state. */
+    archived?: boolean;
+    /** An array of story links attached to the story. */
+    story_links?: CreateStoryLinkParams[];
+    /** An array of labels attached to the story. */
+    labels?: CreateLabelParams[];
+    /**
+     * An array of External Links associated with this story. These will be added to any links provided by the template. Cannot be used in conjunction with `external_links`.
+     * @uniqueItems true
+     */
+    external_links_add?: string[];
+    /** The type of story (feature, bug, chore). */
+    story_type?: "feature" | "chore" | "bug";
+    /** A map specifying a CustomField ID and CustomFieldEnumValue ID that represents an assertion of some value for a CustomField. */
+    custom_fields?: CustomFieldValueParams[];
+    /** One of "first" or "last". This can be used to move the given story to the first or last position in the workflow state. */
+    move_to?: "last" | "first";
+    /**
+     * An array of IDs of files attached to the story.
+     * @uniqueItems true
+     */
+    file_ids?: number[];
+    /**
+     * Given this story was converted from a task in another story, this is the original task ID that was converted to this story.
+     * @format int64
+     */
+    source_task_id?: number | null;
+    /**
+     * A manual override for the time/date the Story was completed.
+     * @format date-time
+     */
+    completed_at_override?: string;
+    /**
+     * The name of the story. Must be provided if the template does not provide a name.
+     * @minLength 1
+     * @maxLength 512
+     */
+    name?: string;
+    /**
+     * An array of IDs of files attached to the story in addition to files from the template. Cannot be used in conjunction with `file_ids`.
+     * @uniqueItems true
+     */
+    file_ids_add?: number[];
+    /**
+     * An array of IDs of files removed from files from the template. Cannot be used in conjunction with `file_ids`.
+     * @uniqueItems true
+     */
+    file_ids_remove?: number[];
+    /** An array of comments to add to the story. */
+    comments?: CreateStoryCommentParams[];
+    /**
+     * The UUIDs of the new followers to be added in addition to followers from the template. Cannot be used in conjunction with `follower_ids.`
+     * @uniqueItems true
+     */
+    follower_ids_add?: string[];
+    /**
+     * The ID of the epic the story belongs to.
+     * @format int64
+     */
+    epic_id?: number | null;
+    /**
+     * The id of the story template used to create this story.
+     * @format uuid
+     */
+    story_template_id: string;
+    /** An array of External Links associated with this story. */
+    external_links?: string[];
+    /**
+     * The UUIDs of the new followers to be removed from followers from the template. Cannot be used in conjunction with `follower_ids`.
+     * @uniqueItems true
+     */
+    follower_ids_remove?: string[];
+    /** A list of either params to create a new sub-task or link an existing story as a sub-task */
+    sub_tasks?: (LinkSubTaskParams | CreateSubTaskParams)[];
+    /**
+     * An array of IDs of linked files removed from files from the template. Cannot be used in conjunction with `linked_files.`
+     * @uniqueItems true
+     */
+    linked_file_ids_remove?: number[];
+    /**
+     * The ID of the member that requested the story.
+     * @format uuid
+     */
+    requested_by_id?: string;
+    /**
+     * The ID of the iteration the story belongs to.
+     * @format int64
+     */
+    iteration_id?: number | null;
+    /**
+     * A map specifying a CustomField ID. These will be removed from any fields provided by the template. Cannot be used in conjunction with `custom_fields`.
+     * @uniqueItems true
+     */
+    custom_fields_remove?: RemoveCustomFieldParams[];
+    /** An array of tasks connected to the story. */
+    tasks?: CreateTaskParams[];
+    /**
+     * A manual override for the time/date the Story was started.
+     * @format date-time
+     */
+    started_at_override?: string;
+    /**
+     * An array of labels attached to the story in addition to the labels provided by the template. Cannot be used in conjunction with `labels`.
+     * @uniqueItems true
+     */
+    labels_add?: CreateLabelParams[];
+    /**
+     * The id of the group to associate with this story.
+     * @format uuid
+     */
+    group_id?: string | null;
+    /**
+     * The ID of the workflow state the story will be in.
+     * @format int64
+     */
+    workflow_state_id?: number;
+    /**
+     * The time/date the Story was updated.
+     * @format date-time
+     */
+    updated_at?: string;
+    /**
+     * An array of UUIDs of the followers of this story.
+     * @uniqueItems true
+     */
+    follower_ids?: string[];
+    /**
+     * An array of UUIDs of the owners of this story.
+     * @uniqueItems true
+     */
+    owner_ids?: string[];
+    /**
+     * This field can be set to another unique ID. In the case that the Story has been imported from another tool, the ID in the other tool can be indicated here.
+     * @maxLength 1024
+     */
+    external_id?: string;
+    /**
+     * The numeric point estimate of the story. Can also be null, which means unestimated.
+     * @format int64
+     */
+    estimate?: number | null;
+    /**
+     * The UUIDs of the new owners to be removed from owners from the template. Cannot be used in conjunction with `owners`.
+     * @uniqueItems true
+     */
+    owner_ids_remove?: string[];
+    /**
+     * A map specifying a CustomField ID and CustomFieldEnumValue ID that represents an assertion of some value for a CustomField. These will be added to any fields provided by the template. Cannot be used in conjunction with `custom_fields`.
+     * @uniqueItems true
+     */
+    custom_fields_add?: CustomFieldValueParams[];
+    /**
+     * The ID of the project the story belongs to.
+     * @format int64
+     */
+    project_id?: number | null;
+    /**
+     * An array of IDs of linked files attached to the story in addition to files from the template. Cannot be used in conjunction with `linked_files`.
+     * @uniqueItems true
+     */
+    linked_file_ids_add?: number[];
+    /**
+     * An array of IDs of linked files attached to the story.
+     * @uniqueItems true
+     */
+    linked_file_ids?: number[];
+    /**
+     * An array of labels to remove from the labels provided by the template. Cannot be used in conjunction with `labels`.
+     * @uniqueItems true
+     */
+    labels_remove?: RemoveLabelParams[];
+    /**
+     * The due date of the story.
+     * @format date-time
+     */
+    deadline?: string | null;
+    /**
+     * The UUIDs of the new owners to be added in addition to owners from the template. Cannot be used in conjunction with `owners`.
+     * @uniqueItems true
+     */
+    owner_ids_add?: string[];
+    /**
+     * The time/date the Story was created.
+     * @format date-time
+     */
+    created_at?: string;
+    /**
+     * An array of External Links associated with this story. These will be removed from any links provided by the template. Cannot be used in conjunction with `external_links`.
+     * @uniqueItems true
+     */
+    external_links_remove?: string[];
+}
+interface CreateStoryLink {
     /** The type of link. */
-    verb: 'blocks' | 'duplicates' | 'relates to';
+    verb: "blocks" | "duplicates" | "relates to";
     /**
      * The ID of the subject Story.
      * @format int64
@@ -677,14 +979,14 @@ export interface CreateStoryLink {
     object_id: number;
 }
 /** Request parameters for creating a Story Link within a Story. */
-export interface CreateStoryLinkParams {
+interface CreateStoryLinkParams {
     /**
      * The unique ID of the Story defined as subject.
      * @format int64
      */
     subject_id?: number;
     /** How the subject Story acts on the object Story. This can be "blocks", "duplicates", or "relates to". */
-    verb: 'blocks' | 'duplicates' | 'relates to';
+    verb: "blocks" | "duplicates" | "relates to";
     /**
      * The unique ID of the Story defined as object.
      * @format int64
@@ -692,7 +994,7 @@ export interface CreateStoryLinkParams {
     object_id?: number;
 }
 /** Request parameters for creating a story. */
-export interface CreateStoryParams {
+interface CreateStoryParams {
     /**
      * The description of the story.
      * @maxLength 100000
@@ -705,16 +1007,21 @@ export interface CreateStoryParams {
     /** An array of labels attached to the story. */
     labels?: CreateLabelParams[];
     /** The type of story (feature, bug, chore). */
-    story_type?: 'feature' | 'chore' | 'bug';
+    story_type?: "feature" | "chore" | "bug";
     /** A map specifying a CustomField ID and CustomFieldEnumValue ID that represents an assertion of some value for a CustomField. */
     custom_fields?: CustomFieldValueParams[];
     /** One of "first" or "last". This can be used to move the given story to the first or last position in the workflow state. */
-    move_to?: 'last' | 'first';
+    move_to?: "last" | "first";
     /**
      * An array of IDs of files attached to the story.
      * @uniqueItems true
      */
     file_ids?: number[];
+    /**
+     * Given this story was converted from a task in another story, this is the original task ID that was converted to this story.
+     * @format int64
+     */
+    source_task_id?: number | null;
     /**
      * A manual override for the time/date the Story was completed.
      * @format date-time
@@ -740,6 +1047,8 @@ export interface CreateStoryParams {
     story_template_id?: string | null;
     /** An array of External Links associated with this story. */
     external_links?: string[];
+    /** A list of either params to create a new sub-task or link an existing story as a sub-task */
+    sub_tasks?: (LinkSubTaskParams | CreateSubTaskParams)[];
     /**
      * The ID of the member that requested the story.
      * @format uuid
@@ -782,7 +1091,10 @@ export interface CreateStoryParams {
      * @uniqueItems true
      */
     owner_ids?: string[];
-    /** This field can be set to another unique ID. In the case that the Story has been imported from another tool, the ID in the other tool can be indicated here. */
+    /**
+     * This field can be set to another unique ID. In the case that the Story has been imported from another tool, the ID in the other tool can be indicated here.
+     * @maxLength 1024
+     */
     external_id?: string;
     /**
      * The numeric point estimate of the story. Can also be null, which means unestimated.
@@ -810,7 +1122,25 @@ export interface CreateStoryParams {
      */
     created_at?: string;
 }
-export interface CreateTask {
+interface CreateSubTaskParams {
+    /**
+     * The name of the SubTask.
+     * @minLength 1
+     * @maxLength 512
+     */
+    name: string;
+    /**
+     * An array of UUIDs of the owners of this story.
+     * @uniqueItems true
+     */
+    owner_ids?: string[];
+    /**
+     * The ID of the workflow state the story will be in.
+     * @format int64
+     */
+    workflow_state_id?: number;
+}
+interface CreateTask {
     /**
      * The Task description.
      * @minLength 1
@@ -821,6 +1151,11 @@ export interface CreateTask {
     complete?: boolean;
     /** An array of UUIDs for any members you want to add as Owners on this new Task. */
     owner_ids?: string[];
+    /**
+     * This field can be set to another unique ID. In the case that the Task has been imported from another tool, the ID in the other tool can be indicated here.
+     * @maxLength 128
+     */
+    external_id?: string;
     /**
      * Defaults to the time/date the Task is created but can be set to reflect another creation time/date.
      * @format date-time
@@ -831,11 +1166,9 @@ export interface CreateTask {
      * @format date-time
      */
     updated_at?: string;
-    /** This field can be set to another unique ID. In the case that the Task has been imported from another tool, the ID in the other tool can be indicated here. */
-    external_id?: string;
 }
 /** Request parameters for creating a Task on a Story. */
-export interface CreateTaskParams {
+interface CreateTaskParams {
     /**
      * The Task description.
      * @minLength 1
@@ -846,6 +1179,11 @@ export interface CreateTaskParams {
     complete?: boolean;
     /** An array of UUIDs for any members you want to add as Owners on this new Task. */
     owner_ids?: string[];
+    /**
+     * This field can be set to another unique ID. In the case that the Task has been imported from another tool, the ID in the other tool can be indicated here.
+     * @maxLength 128
+     */
+    external_id?: string;
     /**
      * Defaults to the time/date the Task is created but can be set to reflect another creation time/date.
      * @format date-time
@@ -856,10 +1194,8 @@ export interface CreateTaskParams {
      * @format date-time
      */
     updated_at?: string;
-    /** This field can be set to another unique ID. In the case that the Task has been imported from another tool, the ID in the other tool can be indicated here. */
-    external_id?: string;
 }
-export interface CustomField {
+interface CustomField {
     /**
      * A string description of the CustomField
      * @minLength 1
@@ -873,7 +1209,7 @@ export interface CustomField {
      */
     icon_set_identifier?: string;
     /** A string description of this resource. */
-    entity_type: 'custom-field';
+    entity_type: "custom-field";
     /** The types of stories this CustomField is scoped to. */
     story_types?: string[];
     /**
@@ -897,7 +1233,7 @@ export interface CustomField {
     /** A collection of legal values for a CustomField. */
     values?: CustomFieldEnumValue[];
     /** The type of Custom Field, eg. 'enum'. */
-    field_type: 'enum';
+    field_type: "enum";
     /**
      * An integer indicating the position of this Custom Field with respect to the other CustomField
      * @format int64
@@ -913,7 +1249,7 @@ export interface CustomField {
      */
     created_at: string;
 }
-export interface CustomFieldEnumValue {
+interface CustomFieldEnumValue {
     /**
      * The unique public ID for the Custom Field.
      * @format uuid
@@ -933,11 +1269,11 @@ export interface CustomFieldEnumValue {
     /** A color key associated with this CustomFieldEnumValue. */
     color_key?: string | null;
     /** A string description of this resource. */
-    entity_type: 'custom-field-enum-value';
+    entity_type: "custom-field-enum-value";
     /** When true, the CustomFieldEnumValue can be selected for the CustomField. */
     enabled: boolean;
 }
-export interface CustomFieldValueParams {
+interface CustomFieldValueParams {
     /**
      * The unique public ID for the CustomField.
      * @format uuid
@@ -952,12 +1288,12 @@ export interface CustomFieldValueParams {
     value?: string;
 }
 /** Error returned when Datomic tx fails due to Datomc :db.error/cas-failed error */
-export interface DataConflictError {
-    error: 'data-conflict-error';
+interface DataConflictError {
+    error: "data-conflict-error";
     /** An explanatory message: "The update failed due to a data conflict. Please refresh and try again." */
     message: string;
 }
-export interface DeleteStories {
+interface DeleteStories {
     /**
      * An array of IDs of Stories to delete.
      * @uniqueItems true
@@ -965,7 +1301,7 @@ export interface DeleteStories {
     story_ids: number[];
 }
 /** An entity template can be used to prefill various fields when creating new stories. */
-export interface EntityTemplate {
+interface EntityTemplate {
     /** A string description of this resource. */
     entity_type: string;
     /**
@@ -998,23 +1334,8 @@ export interface EntityTemplate {
     /** A container entity for the attributes this template should populate. */
     story_contents: StoryContents;
 }
-/** Request parameters for specifying how to pre-populate a task through a template. */
-export interface EntityTemplateTask {
-    /**
-     * The Task description.
-     * @minLength 1
-     * @maxLength 2048
-     */
-    description: string;
-    /** True/false boolean indicating whether the Task is completed. Defaults to false. */
-    complete?: boolean;
-    /** An array of UUIDs for any members you want to add as Owners on this new Task. */
-    owner_ids?: string[];
-    /** This field can be set to another unique ID. In the case that the Task has been imported from another tool, the ID in the other tool can be indicated here. */
-    external_id?: string;
-}
-/** An Epic is a collection of stories that together might make up a release, a milestone, or some other large initiative that you are working on. */
-export interface Epic {
+/** An Epic is a collection of stories that together might make up a release, a objective, or some other large initiative that you are working on. */
+interface Epic {
     /** The Shortcut application url for the Epic. */
     app_url: string;
     /** The Epic's description. */
@@ -1027,7 +1348,7 @@ export interface Epic {
     entity_type: string;
     /** An array of Labels attached to the Epic. */
     labels: LabelSlim[];
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /** An array of Member IDs that have been mentioned in the Epic description. */
     member_mention_ids: string[];
@@ -1060,6 +1381,8 @@ export interface Epic {
      * @format date-time
      */
     completed_at?: string | null;
+    /** An array of IDs for Objectives to which this epic is related. */
+    objective_ids: number[];
     /** The name of the Epic. */
     name: string;
     global_id: string;
@@ -1077,7 +1400,7 @@ export interface Epic {
     /** `Deprecated` The workflow state that the Epic is in. */
     state: string;
     /**
-     * The ID of the Milestone this Epic is related to.
+     * `Deprecated` The ID of the Objective this Epic is related to. Use `objective_ids`.
      * @format int64
      */
     milestone_id?: number | null;
@@ -1098,7 +1421,10 @@ export interface Epic {
      * @format date-time
      */
     started_at_override?: string | null;
-    /** @format uuid */
+    /**
+     * `Deprecated` The ID of the group to associate with the epic. Use `group_ids`.
+     * @format uuid
+     */
     group_id?: string | null;
     /**
      * The time/date the Epic was updated.
@@ -1114,6 +1440,8 @@ export interface Epic {
     productboard_id?: string | null;
     /** An array of UUIDs for any Members you want to add as Followers on this Epic. */
     follower_ids: string[];
+    /** An array of UUIDS for Groups to which this Epic is related. */
+    group_ids: string[];
     /** An array of UUIDs for any members you want to add as Owners on this new Epic. */
     owner_ids: string[];
     /** This field can be set to another unique ID. In the case that the Epic has been imported from another tool, the ID in the other tool can be indicated here. */
@@ -1123,6 +1451,8 @@ export interface Epic {
      * @format int64
      */
     id: number;
+    /** The current health status of the Epic. */
+    health?: Health;
     /**
      * The Epic's relative position in the Epic workflow state.
      * @format int64
@@ -1143,7 +1473,7 @@ export interface Epic {
      */
     created_at?: string | null;
 }
-export interface EpicAssociatedGroup {
+interface EpicAssociatedGroup {
     /**
      * The Group ID of the associated group.
      * @format uuid
@@ -1155,8 +1485,23 @@ export interface EpicAssociatedGroup {
      */
     associated_stories_count?: number;
 }
+/** Results schema for paginated Epic listing. */
+interface EpicPaginatedResults {
+    /** Array of Epic objects on the current page */
+    data: EpicSlim[];
+    /**
+     * The next page number if there are more results, or null for the last page
+     * @format int64
+     */
+    next?: number | null;
+    /**
+     * The total number of Epics matching the query over all pages
+     * @format int64
+     */
+    total: number;
+}
 /** An Epic in search results. This is typed differently from Epic because the details=slim search argument will omit some fields. */
-export interface EpicSearchResult {
+interface EpicSearchResult {
     /** The Shortcut application url for the Epic. */
     app_url: string;
     /** The Epic's description. */
@@ -1169,7 +1514,7 @@ export interface EpicSearchResult {
     entity_type: string;
     /** An array of Labels attached to the Epic. */
     labels: LabelSlim[];
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /** An array of Member IDs that have been mentioned in the Epic description. */
     member_mention_ids: string[];
@@ -1202,6 +1547,8 @@ export interface EpicSearchResult {
      * @format date-time
      */
     completed_at?: string | null;
+    /** An array of IDs for Objectives to which this epic is related. */
+    objective_ids: number[];
     /** The name of the Epic. */
     name: string;
     global_id: string;
@@ -1219,7 +1566,7 @@ export interface EpicSearchResult {
     /** `Deprecated` The workflow state that the Epic is in. */
     state: string;
     /**
-     * The ID of the Milestone this Epic is related to.
+     * `Deprecated` The ID of the Objective this Epic is related to. Use `objective_ids`.
      * @format int64
      */
     milestone_id?: number | null;
@@ -1240,7 +1587,10 @@ export interface EpicSearchResult {
      * @format date-time
      */
     started_at_override?: string | null;
-    /** @format uuid */
+    /**
+     * `Deprecated` The ID of the group to associate with the epic. Use `group_ids`.
+     * @format uuid
+     */
     group_id?: string | null;
     /**
      * The time/date the Epic was updated.
@@ -1256,6 +1606,8 @@ export interface EpicSearchResult {
     productboard_id?: string | null;
     /** An array of UUIDs for any Members you want to add as Followers on this Epic. */
     follower_ids: string[];
+    /** An array of UUIDS for Groups to which this Epic is related. */
+    group_ids: string[];
     /** An array of UUIDs for any members you want to add as Owners on this new Epic. */
     owner_ids: string[];
     /** This field can be set to another unique ID. In the case that the Epic has been imported from another tool, the ID in the other tool can be indicated here. */
@@ -1265,6 +1617,8 @@ export interface EpicSearchResult {
      * @format int64
      */
     id: number;
+    /** The current health status of the Epic. */
+    health?: Health;
     /**
      * The Epic's relative position in the Epic workflow state.
      * @format int64
@@ -1286,7 +1640,7 @@ export interface EpicSearchResult {
     created_at?: string | null;
 }
 /** The results of the Epic search query. */
-export interface EpicSearchResults {
+interface EpicSearchResults {
     /**
      * The total number of matches for the search query. The first 1000 matches can be paged through via the API.
      * @format int64
@@ -1296,10 +1650,9 @@ export interface EpicSearchResults {
     data: EpicSearchResult[];
     /** The URL path and query string for the next page of search results. */
     next?: string | null;
-    cursors?: string[];
 }
 /** EpicSlim represents the same resource as an Epic but is more light-weight, including all Epic fields except the comments array. The description string can be optionally included. Use the [Get Epic](#Get-Epic) endpoint to fetch the unabridged payload for an Epic. */
-export interface EpicSlim {
+interface EpicSlim {
     /** The Shortcut application url for the Epic. */
     app_url: string;
     /** The Epic's description. */
@@ -1312,7 +1665,7 @@ export interface EpicSlim {
     entity_type: string;
     /** An array of Labels attached to the Epic. */
     labels: LabelSlim[];
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /** An array of Member IDs that have been mentioned in the Epic description. */
     member_mention_ids: string[];
@@ -1345,6 +1698,8 @@ export interface EpicSlim {
      * @format date-time
      */
     completed_at?: string | null;
+    /** An array of IDs for Objectives to which this epic is related. */
+    objective_ids: number[];
     /** The name of the Epic. */
     name: string;
     global_id: string;
@@ -1360,7 +1715,7 @@ export interface EpicSlim {
     /** `Deprecated` The workflow state that the Epic is in. */
     state: string;
     /**
-     * The ID of the Milestone this Epic is related to.
+     * `Deprecated` The ID of the Objective this Epic is related to. Use `objective_ids`.
      * @format int64
      */
     milestone_id?: number | null;
@@ -1381,7 +1736,10 @@ export interface EpicSlim {
      * @format date-time
      */
     started_at_override?: string | null;
-    /** @format uuid */
+    /**
+     * `Deprecated` The ID of the group to associate with the epic. Use `group_ids`.
+     * @format uuid
+     */
     group_id?: string | null;
     /**
      * The time/date the Epic was updated.
@@ -1397,6 +1755,8 @@ export interface EpicSlim {
     productboard_id?: string | null;
     /** An array of UUIDs for any Members you want to add as Followers on this Epic. */
     follower_ids: string[];
+    /** An array of UUIDS for Groups to which this Epic is related. */
+    group_ids: string[];
     /** An array of UUIDs for any members you want to add as Owners on this new Epic. */
     owner_ids: string[];
     /** This field can be set to another unique ID. In the case that the Epic has been imported from another tool, the ID in the other tool can be indicated here. */
@@ -1427,7 +1787,7 @@ export interface EpicSlim {
     created_at?: string | null;
 }
 /** Epic State is any of the at least 3 columns. Epic States correspond to one of 3 types: Unstarted, Started, or Done. */
-export interface EpicState {
+interface EpicState {
     /** The description of what sort of Epics belong in that Epic State. */
     description: string;
     /** A string description of this resource. */
@@ -1466,7 +1826,7 @@ export interface EpicState {
     created_at: string;
 }
 /** A group of calculated values for this Epic. */
-export interface EpicStats {
+interface EpicStats {
     /**
      * The total number of completed points in this Epic.
      * @format int64
@@ -1477,11 +1837,6 @@ export interface EpicStats {
      * @format int64
      */
     num_related_documents: number;
-    /**
-     * The average cycle time (in seconds) of completed stories in this Epic.
-     * @format int64
-     */
-    average_cycle_time?: number;
     /**
      * The total number of unstarted Stories in this Epic.
      * @format int64
@@ -1522,11 +1877,6 @@ export interface EpicStats {
      * @format int64
      */
     num_stories_backlog: number;
-    /**
-     * The average lead time (in seconds) of completed stories in this Epic.
-     * @format int64
-     */
-    average_lead_time?: number;
     /**
      * The total number of backlog points in this Epic.
      * @format int64
@@ -1544,7 +1894,7 @@ export interface EpicStats {
     num_stories_done: number;
 }
 /** Epic Workflow is the array of defined Epic States. Epic Workflow can be queried using the API but must be updated in the Shortcut UI.  */
-export interface EpicWorkflow {
+interface EpicWorkflow {
     /** A string description of this resource. */
     entity_type: string;
     /**
@@ -1568,41 +1918,10 @@ export interface EpicWorkflow {
      */
     default_epic_state_id: number;
     /** A map of the Epic States in this Epic Workflow. */
-    epic_states: EpicState[];
-}
-export interface GetEpicStories {
-    /** A true/false boolean indicating whether to return Stories with their descriptions. */
-    includes_description?: boolean;
-}
-export interface GetExternalLinkStoriesParams {
-    /**
-     * The external link associated with one or more stories.
-     * @maxLength 2048
-     * @pattern ^https?://.+$
-     */
-    external_link: string;
-}
-export interface GetIterationStories {
-    /** A true/false boolean indicating whether to return Stories with their descriptions. */
-    includes_description?: boolean;
-}
-export interface GetLabelStories {
-    /** A true/false boolean indicating whether to return Stories with their descriptions. */
-    includes_description?: boolean;
-}
-export interface GetMember {
-    /**
-     * The unique ID of the Organization to limit the lookup to.
-     * @format uuid
-     */
-    'org-public-id'?: string;
-}
-export interface GetProjectStories {
-    /** A true/false boolean indicating whether to return Stories with their descriptions. */
-    includes_description?: boolean;
+    epic_states: EpicState[];
 }
 /** A Group. */
-export interface Group {
+interface Group {
     /** The Shortcut application url for the Group. */
     app_url: string;
     /** The description of the Group. */
@@ -1633,9 +1952,9 @@ export interface Group {
     name: string;
     global_id: string;
     /** The color key to be displayed with the Group. */
-    color_key?: 'blue' | 'purple' | 'midnight-blue' | 'orange' | 'yellow-green' | 'brass' | 'gray' | 'fuchsia' | 'yellow' | 'pink' | 'sky-blue' | 'green' | 'red' | 'black' | 'slate' | 'turquoise' | null;
+    color_key?: "blue" | "purple" | "midnight-blue" | "orange" | "yellow-green" | "brass" | "gray" | "fuchsia" | "yellow" | "pink" | "sky-blue" | "green" | "red" | "black" | "slate" | "turquoise" | null;
     /**
-     * The total number of stories assigned ot the group.
+     * The total number of stories assigned to the group.
      * @format int64
      */
     num_stories: number;
@@ -1656,13 +1975,59 @@ export interface Group {
     id: string;
     /** Icons are used to attach images to Groups, Workspaces, Members, and Loading screens in the Shortcut web application. */
     display_icon: Icon | null;
+    /**
+     * The ID of the default workflow for stories created in this group.
+     * @format int64
+     */
+    default_workflow_id?: number | null;
     /** The Member IDs contain within the Group. */
     member_ids: string[];
     /** The Workflow IDs contained within the Group. */
     workflow_ids: number[];
 }
+/** The current health status of the Epic. */
+interface Health {
+    /** A string description of this resource. */
+    entity_type: string;
+    /**
+     * The ID of the permission who created or updated the Health record.
+     * @format uuid
+     */
+    author_id?: string;
+    /**
+     * The ID of the Epic associated with this Health record.
+     * @format int64
+     */
+    epic_id?: number;
+    /**
+     * The ID of the Objective associated with this Health record.
+     * @format int64
+     */
+    objective_id?: number;
+    /**
+     * The time that the Health record was updated.
+     * @format date-time
+     */
+    updated_at?: string;
+    /** The health status of the Epic or Objective. */
+    status: "At Risk" | "On Track" | "Off Track" | "No Health";
+    /**
+     * The unique ID of the Health record.
+     * @format uuid
+     */
+    id?: string | null;
+    /**
+     * The time that the Health record was created.
+     * @format date-time
+     */
+    created_at?: string;
+    /** The text of the Health record. */
+    text?: string;
+}
 /** A history item is a group of actions that represent a transactional change to a Story. */
-export interface History {
+interface History {
+    /** The name of the actor that performed the action, if it can be determined. */
+    actor_name?: string;
     /** The date when the change occurred. */
     changed_at: string;
     /** The ID of the primary entity that has changed, if applicable. */
@@ -1684,12 +2049,17 @@ export interface History {
      */
     id: string;
     /** The version of the change format. */
-    version: 'v1';
+    version: "v1";
     /** The ID of the webhook that handled the change. */
     webhook_id?: string | null;
+    /**
+     * The ID of the automation that performed the change.
+     * @format uuid
+     */
+    automation_id?: string;
 }
 /** An action representing a VCS Branch being created. */
-export interface HistoryActionBranchCreate {
+interface HistoryActionBranchCreate {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -1702,10 +2072,10 @@ export interface HistoryActionBranchCreate {
     /** The URL from the provider of the VCS Branch that was pushed */
     url: string;
     /** The action of the entity referenced. */
-    action: 'create';
+    action: "create";
 }
 /** An action representing a VCS Branch being merged. */
-export interface HistoryActionBranchMerge {
+interface HistoryActionBranchMerge {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -1718,10 +2088,10 @@ export interface HistoryActionBranchMerge {
     /** The URL from the provider of the VCS Branch that was pushed */
     url: string;
     /** The action of the entity referenced. */
-    action: 'merge';
+    action: "merge";
 }
 /** An action representing a VCS Branch being pushed. */
-export interface HistoryActionBranchPush {
+interface HistoryActionBranchPush {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -1734,10 +2104,10 @@ export interface HistoryActionBranchPush {
     /** The URL from the provider of the VCS Branch that was pushed */
     url: string;
     /** The action of the entity referenced. */
-    action: 'push';
+    action: "push";
 }
 /** An action representing a Label being created. */
-export interface HistoryActionLabelCreate {
+interface HistoryActionLabelCreate {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -1746,7 +2116,7 @@ export interface HistoryActionLabelCreate {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'create';
+    action: "create";
     /**
      * The application URL of the Label.
      * @maxLength 2048
@@ -1757,7 +2127,7 @@ export interface HistoryActionLabelCreate {
     name: string;
 }
 /** An action representing a Label being deleted. */
-export interface HistoryActionLabelDelete {
+interface HistoryActionLabelDelete {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -1766,12 +2136,12 @@ export interface HistoryActionLabelDelete {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'delete';
+    action: "delete";
     /** The name of the Label. */
     name: string;
 }
 /** An action representing a Label being updated. */
-export interface HistoryActionLabelUpdate {
+interface HistoryActionLabelUpdate {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -1780,10 +2150,10 @@ export interface HistoryActionLabelUpdate {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'update';
+    action: "update";
 }
 /** An action representing a Project being updated. */
-export interface HistoryActionProjectUpdate {
+interface HistoryActionProjectUpdate {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -1792,7 +2162,7 @@ export interface HistoryActionProjectUpdate {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'update';
+    action: "update";
     /**
      * The application URL of the Project.
      * @maxLength 2048
@@ -1803,7 +2173,7 @@ export interface HistoryActionProjectUpdate {
     name: string;
 }
 /** An action representing various operations for a Pull Request. */
-export interface HistoryActionPullRequest {
+interface HistoryActionPullRequest {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -1812,7 +2182,7 @@ export interface HistoryActionPullRequest {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'open' | 'update' | 'reopen' | 'close' | 'sync' | 'comment';
+    action: "open" | "update" | "reopen" | "close" | "sync" | "comment";
     /**
      * The VCS Repository-specific ID for the Pull Request.
      * @format int64
@@ -1828,7 +2198,7 @@ export interface HistoryActionPullRequest {
     url: string;
 }
 /** An action representing a Story Comment being created. */
-export interface HistoryActionStoryCommentCreate {
+interface HistoryActionStoryCommentCreate {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -1837,7 +2207,7 @@ export interface HistoryActionStoryCommentCreate {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'create';
+    action: "create";
     /**
      * The application URL of the Story Comment.
      * @maxLength 2048
@@ -1853,7 +2223,7 @@ export interface HistoryActionStoryCommentCreate {
     author_id: string;
 }
 /** An action representing a Story being created. */
-export interface HistoryActionStoryCreate {
+interface HistoryActionStoryCreate {
     /**
      * The application URL of the Story.
      * @maxLength 2048
@@ -1869,7 +2239,7 @@ export interface HistoryActionStoryCreate {
     /** An array of Task IDs on this Story. */
     task_ids?: number[];
     /** The type of Story; either feature, bug, or chore. */
-    story_type: 'feature' | 'chore' | 'bug';
+    story_type: "feature" | "chore" | "bug";
     /** The name of the Story. */
     name: string;
     /** Whether or not the Story is completed. */
@@ -1924,7 +2294,7 @@ export interface HistoryActionStoryCreate {
     /** An array of Story IDs that are the subject of a Story Link relationship. */
     subject_story_link_ids?: number[];
     /** The action of the entity referenced. */
-    action: 'create';
+    action: "create";
     /** Whether or not the Story is blocked by another Story. */
     blocked?: boolean;
     /**
@@ -1936,7 +2306,7 @@ export interface HistoryActionStoryCreate {
     deadline?: string;
 }
 /** An action representing a Story being deleted. */
-export interface HistoryActionStoryDelete {
+interface HistoryActionStoryDelete {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -1945,14 +2315,14 @@ export interface HistoryActionStoryDelete {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'delete';
+    action: "delete";
     /** The name of the Story. */
     name: string;
     /** The type of Story; either feature, bug, or chore. */
-    story_type: 'feature' | 'chore' | 'bug';
+    story_type: "feature" | "chore" | "bug";
 }
 /** An action representing a Story Link being created. */
-export interface HistoryActionStoryLinkCreate {
+interface HistoryActionStoryLinkCreate {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -1961,9 +2331,9 @@ export interface HistoryActionStoryLinkCreate {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'create';
+    action: "create";
     /** The verb describing the link's relationship. */
-    verb: 'blocks' | 'duplicates' | 'relates to';
+    verb: "blocks" | "duplicates" | "relates to";
     /**
      * The Story ID of the subject Story.
      * @format int64
@@ -1976,7 +2346,7 @@ export interface HistoryActionStoryLinkCreate {
     object_id: number;
 }
 /** An action representing a Story Link being deleted. */
-export interface HistoryActionStoryLinkDelete {
+interface HistoryActionStoryLinkDelete {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -1985,9 +2355,9 @@ export interface HistoryActionStoryLinkDelete {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'delete';
+    action: "delete";
     /** The verb describing the link's relationship. */
-    verb: 'blocks' | 'duplicates' | 'relates to';
+    verb: "blocks" | "duplicates" | "relates to";
     /**
      * The Story ID of the subject Story.
      * @format int64
@@ -2000,7 +2370,7 @@ export interface HistoryActionStoryLinkDelete {
     object_id?: number | null;
 }
 /** An action representing a Story Link being updated. */
-export interface HistoryActionStoryLinkUpdate {
+interface HistoryActionStoryLinkUpdate {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -2009,9 +2379,9 @@ export interface HistoryActionStoryLinkUpdate {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'update';
+    action: "update";
     /** The verb describing the link's relationship. */
-    verb: 'blocks' | 'duplicates' | 'relates to';
+    verb: "blocks" | "duplicates" | "relates to";
     /**
      * The Story ID of the subject Story.
      * @format int64
@@ -2026,7 +2396,7 @@ export interface HistoryActionStoryLinkUpdate {
     changes: HistoryChangesStoryLink;
 }
 /** An action representing a Story being updated. */
-export interface HistoryActionStoryUpdate {
+interface HistoryActionStoryUpdate {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -2035,7 +2405,7 @@ export interface HistoryActionStoryUpdate {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'update';
+    action: "update";
     /**
      * The application URL of the Story.
      * @maxLength 2048
@@ -2047,10 +2417,10 @@ export interface HistoryActionStoryUpdate {
     /** The name of the Story. */
     name: string;
     /** The type of Story; either feature, bug, or chore. */
-    story_type: 'feature' | 'chore' | 'bug';
+    story_type: "feature" | "chore" | "bug";
 }
 /** An action representing a Task being created. */
-export interface HistoryActionTaskCreate {
+interface HistoryActionTaskCreate {
     /** The description of the Task. */
     description: string;
     /** The type of entity referenced. */
@@ -2067,14 +2437,14 @@ export interface HistoryActionTaskCreate {
      */
     id: number;
     /** The action of the entity referenced. */
-    action: 'create';
+    action: "create";
     /** Whether or not the Task is complete. */
     complete: boolean;
     /** A timestamp that represent's the Task's deadline. */
     deadline?: string;
 }
 /** An action representing a Task being deleted. */
-export interface HistoryActionTaskDelete {
+interface HistoryActionTaskDelete {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -2083,12 +2453,12 @@ export interface HistoryActionTaskDelete {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'delete';
+    action: "delete";
     /** The description of the Task being deleted. */
     description: string;
 }
 /** An action representing a Task being updated. */
-export interface HistoryActionTaskUpdate {
+interface HistoryActionTaskUpdate {
     /**
      * The ID of the entity referenced.
      * @format int64
@@ -2097,7 +2467,7 @@ export interface HistoryActionTaskUpdate {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'update';
+    action: "update";
     /** The changes that have occurred as a result of the action. */
     changes: HistoryChangesTask;
     /** Whether or not the Task is complete. */
@@ -2111,7 +2481,7 @@ export interface HistoryActionTaskUpdate {
     story_id: number;
 }
 /** An action representing a bulk operation within a workspace2. */
-export interface HistoryActionWorkspace2BulkUpdate {
+interface HistoryActionWorkspace2BulkUpdate {
     /**
      * The ID of the entity referenced.
      * @format uuid
@@ -2120,12 +2490,12 @@ export interface HistoryActionWorkspace2BulkUpdate {
     /** The type of entity referenced. */
     entity_type: string;
     /** The action of the entity referenced. */
-    action: 'bulk-update';
+    action: "bulk-update";
     /** The name of the workspace2 in which the BulkUpdate occurred. */
     name: string;
 }
 /** The changes that have occurred as a result of the action. */
-export interface HistoryChangesStory {
+interface HistoryChangesStory {
     /** A timestamp that represents the Story's deadline. */
     description?: StoryHistoryChangeOldNewStr;
     /** True if the Story has archived, otherwise false. */
@@ -2180,7 +2550,7 @@ export interface HistoryChangesStory {
     deadline?: StoryHistoryChangeOldNewStr;
 }
 /** The changes that have occurred as a result of the action. */
-export interface HistoryChangesStoryLink {
+interface HistoryChangesStoryLink {
     /** A timestamp that represents the Story's deadline. */
     verb?: StoryHistoryChangeOldNewStr;
     /** The estimate value for the Story */
@@ -2189,7 +2559,7 @@ export interface HistoryChangesStoryLink {
     subject_id?: StoryHistoryChangeOldNewInt;
 }
 /** The changes that have occurred as a result of the action. */
-export interface HistoryChangesTask {
+interface HistoryChangesTask {
     /** True if the Story has archived, otherwise false. */
     complete?: StoryHistoryChangeOldNewBool;
     /** A timestamp that represents the Story's deadline. */
@@ -2200,7 +2570,7 @@ export interface HistoryChangesTask {
     owner_ids?: StoryHistoryChangeAddsRemovesUuid;
 }
 /** A reference to a VCS Branch. */
-export interface HistoryReferenceBranch {
+interface HistoryReferenceBranch {
     /** The ID of the entity referenced. */
     id: number | string;
     /** The type of entity referenced. */
@@ -2215,7 +2585,7 @@ export interface HistoryReferenceBranch {
     url: string;
 }
 /** A reference to a VCS Commit. */
-export interface HistoryReferenceCommit {
+interface HistoryReferenceCommit {
     /** The ID of the entity referenced. */
     id: number | string;
     /** The type of entity referenced. */
@@ -2230,34 +2600,29 @@ export interface HistoryReferenceCommit {
     url: string;
 }
 /** A reference to a CustomField value asserted on a Story. */
-export interface HistoryReferenceCustomFieldEnumValue {
-    /** The type of entity referenced. */
-    entity_type: string;
-    /** The name as it is displayed to the user of the parent custom-field of this enum value. */
-    field_name: string;
-    /**
-     * The custom-field enum value as a string.
-     * @format int64
-     */
-    integer_value?: number | null;
-    /** Whether or not the custom-field is enabled. */
-    field_enabled: boolean;
+interface HistoryReferenceCustomFieldEnumValue {
     /** The ID of the entity referenced. */
     id: number | string;
-    /** The type variety of the parent custom-field of this enum value. */
-    field_type: string;
+    /** The type of entity referenced. */
+    entity_type: string;
+    /** The custom-field enum value as a string. */
+    string_value?: string | null;
+    /** Whether or not the custom-field enum value is enabled. */
+    enum_value_enabled?: boolean | null;
     /**
      * The public-id of the parent custom-field of this enum value.
      * @format uuid
      */
     field_id: string;
-    /** The custom-field enum value as a string. */
-    string_value?: string | null;
-    /** Whether or not the custom-field enum value is enabled. */
-    enum_value_enabled?: boolean | null;
+    /** The type variety of the parent custom-field of this enum value. */
+    field_type: string;
+    /** The name as it is displayed to the user of the parent custom-field of this enum value. */
+    field_name: string;
+    /** Whether or not the custom-field is enabled. */
+    field_enabled: boolean;
 }
 /** A reference to an Epic. */
-export interface HistoryReferenceEpic {
+interface HistoryReferenceEpic {
     /** The ID of the entity referenced. */
     id: number | string;
     /** The type of entity referenced. */
@@ -2272,7 +2637,7 @@ export interface HistoryReferenceEpic {
     name: string;
 }
 /** A default reference for entity types that don't have extra fields. */
-export interface HistoryReferenceGeneral {
+interface HistoryReferenceGeneral {
     /** The ID of the entity referenced. */
     id: number | string;
     /** The type of entity referenced. */
@@ -2281,7 +2646,7 @@ export interface HistoryReferenceGeneral {
     name: string;
 }
 /** A reference to a Group. */
-export interface HistoryReferenceGroup {
+interface HistoryReferenceGroup {
     /**
      * The ID of the entity referenced.
      * @format uuid
@@ -2293,7 +2658,7 @@ export interface HistoryReferenceGroup {
     name: string;
 }
 /** A reference to an Iteration. */
-export interface HistoryReferenceIteration {
+interface HistoryReferenceIteration {
     /** The ID of the entity referenced. */
     id: number | string;
     /** The type of entity referenced. */
@@ -2308,7 +2673,7 @@ export interface HistoryReferenceIteration {
     name: string;
 }
 /** A reference to an Label. */
-export interface HistoryReferenceLabel {
+interface HistoryReferenceLabel {
     /** The ID of the entity referenced. */
     id: number | string;
     /** The type of entity referenced. */
@@ -2323,7 +2688,7 @@ export interface HistoryReferenceLabel {
     name: string;
 }
 /** A reference to an Project. */
-export interface HistoryReferenceProject {
+interface HistoryReferenceProject {
     /** The ID of the entity referenced. */
     id: number | string;
     /** The type of entity referenced. */
@@ -2338,7 +2703,7 @@ export interface HistoryReferenceProject {
     name: string;
 }
 /** A reference to a Story. */
-export interface HistoryReferenceStory {
+interface HistoryReferenceStory {
     /** The ID of the entity referenced. */
     id: number | string;
     /** The type of entity referenced. */
@@ -2352,10 +2717,10 @@ export interface HistoryReferenceStory {
     /** The name of the entity referenced. */
     name: string;
     /** If the referenced entity is a Story, either "bug", "chore", or "feature". */
-    story_type: 'feature' | 'chore' | 'bug';
+    story_type: "feature" | "chore" | "bug";
 }
 /** A reference to a Story Task. */
-export interface HistoryReferenceStoryTask {
+interface HistoryReferenceStoryTask {
     /** The ID of the entity referenced. */
     id: number | string;
     /** The type of entity referenced. */
@@ -2364,18 +2729,18 @@ export interface HistoryReferenceStoryTask {
     description: string;
 }
 /** A references to a Story Workflow State. */
-export interface HistoryReferenceWorkflowState {
+interface HistoryReferenceWorkflowState {
     /** The ID of the entity referenced. */
     id: number | string;
     /** The type of entity referenced. */
     entity_type: string;
-    /** Either "unstarted", "started", or "done". */
-    type: 'started' | 'unstarted' | 'done';
+    /** Either "backlog", "unstarted", "started", or "done". */
+    type: "started" | "backlog" | "unstarted" | "done";
     /** The name of the entity referenced. */
     name: string;
 }
 /** Icons are used to attach images to Groups, Workspaces, Members, and Loading screens in the Shortcut web application. */
-export interface Icon {
+interface Icon {
     /** A string description of this resource. */
     entity_type: string;
     /**
@@ -2397,16 +2762,16 @@ export interface Icon {
     url: string;
 }
 /** The Identity of the VCS user that authored the Commit. */
-export interface Identity {
+interface Identity {
     /** A string description of this resource. */
     entity_type: string;
     /** This is your login in VCS. */
     name?: string | null;
     /** The service this Identity is for. */
-    type?: 'slack' | 'github' | 'gitlab' | 'bitbucket' | null;
+    type?: "slack" | "github" | "gitlab" | "bitbucket" | null;
 }
 /** An Iteration is a defined, time-boxed period of development for a collection of Stories. See https://help.shortcut.com/hc/en-us/articles/360028953452-Iterations-Overview for more information. */
-export interface Iteration {
+interface Iteration {
     /** The Shortcut application url for the Iteration. */
     app_url: string;
     /** The description of the iteration. */
@@ -2415,7 +2780,7 @@ export interface Iteration {
     entity_type: string;
     /** An array of labels attached to the iteration. */
     labels: Label[];
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /** An array of Member IDs that have been mentioned in the Story description. */
     member_mention_ids: string[];
@@ -2434,7 +2799,7 @@ export interface Iteration {
     /** An array of Group IDs that have been mentioned in the Story description. */
     group_mention_ids: string[];
     /**
-     * The date this iteration begins.
+     * The date this iteration ends.
      * @format date-time
      */
     end_date: string;
@@ -2462,7 +2827,7 @@ export interface Iteration {
      */
     created_at: string;
 }
-export interface IterationAssociatedGroup {
+interface IterationAssociatedGroup {
     /**
      * The Group ID of the associated group.
      * @format uuid
@@ -2475,7 +2840,7 @@ export interface IterationAssociatedGroup {
     associated_stories_count?: number;
 }
 /** The results of the Iteration search query. */
-export interface IterationSearchResults {
+interface IterationSearchResults {
     /**
      * The total number of matches for the search query. The first 1000 matches can be paged through via the API.
      * @format int64
@@ -2485,17 +2850,16 @@ export interface IterationSearchResults {
     data: IterationSlim[];
     /** The URL path and query string for the next page of search results. */
     next?: string | null;
-    cursors?: string[];
 }
 /** IterationSlim represents the same resource as an Iteration, but is more light-weight. Use the [Get Iteration](#Get-Iteration) endpoint to fetch the unabridged payload for an Iteration.  */
-export interface IterationSlim {
+interface IterationSlim {
     /** The Shortcut application url for the Iteration. */
     app_url: string;
     /** A string description of this resource */
     entity_type: string;
     /** An array of labels attached to the iteration. */
     labels: Label[];
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /** An array of Member IDs that have been mentioned in the Story description. */
     member_mention_ids: string[];
@@ -2514,7 +2878,7 @@ export interface IterationSlim {
     /** An array of Group IDs that have been mentioned in the Story description. */
     group_mention_ids: string[];
     /**
-     * The date this iteration begins.
+     * The date this iteration ends.
      * @format date-time
      */
     end_date: string;
@@ -2543,7 +2907,7 @@ export interface IterationSlim {
     created_at: string;
 }
 /** A group of calculated values for this Iteration. */
-export interface IterationStats {
+interface IterationStats {
     /**
      * The total number of completed points in this Iteration.
      * @format int64
@@ -2610,8 +2974,42 @@ export interface IterationStats {
      */
     num_stories_done: number;
 }
+interface KeyResult {
+    /**
+     * The ID of the Key Result.
+     * @format uuid
+     */
+    id: string;
+    /** The name of the Key Result. */
+    name: string;
+    /**
+     * The Objective to which this Key Result belongs.
+     * @format int64
+     */
+    objective_id: number;
+    /** The type of the Key Result (numeric, percent, or boolean). */
+    type: "percent" | "boolean" | "numeric";
+    /** The starting value of the Key Result. */
+    initial_observed_value: KeyResultValue;
+    /** The starting value of the Key Result. */
+    current_observed_value: KeyResultValue;
+    /** The starting value of the Key Result. */
+    current_target_value: KeyResultValue;
+    /**
+     * The integer percentage of progress toward completion of the Key Result.
+     * @format int64
+     */
+    progress: number;
+}
+/** The starting value of the Key Result. */
+interface KeyResultValue {
+    /** The numeric value, as a decimal string. No more than two decimal places are allowed. */
+    numeric_value?: string;
+    /** The boolean value. */
+    boolean_value?: boolean;
+}
 /** A Label can be used to associate and filter Stories and Epics, and also create new Workspaces. */
-export interface Label {
+interface Label {
     /** The Shortcut application url for the Label. */
     app_url: string;
     /** The description of the Label. */
@@ -2651,7 +3049,7 @@ export interface Label {
     created_at?: string | null;
 }
 /** A Label can be used to associate and filter Stories and Epics, and also create new Workspaces. A slim Label does not include aggregate stats. Fetch the Label using the labels endpoint to retrieve them. */
-export interface LabelSlim {
+interface LabelSlim {
     /** The Shortcut application url for the Label. */
     app_url: string;
     /** The description of the Label. */
@@ -2689,7 +3087,7 @@ export interface LabelSlim {
     created_at?: string | null;
 }
 /** A group of calculated values for this Label. This is not included if the slim? flag is set to true for the List Labels endpoint. */
-export interface LabelStats {
+interface LabelStats {
     /**
      * The total number of Documents associated this Label.
      * @format int64
@@ -2776,15 +3174,22 @@ export interface LabelStats {
      */
     num_epics_completed: number;
 }
+interface LinkSubTaskParams {
+    /**
+     * The ID of the story to link as a sub-task of the parent story
+     * @format int64
+     */
+    story_id: number;
+}
 /** Linked files are stored on a third-party website and linked to one or more Stories. Shortcut currently supports linking files from Google Drive, Dropbox, Box, and by URL. */
-export interface LinkedFile {
+interface LinkedFile {
     /** The description of the file. */
     description?: string | null;
     /** A string description of this resource. */
     entity_type: string;
     /** The IDs of the stories this file is attached to. */
     story_ids: number[];
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /** The members that are mentioned in the description of the file. */
     member_mention_ids: string[];
@@ -2826,47 +3231,20 @@ export interface LinkedFile {
      */
     created_at: string;
 }
-export interface ListEpics {
-    /** A true/false boolean indicating whether to return Epics with their descriptions. */
-    includes_description?: boolean;
-}
-export interface ListGroupStories {
-    /**
-     * The maximum number of results to return. (Defaults to 1000, max 1000)
-     * @format int64
-     */
-    limit?: number;
-    /**
-     * The offset at which to begin returning results. (Defaults to 0)
-     * @format int64
-     */
-    offset?: number;
-}
-export interface ListLabels {
-    /** A true/false boolean indicating if the slim versions of the Label should be returned. */
-    slim?: boolean;
-}
-export interface ListMembers {
-    /**
-     * The unique ID of the Organization to limit the list to.
-     * @format uuid
-     */
-    'org-public-id'?: string;
-}
 /** Error returned when total maximum supported results have been reached. */
-export interface MaxSearchResultsExceededError {
+interface MaxSearchResultsExceededError {
     /** The name for this type of error, `maximum-results-exceeded` */
-    error: 'maximum-results-exceeded';
+    error: "maximum-results-exceeded";
     /** An explanatory message: "A maximum of 1000 search results are supported." */
     message: string;
     /**
      * The maximum number of search results supported, `1000`
      * @format int64
      */
-    'maximum-results': 1000;
+    "maximum-results": 1000;
 }
 /** Details about an individual user within the Workspace. */
-export interface Member {
+interface Member {
     /** The Member's role in the Workspace. */
     role: string;
     /** A string description of this resource. */
@@ -2875,7 +3253,7 @@ export interface Member {
     disabled: boolean;
     global_id: string;
     /** The user state, one of partial, full, disabled, or imported.  A partial user is disabled, has no means to log in, and is not an import user.  A full user is enabled and has a means to log in.  A disabled user is disabled and has a means to log in.  An import user is disabled, has no means to log in, and is marked as an import user. */
-    state: 'partial' | 'full' | 'disabled' | 'imported';
+    state: "partial" | "full" | "disabled" | "imported";
     /**
      * The time/date the Member was last updated.
      * @format date-time
@@ -2903,15 +3281,17 @@ export interface Member {
      */
     replaced_by?: string;
 }
-export interface MemberInfo {
+interface MemberInfo {
     /** @format uuid */
     id: string;
-    name: string;
+    is_owner: boolean;
     mention_name: string;
+    name: string;
+    role: string;
     workspace2: BasicWorkspaceInfo;
 }
-/** A Milestone is a collection of Epics that represent a release or some other large initiative that you are working on. */
-export interface Milestone {
+/** (Deprecated) A Milestone is a collection of Epics that represent a release or some other large initiative that you are working on. Milestones have become Objectives, so you should use Objective-related API resources instead of Milestone ones. */
+interface Milestone {
     /** The Shortcut application url for the Milestone. */
     app_url: string;
     /** The Milestone's description. */
@@ -2961,6 +3341,8 @@ export interface Milestone {
      * @format int64
      */
     id: number;
+    /** The IDs of the Key Results associated with the Objective. */
+    key_result_ids: string[];
     /**
      * A number representing the position of the Milestone in relation to every other Milestone within the Workspace.
      * @format int64
@@ -2974,8 +3356,92 @@ export interface Milestone {
      */
     created_at: string;
 }
+/** A group of calculated values for this Milestone. */
+interface MilestoneStats {
+    /**
+     * The average cycle time (in seconds) of completed stories in this Milestone.
+     * @format int64
+     */
+    average_cycle_time?: number;
+    /**
+     * The average lead time (in seconds) of completed stories in this Milestone.
+     * @format int64
+     */
+    average_lead_time?: number;
+    /**
+     * The number of related documents to this Milestone.
+     * @format int64
+     */
+    num_related_documents: number;
+}
+/** An Objective is a collection of Epics that represent a release or some other large initiative that you are working on. */
+interface Objective {
+    /** The Shortcut application url for the Objective. */
+    app_url: string;
+    /** The Objective's description. */
+    description: string;
+    /** A boolean indicating whether the Objective has been archived or not. */
+    archived: boolean;
+    /** A true/false boolean indicating if the Objective has been started. */
+    started: boolean;
+    /** A string description of this resource. */
+    entity_type: string;
+    /**
+     * A manual override for the time/date the Objective was completed.
+     * @format date-time
+     */
+    completed_at_override?: string | null;
+    /**
+     * The time/date the Objective was started.
+     * @format date-time
+     */
+    started_at?: string | null;
+    /**
+     * The time/date the Objective was completed.
+     * @format date-time
+     */
+    completed_at?: string | null;
+    /** The name of the Objective. */
+    name: string;
+    global_id: string;
+    /** A true/false boolean indicating if the Objectivehas been completed. */
+    completed: boolean;
+    /** The workflow state that the Objective is in. */
+    state: string;
+    /**
+     * A manual override for the time/date the Objective was started.
+     * @format date-time
+     */
+    started_at_override?: string | null;
+    /**
+     * The time/date the Objective was updated.
+     * @format date-time
+     */
+    updated_at: string;
+    /** An array of Categories attached to the Objective. */
+    categories: Category[];
+    /**
+     * The unique ID of the Objective.
+     * @format int64
+     */
+    id: number;
+    /** The IDs of the Key Results associated with the Objective. */
+    key_result_ids: string[];
+    /**
+     * A number representing the position of the Objective in relation to every other Objective within the Workspace.
+     * @format int64
+     */
+    position: number;
+    /** A group of calculated values for this Objective. */
+    stats: ObjectiveStats;
+    /**
+     * The time/date the Objective was created.
+     * @format date-time
+     */
+    created_at: string;
+}
 /** A Milestone in search results. This is typed differently from Milestone because the details=slim search argument will omit some fields. */
-export interface MilestoneSearchResult {
+interface ObjectiveSearchResult {
     /** The Shortcut application url for the Milestone. */
     app_url: string;
     /** The Milestone's description. */
@@ -3025,6 +3491,8 @@ export interface MilestoneSearchResult {
      * @format int64
      */
     id: number;
+    /** The IDs of the Key Results associated with the Objective. */
+    key_result_ids: string[];
     /**
      * A number representing the position of the Milestone in relation to every other Milestone within the Workspace.
      * @format int64
@@ -3038,39 +3506,38 @@ export interface MilestoneSearchResult {
      */
     created_at: string;
 }
-/** The results of the Milestone search query. */
-export interface MilestoneSearchResults {
+/** The results of the Objective search query. */
+interface ObjectiveSearchResults {
     /**
      * The total number of matches for the search query. The first 1000 matches can be paged through via the API.
      * @format int64
      */
     total: number;
     /** A list of search results. */
-    data: MilestoneSearchResult[];
+    data: ObjectiveSearchResult[];
     /** The URL path and query string for the next page of search results. */
     next?: string | null;
-    cursors?: string[];
 }
-/** A group of calculated values for this Milestone. */
-export interface MilestoneStats {
+/** A group of calculated values for this Objective. */
+interface ObjectiveStats {
     /**
-     * The average cycle time (in seconds) of completed stories in this Milestone.
+     * The average cycle time (in seconds) of completed stories in this Objective.
      * @format int64
      */
     average_cycle_time?: number;
     /**
-     * The average lead time (in seconds) of completed stories in this Milestone.
+     * The average lead time (in seconds) of completed stories in this Objective.
      * @format int64
      */
     average_lead_time?: number;
     /**
-     * The number of related documents tp this Milestone.
+     * The number of related documents to this Objective.
      * @format int64
      */
     num_related_documents: number;
 }
 /** A group of Member profile details. */
-export interface Profile {
+interface Profile {
     /** A string description of this resource. */
     entity_type: string;
     /** A true/false boolean indicating whether the Member has been deactivated within Shortcut. */
@@ -3081,6 +3548,8 @@ export interface Profile {
     mention_name: string;
     /** The Member's name within the Organization. */
     name?: string | null;
+    /** Whether this profile is an Agent/Bot user. */
+    is_agent?: boolean;
     /** This is the gravatar hash associated with email_address. */
     gravatar_hash?: string | null;
     /**
@@ -3096,7 +3565,7 @@ export interface Profile {
     email_address?: string | null;
 }
 /** Projects typically map to teams (such as Frontend, Backend, Mobile, Devops, etc) but can represent any open-ended product, component, or initiative. */
-export interface Project {
+interface Project {
     /** The Shortcut application url for the Project. */
     app_url: string;
     /** The description of the Project. */
@@ -3168,7 +3637,7 @@ export interface Project {
     created_at?: string | null;
 }
 /** A group of calculated values for this Project. */
-export interface ProjectStats {
+interface ProjectStats {
     /**
      * The total number of stories in this Project.
      * @format int64
@@ -3186,7 +3655,7 @@ export interface ProjectStats {
     num_related_documents: number;
 }
 /** Corresponds to a VCS Pull Request attached to a Shortcut story. */
-export interface PullRequest {
+interface PullRequest {
     /** A string description of this resource. */
     entity_type: string;
     /** True/False boolean indicating whether the VCS pull request has been closed. */
@@ -3270,7 +3739,7 @@ export interface PullRequest {
     created_at: string;
 }
 /** Corresponds to a VCS Label associated with a Pull Request. */
-export interface PullRequestLabel {
+interface PullRequestLabel {
     /** A string description of this resource. */
     entity_type: string;
     /**
@@ -3290,14 +3759,30 @@ export interface PullRequestLabel {
     /** The name of the VCS label. */
     name: string;
 }
+interface RemoveCustomFieldParams {
+    /**
+     * The unique public ID for the CustomField.
+     * @format uuid
+     */
+    field_id: string;
+}
+/** Request parameters for removing a Label from a Shortcut Story. */
+interface RemoveLabelParams {
+    /**
+     * The name of the new Label to remove.
+     * @minLength 1
+     * @maxLength 128
+     */
+    name: string;
+}
 /** Repository refers to a VCS repository. */
-export interface Repository {
+interface Repository {
     /** A string description of this resource. */
     entity_type: string;
     /** The shorthand name of the VCS repository. */
     name?: string | null;
     /** The VCS provider for the Repository. */
-    type: 'github' | 'gitlab' | 'bitbucket';
+    type: "github" | "gitlab" | "bitbucket";
     /**
      * The time/date the Repository was updated.
      * @format date-time
@@ -3320,44 +3805,18 @@ export interface Repository {
      */
     created_at?: string | null;
 }
-export interface Search {
-    /**
-     * See our help center article on [search operators](https://help.shortcut.com/hc/en-us/articles/360000046646-Search-Operators)
-     * @minLength 1
-     */
-    query: string;
-    /**
-     * The number of search results to include in a page. Minimum of 1 and maximum of 25.
-     * @format int64
-     */
-    page_size?: number;
-    /**
-     * The amount of detail included in each result item.
-     *    "full" will include all descriptions and comments and more fields on
-     *    related items such as pull requests, branches and tasks.
-     *    "slim" omits larger fulltext fields such as descriptions and comments
-     *    and only references related items by id.
-     *    The default is "full".
-     */
-    detail?: 'full' | 'slim';
-    /** The next page token. */
-    next?: string;
-    include?: 'cursors';
-    /** A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, milestone, story. */
-    entity_types?: ('story' | 'milestone' | 'epic' | 'iteration')[];
-}
 /** The results of the multi-entity search query. */
-export interface SearchResults {
+interface SearchResults {
     /** The results of the Epic search query. */
     epics?: EpicSearchResults;
     /** The results of the Story search query. */
     stories?: StorySearchResults;
     /** The results of the Iteration search query. */
     iterations?: IterationSearchResults;
-    /** The results of the Milestone search query. */
-    milestones?: MilestoneSearchResults;
+    /** The results of the Objective search query. */
+    milestones?: ObjectiveSearchResults;
 }
-export interface SearchStories {
+interface SearchStories {
     /** A true/false boolean indicating whether the Story is in archived state. */
     archived?: boolean;
     /**
@@ -3366,7 +3825,7 @@ export interface SearchStories {
      */
     owner_id?: string | null;
     /** The type of Stories that you want returned. */
-    story_type?: 'feature' | 'chore' | 'bug';
+    story_type?: "feature" | "chore" | "bug";
     /**
      * The Epic IDs that may be associated with the Stories.
      * @uniqueItems true
@@ -3378,24 +3837,24 @@ export interface SearchStories {
      */
     project_ids?: (number | null)[];
     /**
-     * Stories should have been updated before this date.
+     * Stories should have been updated on or before this date.
      * @format date-time
      */
     updated_at_end?: string;
     /**
-     * Stories should have been completed before this date.
+     * Stories should have been completed on or before this date.
      * @format date-time
      */
     completed_at_end?: string;
     /** The type of Workflow State the Stories may be in. */
-    workflow_state_types?: ('started' | 'backlog' | 'unstarted' | 'done')[];
+    workflow_state_types?: ("started" | "backlog" | "unstarted" | "done")[];
     /**
-     * Stories should have a deadline before this date.
+     * Stories should have a deadline on or before this date.
      * @format date-time
      */
     deadline_end?: string;
     /**
-     * Stories should have been created after this date.
+     * Stories should have been created on or after this date.
      * @format date-time
      */
     created_at_start?: string;
@@ -3440,12 +3899,12 @@ export interface SearchStories {
      */
     iteration_ids?: number[];
     /**
-     * Stories should have been created before this date.
+     * Stories should have been created on or before this date.
      * @format date-time
      */
     created_at_end?: string;
     /**
-     * Stories should have a deadline after this date.
+     * Stories should have a deadline on or after this date.
      * @format date-time
      */
     deadline_start?: string;
@@ -3459,7 +3918,10 @@ export interface SearchStories {
      * @uniqueItems true
      */
     owner_ids?: string[];
-    /** An ID or URL that references an external resource. Useful during imports. */
+    /**
+     * An ID or URL that references an external resource. Useful during imports.
+     * @maxLength 1024
+     */
     external_id?: string;
     /** Whether to include the story description in the response. */
     includes_description?: boolean;
@@ -3474,18 +3936,18 @@ export interface SearchStories {
      */
     project_id?: number | null;
     /**
-     * Stories should have been completed after this date.
+     * Stories should have been completed on or after this date.
      * @format date-time
      */
     completed_at_start?: string;
     /**
-     * Stories should have been updated after this date.
+     * Stories should have been updated on or after this date.
      * @format date-time
      */
     updated_at_start?: string;
 }
 /** Stories are the standard unit of work in Shortcut and represent individual features, bugs, and chores. */
-export interface Story {
+interface Story {
     /** The Shortcut application url for the Story. */
     app_url: string;
     /** The description of the story. */
@@ -3500,7 +3962,7 @@ export interface Story {
     entity_type: string;
     /** An array of labels attached to the story. */
     labels: LabelSlim[];
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /** The synced item for the story. */
     synced_item?: SyncedItem;
@@ -3548,8 +4010,6 @@ export interface Story {
      * @format int64
      */
     epic_id?: number | null;
-    /** The IDs of any unresolved blocker comments on the Story. */
-    unresolved_blocker_comments?: number[];
     /**
      * The ID of the story template used to create this story, or null if not created using a template.
      * @format uuid
@@ -3569,8 +4029,11 @@ export interface Story {
      * @format int64
      */
     iteration_id?: number | null;
+    sub_task_story_ids?: number[];
     /** An array of tasks connected to the story. */
     tasks: Task[];
+    /** The formatted branch name for this story. */
+    formatted_vcs_branch_name?: string | null;
     /** An array of label ids attached to the story. */
     label_ids: number[];
     /**
@@ -3613,6 +4076,8 @@ export interface Story {
      * @format int64
      */
     lead_time?: number;
+    /** @format int64 */
+    parent_story_id?: number | null;
     /**
      * The numeric point estimate of the story. Can also be null, which means unestimated.
      * @format int64
@@ -3658,7 +4123,7 @@ export interface Story {
     moved_at?: string | null;
 }
 /** A Comment is any note added within the Comment field of a Story. */
-export interface StoryComment {
+interface StoryComment {
     /** The Shortcut application url for the Comment. */
     app_url: string;
     /** A string description of this resource. */
@@ -3670,7 +4135,7 @@ export interface StoryComment {
      * @format int64
      */
     story_id: number;
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /**
      * The unique ID of the Member who is the Comment's author.
@@ -3681,6 +4146,8 @@ export interface StoryComment {
     member_mention_ids: string[];
     /** Marks the comment as a blocker that can be surfaced to permissions or teams mentioned in the comment. Can only be used on a top-level comment. */
     blocker?: boolean;
+    /** Whether the Comment is currently the root of a thread that is linked to Slack. */
+    linked_to_slack: boolean;
     /**
      * The time/date when the Comment was updated.
      * @format date-time
@@ -3718,7 +4185,7 @@ export interface StoryComment {
     text?: string | null;
 }
 /** A container entity for the attributes this template should populate. */
-export interface StoryContents {
+interface StoryContents {
     /** The description of the story. */
     description?: string;
     /** A string description of this resource. */
@@ -3740,6 +4207,8 @@ export interface StoryContents {
     epic_id?: number;
     /** An array of external links connected to the story. */
     external_links?: string[];
+    /** An array of sub-tasks connected to the story */
+    sub_tasks?: CreateSubTaskParams[];
     /**
      * The ID of the iteration the story belongs to.
      * @format int64
@@ -3781,7 +4250,7 @@ export interface StoryContents {
      */
     deadline?: string;
 }
-export interface StoryContentsTask {
+interface StoryContentsTask {
     /** Full text of the Task. */
     description: string;
     /**
@@ -3796,7 +4265,7 @@ export interface StoryContentsTask {
     /** This field can be set to another unique ID. In the case that the Task has been imported from another tool, the ID in the other tool can be indicated here. */
     external_id?: string | null;
 }
-export interface StoryCustomField {
+interface StoryCustomField {
     /**
      * The unique public ID for a CustomField.
      * @format uuid
@@ -3811,28 +4280,28 @@ export interface StoryCustomField {
     value: string;
 }
 /** Task IDs that have been added or removed from the Story. */
-export interface StoryHistoryChangeAddsRemovesInt {
+interface StoryHistoryChangeAddsRemovesInt {
     /** The values that have been added. */
     adds?: number[];
     /** The values that have been removed */
     removes?: number[];
 }
 /** Custom Field Enum Value IDs that have been added or removed from the Story. */
-export interface StoryHistoryChangeAddsRemovesUuid {
+interface StoryHistoryChangeAddsRemovesUuid {
     /** The values that have been added. */
     adds?: string[];
     /** The values that have been removed */
     removes?: string[];
 }
 /** True if the Story has archived, otherwise false. */
-export interface StoryHistoryChangeOldNewBool {
+interface StoryHistoryChangeOldNewBool {
     /** The old value. */
     old?: boolean;
     /** The new value. */
     new?: boolean;
 }
 /** The estimate value for the Story */
-export interface StoryHistoryChangeOldNewInt {
+interface StoryHistoryChangeOldNewInt {
     /**
      * The old value.
      * @format int64
@@ -3845,14 +4314,14 @@ export interface StoryHistoryChangeOldNewInt {
     new?: number;
 }
 /** A timestamp that represents the Story's deadline. */
-export interface StoryHistoryChangeOldNewStr {
+interface StoryHistoryChangeOldNewStr {
     /** The old value. */
     old?: string | null;
     /** The new value. */
     new?: string;
 }
 /** The Team ID for the Story. */
-export interface StoryHistoryChangeOldNewUuid {
+interface StoryHistoryChangeOldNewUuid {
     /**
      * The old value.
      * @format uuid
@@ -3865,7 +4334,7 @@ export interface StoryHistoryChangeOldNewUuid {
     new?: string;
 }
 /** Story links allow you create semantic relationships between two stories. Relationship types are relates to, blocks / blocked by, and duplicates / is duplicated by. The format is `subject -> link -> object`, or for example "story 5 blocks story 6". */
-export interface StoryLink {
+interface StoryLink {
     /** A string description of this resource. */
     entity_type: string;
     /**
@@ -3902,14 +4371,14 @@ export interface StoryLink {
     updated_at: string;
 }
 /** Emoji reaction on a comment. */
-export interface StoryReaction {
+interface StoryReaction {
     /** Emoji text of the reaction. */
     emoji: string;
     /** Permissions who have reacted with this. */
     permission_ids: string[];
 }
 /** A Story in search results. This is typed differently from Story because the details=slim search argument will omit some fields. */
-export interface StorySearchResult {
+interface StorySearchResult {
     /** The Shortcut application url for the Story. */
     app_url: string;
     /** The description of the story. */
@@ -3926,7 +4395,7 @@ export interface StorySearchResult {
     labels: LabelSlim[];
     /** An array of IDs of Tasks attached to the story. */
     task_ids?: number[];
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /** The synced item for the story. */
     synced_item?: SyncedItem;
@@ -3981,8 +4450,6 @@ export interface StorySearchResult {
      * @format int64
      */
     epic_id?: number | null;
-    /** The IDs of any unresolved blocker comments on the Story. */
-    unresolved_blocker_comments?: number[];
     /**
      * The ID of the story template used to create this story, or null if not created using a template.
      * @format uuid
@@ -4002,8 +4469,11 @@ export interface StorySearchResult {
      * @format int64
      */
     iteration_id?: number | null;
+    sub_task_story_ids?: number[];
     /** An array of tasks connected to the story. */
     tasks?: Task[];
+    /** The formatted branch name for this story. */
+    formatted_vcs_branch_name?: string | null;
     /** An array of label ids attached to the story. */
     label_ids: number[];
     /**
@@ -4046,6 +4516,8 @@ export interface StorySearchResult {
      * @format int64
      */
     lead_time?: number;
+    /** @format int64 */
+    parent_story_id?: number | null;
     /**
      * The numeric point estimate of the story. Can also be null, which means unestimated.
      * @format int64
@@ -4095,7 +4567,7 @@ export interface StorySearchResult {
     moved_at?: string | null;
 }
 /** The results of the Story search query. */
-export interface StorySearchResults {
+interface StorySearchResults {
     /**
      * The total number of matches for the search query. The first 1000 matches can be paged through via the API.
      * @format int64
@@ -4105,10 +4577,9 @@ export interface StorySearchResults {
     data: StorySearchResult[];
     /** The URL path and query string for the next page of search results. */
     next?: string | null;
-    cursors?: string[];
 }
 /** StorySlim represents the same resource as a Story, but is more light-weight. For certain fields it provides ids rather than full resources (e.g., `comment_ids` and `file_ids`) and it also excludes certain aggregate values (e.g., `cycle_time`). The `description` field can be optionally included. Use the [Get Story](#Get-Story) endpoint to fetch the unabridged payload for a Story. */
-export interface StorySlim {
+interface StorySlim {
     /** The Shortcut application url for the Story. */
     app_url: string;
     /** The description of the Story. */
@@ -4125,7 +4596,7 @@ export interface StorySlim {
     labels: LabelSlim[];
     /** An array of IDs of Tasks attached to the story. */
     task_ids: number[];
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /** The synced item for the story. */
     synced_item?: SyncedItem;
@@ -4174,8 +4645,6 @@ export interface StorySlim {
      * @format int64
      */
     epic_id?: number | null;
-    /** The IDs of any unresolved blocker comments on the Story. */
-    unresolved_blocker_comments?: number[];
     /**
      * The ID of the story template used to create this story, or null if not created using a template.
      * @format uuid
@@ -4195,6 +4664,9 @@ export interface StorySlim {
      * @format int64
      */
     iteration_id?: number | null;
+    sub_task_story_ids?: number[];
+    /** The formatted branch name for this story. */
+    formatted_vcs_branch_name?: string | null;
     /** An array of label ids attached to the story. */
     label_ids: number[];
     /**
@@ -4235,6 +4707,8 @@ export interface StorySlim {
      * @format int64
      */
     lead_time?: number;
+    /** @format int64 */
+    parent_story_id?: number | null;
     /**
      * The numeric point estimate of the story. Can also be null, which means unestimated.
      * @format int64
@@ -4280,7 +4754,7 @@ export interface StorySlim {
     moved_at?: string | null;
 }
 /** The stats object for Stories */
-export interface StoryStats {
+interface StoryStats {
     /**
      * The number of documents related to this Story.
      * @format int64
@@ -4288,14 +4762,14 @@ export interface StoryStats {
     num_related_documents: number;
 }
 /** The synced item for the story. */
-export interface SyncedItem {
+interface SyncedItem {
     /** The id used to reference an external entity. */
     external_id: string;
     /** The url to the external entity. */
     url: string;
 }
 /** A Task on a Story. */
-export interface Task {
+interface Task {
     /** Full text of the Task. */
     description: string;
     /** A string description of this resource. */
@@ -4305,7 +4779,7 @@ export interface Task {
      * @format int64
      */
     story_id: number;
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /** An array of UUIDs of Members mentioned in this Task. */
     member_mention_ids: string[];
@@ -4314,6 +4788,7 @@ export interface Task {
      * @format date-time
      */
     completed_at?: string | null;
+    global_id: string;
     /**
      * The time/date the Task was updated.
      * @format date-time
@@ -4344,14 +4819,14 @@ export interface Task {
     created_at: string;
 }
 /** Comments associated with Epic Discussions. */
-export interface ThreadedComment {
+interface ThreadedComment {
     /** The Shortcut application url for the Comment. */
     app_url: string;
     /** A string description of this resource. */
     entity_type: string;
     /** True/false boolean indicating whether the Comment is deleted. */
     deleted: boolean;
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /**
      * The unique ID of the Member that authored the Comment.
@@ -4385,7 +4860,7 @@ export interface ThreadedComment {
     text: string;
 }
 /** The type of Story Link. The string can be subject or object.  */
-export interface TypedStoryLink {
+interface TypedStoryLink {
     /** A string description of this resource. */
     entity_type: string;
     /**
@@ -4423,9 +4898,9 @@ export interface TypedStoryLink {
      */
     created_at: string;
 }
-export interface UnusableEntitlementError {
+interface UnusableEntitlementError {
     /** The tag for violating an entitlement action. */
-    reason_tag: 'entitlement-violation';
+    reason_tag: "entitlement-violation";
     /**
      * Short tag describing the unusable entitlement action taken by the user.
      * @minLength 1
@@ -4439,7 +4914,7 @@ export interface UnusableEntitlementError {
      */
     message: string;
 }
-export interface UpdateCategory {
+interface UpdateCategory {
     /**
      * The new name of the Category.
      * @minLength 1
@@ -4455,11 +4930,11 @@ export interface UpdateCategory {
     /** A true/false boolean indicating if the Category has been archived. */
     archived?: boolean;
 }
-export interface UpdateComment {
+interface UpdateComment {
     /** The updated comment text. */
     text: string;
 }
-export interface UpdateCustomField {
+interface UpdateCustomField {
     /** Indicates whether the Field is enabled for the Workspace. Only enabled fields can be applied to Stories. */
     enabled?: boolean;
     /**
@@ -4489,7 +4964,7 @@ export interface UpdateCustomField {
      */
     after_id?: string;
 }
-export interface UpdateCustomFieldEnumValue {
+interface UpdateCustomFieldEnumValue {
     /**
      * The unique ID of an existing EnumValue within the CustomField's domain.
      * @format uuid
@@ -4510,16 +4985,17 @@ export interface UpdateCustomFieldEnumValue {
  * Request parameters for changing either a template's name or any of
  *   the attributes it is designed to pre-populate.
  */
-export interface UpdateEntityTemplate {
+interface UpdateEntityTemplate {
     /**
      * The updated template name.
      * @minLength 1
+     * @maxLength 128
      */
     name?: string;
     /** Updated attributes for the template to populate. */
     story_contents?: UpdateStoryContents;
 }
-export interface UpdateEpic {
+interface UpdateEpic {
     /**
      * The Epic's description.
      * @maxLength 100000
@@ -4534,6 +5010,8 @@ export interface UpdateEpic {
      * @format date-time
      */
     completed_at_override?: string | null;
+    /** An array of IDs for Objectives to which this Epic is related. */
+    objective_ids?: number[];
     /**
      * The Epic's name.
      * @minLength 1
@@ -4546,9 +5024,9 @@ export interface UpdateEpic {
      */
     planned_start_date?: string | null;
     /** `Deprecated` The Epic's state (to do, in progress, or done); will be ignored when `epic_state_id` is set. */
-    state?: 'in progress' | 'to do' | 'done';
+    state?: "in progress" | "to do" | "done";
     /**
-     * The ID of the Milestone this Epic is related to.
+     * `Deprecated` The ID of the Milestone this Epic is related to. Use `objective_ids`.
      * @format int64
      */
     milestone_id?: number | null;
@@ -4568,15 +5046,20 @@ export interface UpdateEpic {
      */
     started_at_override?: string | null;
     /**
-     * The ID of the group to associate with the epic.
+     * `Deprecated` The ID of the group to associate with the epic. Use `group_ids`.
      * @format uuid
      */
     group_id?: string | null;
     /** An array of UUIDs for any Members you want to add as Followers on this Epic. */
     follower_ids?: string[];
+    /** An array of UUIDS for Groups to which this Epic is related. */
+    group_ids?: string[];
     /** An array of UUIDs for any members you want to add as Owners on this Epic. */
     owner_ids?: string[];
-    /** This field can be set to another unique ID. In the case that the Epic has been imported from another tool, the ID in the other tool can be indicated here. */
+    /**
+     * This field can be set to another unique ID. In the case that the Epic has been imported from another tool, the ID in the other tool can be indicated here.
+     * @maxLength 128
+     */
     external_id?: string;
     /**
      * The ID of the Epic we want to move this Epic before.
@@ -4594,8 +5077,11 @@ export interface UpdateEpic {
      */
     deadline?: string | null;
 }
-export interface UpdateFile {
-    /** The description of the file. */
+interface UpdateFile {
+    /**
+     * The description of the file.
+     * @maxLength 4096
+     */
     description?: string;
     /**
      * The time/date that the file was uploaded.
@@ -4618,11 +5104,17 @@ export interface UpdateFile {
      * @format uuid
      */
     uploader_id?: string;
-    /** An additional ID that you may wish to assign to the file. */
+    /**
+     * An additional ID that you may wish to assign to the file.
+     * @maxLength 128
+     */
     external_id?: string;
 }
-export interface UpdateGroup {
-    /** The description of this Group. */
+interface UpdateGroup {
+    /**
+     * The description of this Group.
+     * @maxLength 4096
+     */
     description?: string;
     /** Whether or not this Group is archived. */
     archived?: boolean | null;
@@ -4651,7 +5143,12 @@ export interface UpdateGroup {
      */
     name?: string;
     /** The color key you wish to use for the Group in the system. */
-    color_key?: 'blue' | 'purple' | 'midnight-blue' | 'orange' | 'yellow-green' | 'brass' | 'gray' | 'fuchsia' | 'yellow' | 'pink' | 'sky-blue' | 'green' | 'red' | 'black' | 'slate' | 'turquoise';
+    color_key?: "blue" | "purple" | "midnight-blue" | "orange" | "yellow-green" | "brass" | "gray" | "fuchsia" | "yellow" | "pink" | "sky-blue" | "green" | "red" | "black" | "slate" | "turquoise";
+    /**
+     * The ID of the default workflow for stories created in this group.
+     * @format int64
+     */
+    default_workflow_id?: number | null;
     /**
      * The Member ids to add to this Group.
      * @uniqueItems true
@@ -4660,7 +5157,13 @@ export interface UpdateGroup {
     /** The Workflow ids to add to the Group. */
     workflow_ids?: number[];
 }
-export interface UpdateIteration {
+interface UpdateHealth {
+    /** The health status of the Epic. */
+    status?: "At Risk" | "On Track" | "Off Track" | "No Health";
+    /** The description of the Health status. */
+    text?: string;
+}
+interface UpdateIteration {
     /** An array of UUIDs for any Members you want to add as Followers. */
     follower_ids?: string[];
     /** An array of UUIDs for any Groups you want to add as Followers. Currently, only one Group association is presented in our web UI. */
@@ -4689,14 +5192,30 @@ export interface UpdateIteration {
      */
     end_date?: string;
 }
-export interface UpdateLabel {
+interface UpdateKeyResult {
+    /**
+     * The name of the Key Result.
+     * @maxLength 1024
+     */
+    name?: string;
+    /** The starting value of the Key Result. */
+    initial_observed_value?: KeyResultValue;
+    /** The starting value of the Key Result. */
+    observed_value?: KeyResultValue;
+    /** The starting value of the Key Result. */
+    target_value?: KeyResultValue;
+}
+interface UpdateLabel {
     /**
      * The new name of the label.
      * @minLength 1
      * @maxLength 128
      */
     name?: string;
-    /** The new description of the label. */
+    /**
+     * The new description of the label.
+     * @maxLength 1024
+     */
     description?: string;
     /**
      * The hex color to be displayed with the Label (for example, "#ff0000").
@@ -4708,8 +5227,11 @@ export interface UpdateLabel {
     /** A true/false boolean indicating if the Label has been archived. */
     archived?: boolean;
 }
-export interface UpdateLinkedFile {
-    /** The description of the file. */
+interface UpdateLinkedFile {
+    /**
+     * The description of the file.
+     * @maxLength 512
+     */
     description?: string;
     /**
      * The ID of the linked story.
@@ -4728,7 +5250,7 @@ export interface UpdateLinkedFile {
      */
     thumbnail_url?: string;
     /** The integration type of the file (e.g. google, dropbox, box). */
-    type?: 'google' | 'url' | 'dropbox' | 'box' | 'onedrive';
+    type?: "google" | "url" | "dropbox" | "box" | "onedrive";
     /**
      * The filesize, if the integration provided it.
      * @format int64
@@ -4746,7 +5268,7 @@ export interface UpdateLinkedFile {
      */
     url?: string;
 }
-export interface UpdateMilestone {
+interface UpdateMilestone {
     /**
      * The Milestone's description.
      * @maxLength 100000
@@ -4766,7 +5288,7 @@ export interface UpdateMilestone {
      */
     name?: string;
     /** The workflow state that the Milestone is in. */
-    state?: 'in progress' | 'to do' | 'done';
+    state?: "in progress" | "to do" | "done";
     /**
      * A manual override for the time/date the Milestone was started.
      * @format date-time
@@ -4785,7 +5307,46 @@ export interface UpdateMilestone {
      */
     after_id?: number;
 }
-export interface UpdateProject {
+interface UpdateObjective {
+    /**
+     * The Objective's description.
+     * @maxLength 100000
+     */
+    description?: string;
+    /** A boolean indicating whether the Objective is archived or not */
+    archived?: boolean;
+    /**
+     * A manual override for the time/date the Objective was completed.
+     * @format date-time
+     */
+    completed_at_override?: string | null;
+    /**
+     * The name of the Objective.
+     * @minLength 1
+     * @maxLength 256
+     */
+    name?: string;
+    /** The workflow state that the Objective is in. */
+    state?: "in progress" | "to do" | "done";
+    /**
+     * A manual override for the time/date the Objective was started.
+     * @format date-time
+     */
+    started_at_override?: string | null;
+    /** An array of IDs of Categories attached to the Objective. */
+    categories?: CreateCategoryParams[];
+    /**
+     * The ID of the Objective we want to move this Objective before.
+     * @format int64
+     */
+    before_id?: number;
+    /**
+     * The ID of the Objective we want to move this Objective after.
+     * @format int64
+     */
+    after_id?: number;
+}
+interface UpdateProject {
     /**
      * The Project's description.
      * @maxLength 100000
@@ -4823,7 +5384,7 @@ export interface UpdateProject {
     /** The Project abbreviation used in Story summaries. Should be kept to 3 characters at most. */
     abbreviation?: string;
 }
-export interface UpdateStories {
+interface UpdateStories {
     /** If the Stories should be archived or not. */
     archived?: boolean;
     /**
@@ -4832,9 +5393,9 @@ export interface UpdateStories {
      */
     story_ids: number[];
     /** The type of story (feature, bug, chore). */
-    story_type?: 'feature' | 'chore' | 'bug';
+    story_type?: "feature" | "chore" | "bug";
     /** One of "first" or "last". This can be used to move the given story to the first or last position in the workflow state. */
-    move_to?: 'last' | 'first';
+    move_to?: "last" | "first";
     /**
      * The UUIDs of the new followers to be added.
      * @uniqueItems true
@@ -4916,7 +5477,7 @@ export interface UpdateStories {
      */
     owner_ids_add?: string[];
 }
-export interface UpdateStory {
+interface UpdateStory {
     /**
      * The description of the story.
      * @maxLength 100000
@@ -4932,11 +5493,11 @@ export interface UpdateStory {
      */
     pull_request_ids?: number[];
     /** The type of story (feature, bug, chore). */
-    story_type?: 'feature' | 'chore' | 'bug';
+    story_type?: "feature" | "chore" | "bug";
     /** A map specifying a CustomField ID and CustomFieldEnumValue ID that represents an assertion of some value for a CustomField. */
     custom_fields?: CustomFieldValueParams[];
     /** One of "first" or "last". This can be used to move the given story to the first or last position in the workflow state. */
-    move_to?: 'last' | 'first';
+    move_to?: "last" | "first";
     /**
      * An array of IDs of files attached to the story.
      * @uniqueItems true
@@ -5005,6 +5566,11 @@ export interface UpdateStory {
      * @uniqueItems true
      */
     owner_ids?: string[];
+    /**
+     * The parent story id. If you want to unset this value set parent_story_id to null.
+     * @format int64
+     */
+    parent_story_id?: number | null;
     /**
      * The ID of the story we want to move this story before.
      * @format int64
@@ -5036,7 +5602,7 @@ export interface UpdateStory {
      */
     deadline?: string | null;
 }
-export interface UpdateStoryComment {
+interface UpdateStoryComment {
     /**
      * The updated comment text.
      * @maxLength 100000
@@ -5044,19 +5610,15 @@ export interface UpdateStoryComment {
     text: string;
 }
 /** Updated attributes for the template to populate. */
-export interface UpdateStoryContents {
+interface UpdateStoryContents {
     /** The description of the story. */
     description?: string;
-    /** A string description of this resource. */
-    entity_type?: string;
     /** An array of labels to be populated by the template. */
     labels?: CreateLabelParams[];
     /** The type of story (feature, bug, chore). */
     story_type?: string;
     /** An array of maps specifying a CustomField ID and CustomFieldEnumValue ID that represents an assertion of some value for a CustomField. */
     custom_fields?: CustomFieldValueParams[];
-    /** An array of linked files attached to the story. */
-    linked_files?: LinkedFile[];
     /**
      * An array of the attached file IDs to be populated.
      * @uniqueItems true
@@ -5071,25 +5633,25 @@ export interface UpdateStoryContents {
     epic_id?: number | null;
     /** An array of external links to be populated. */
     external_links?: string[];
+    /** An array of sub-tasks connected to the story */
+    sub_tasks?: CreateSubTaskParams[];
     /**
      * The ID of the iteration the to be populated.
      * @format int64
      */
     iteration_id?: number | null;
     /** An array of tasks to be populated by the template. */
-    tasks?: EntityTemplateTask[];
-    /** An array of label ids attached to the story. */
-    label_ids?: number[];
+    tasks?: BaseTaskParams[];
     /**
      * The ID of the group to be populated.
      * @format uuid
      */
     group_id?: string | null;
     /**
-     * The ID of the workflow state the story is currently in.
+     * The ID of the workflow state to be populated.
      * @format int64
      */
-    workflow_state_id?: number;
+    workflow_state_id?: number | null;
     /** An array of UUIDs for any Members listed as Followers. */
     follower_ids?: string[];
     /** An array of UUIDs of the owners of this story. */
@@ -5099,8 +5661,6 @@ export interface UpdateStoryContents {
      * @format int64
      */
     estimate?: number | null;
-    /** An array of files attached to the story. */
-    files?: UploadedFile[];
     /**
      * The ID of the project the story belongs to.
      * @format int64
@@ -5117,9 +5677,9 @@ export interface UpdateStoryContents {
      */
     deadline?: string | null;
 }
-export interface UpdateStoryLink {
+interface UpdateStoryLink {
     /** The type of link. */
-    verb?: 'blocks' | 'duplicates' | 'relates to';
+    verb?: "blocks" | "duplicates" | "relates to";
     /**
      * The ID of the subject Story.
      * @format int64
@@ -5131,7 +5691,7 @@ export interface UpdateStoryLink {
      */
     object_id?: number;
 }
-export interface UpdateTask {
+interface UpdateTask {
     /**
      * The Task's description.
      * @minLength 1
@@ -5154,14 +5714,14 @@ export interface UpdateTask {
     after_id?: number;
 }
 /** An UploadedFile is any document uploaded to your Shortcut Workspace. Files attached from a third-party service are different: see the Linked Files endpoint. */
-export interface UploadedFile {
+interface UploadedFile {
     /** The description of the file. */
     description?: string | null;
     /** A string description of this resource. */
     entity_type: string;
     /** The unique IDs of the Stories associated with this file. */
     story_ids: number[];
-    /** Deprecated: use member_mention_ids. */
+    /** `Deprecated:` use `member_mention_ids`. */
     mention_ids: string[];
     /** The unique IDs of the Members who are mentioned in the file description. */
     member_mention_ids: string[];
@@ -5206,7 +5766,7 @@ export interface UploadedFile {
     created_at: string;
 }
 /** Workflow is the array of defined Workflow States. Workflow can be queried using the API but must be updated in the Shortcut UI.  */
-export interface Workflow {
+interface Workflow {
     /** A description of the workflow. */
     description: string;
     /** A string description of this resource. */
@@ -5246,7 +5806,7 @@ export interface Workflow {
     default_state_id: number;
 }
 /** Workflow State is any of the at least 3 columns. Workflow States correspond to one of 3 types: Unstarted, Started, or Done. */
-export interface WorkflowState {
+interface WorkflowState {
     /** The description of what sort of Stories belong in that Workflow state. */
     description: string;
     /** A string description of this resource. */
@@ -5296,3 +5856,5 @@ export interface WorkflowState {
      */
     created_at: string;
 }
+
+export type { BaseTaskParams, BasicWorkspaceInfo, Branch, Category, Commit, CreateCategory, CreateCategoryParams, CreateCommentComment, CreateEntityTemplate, CreateEpic, CreateEpicComment, CreateEpicHealth, CreateGenericIntegration, CreateGroup, CreateIteration, CreateLabelParams, CreateLinkedFile, CreateMilestone, CreateObjective, CreateOrDeleteStoryReaction, CreateProject, CreateStories, CreateStoryComment, CreateStoryCommentParams, CreateStoryContents, CreateStoryFromTemplateParams, CreateStoryLink, CreateStoryLinkParams, CreateStoryParams, CreateSubTaskParams, CreateTask, CreateTaskParams, CustomField, CustomFieldEnumValue, CustomFieldValueParams, DataConflictError, DeleteStories, EntityTemplate, Epic, EpicAssociatedGroup, EpicPaginatedResults, EpicSearchResult, EpicSearchResults, EpicSlim, EpicState, EpicStats, EpicWorkflow, Group, Health, History, HistoryActionBranchCreate, HistoryActionBranchMerge, HistoryActionBranchPush, HistoryActionLabelCreate, HistoryActionLabelDelete, HistoryActionLabelUpdate, HistoryActionProjectUpdate, HistoryActionPullRequest, HistoryActionStoryCommentCreate, HistoryActionStoryCreate, HistoryActionStoryDelete, HistoryActionStoryLinkCreate, HistoryActionStoryLinkDelete, HistoryActionStoryLinkUpdate, HistoryActionStoryUpdate, HistoryActionTaskCreate, HistoryActionTaskDelete, HistoryActionTaskUpdate, HistoryActionWorkspace2BulkUpdate, HistoryChangesStory, HistoryChangesStoryLink, HistoryChangesTask, HistoryReferenceBranch, HistoryReferenceCommit, HistoryReferenceCustomFieldEnumValue, HistoryReferenceEpic, HistoryReferenceGeneral, HistoryReferenceGroup, HistoryReferenceIteration, HistoryReferenceLabel, HistoryReferenceProject, HistoryReferenceStory, HistoryReferenceStoryTask, HistoryReferenceWorkflowState, Icon, Identity, Iteration, IterationAssociatedGroup, IterationSearchResults, IterationSlim, IterationStats, KeyResult, KeyResultValue, Label, LabelSlim, LabelStats, LinkSubTaskParams, LinkedFile, MaxSearchResultsExceededError, Member, MemberInfo, Milestone, MilestoneStats, Objective, ObjectiveSearchResult, ObjectiveSearchResults, ObjectiveStats, Profile, Project, ProjectStats, PullRequest, PullRequestLabel, RemoveCustomFieldParams, RemoveLabelParams, Repository, SearchResults, SearchStories, Story, StoryComment, StoryContents, StoryContentsTask, StoryCustomField, StoryHistoryChangeAddsRemovesInt, StoryHistoryChangeAddsRemovesUuid, StoryHistoryChangeOldNewBool, StoryHistoryChangeOldNewInt, StoryHistoryChangeOldNewStr, StoryHistoryChangeOldNewUuid, StoryLink, StoryReaction, StorySearchResult, StorySearchResults, StorySlim, StoryStats, SyncedItem, Task, ThreadedComment, TypedStoryLink, UnusableEntitlementError, UpdateCategory, UpdateComment, UpdateCustomField, UpdateCustomFieldEnumValue, UpdateEntityTemplate, UpdateEpic, UpdateFile, UpdateGroup, UpdateHealth, UpdateIteration, UpdateKeyResult, UpdateLabel, UpdateLinkedFile, UpdateMilestone, UpdateObjective, UpdateProject, UpdateStories, UpdateStory, UpdateStoryComment, UpdateStoryContents, UpdateStoryLink, UpdateTask, UploadedFile, Workflow, WorkflowState };