Shortcut

List categories returns a list of all categories and their attributes.

List epics returns a list of all epics and their attributes.

(deprecated: use 'list objectives') list milestones returns a list of all milestones and their attributes.

List objectives returns a list of all objectives and their attributes.

Search objectives lets you search objectives based on desired parameters. since ordering of results can change over time (due to search ranking decay, new objectives being created), the `next` value from the previous response can be used as the path and query string for the next page to ensure stable ordering.

Create category allows you to create a new category in shortcut.

Create a new entity template for the workspace.

Create epic allows you to create a new epic in shortcut.

This endpoint allows you to create a threaded comment on an epic.

This endpoint allows you to create a nested comment reply to an existing epic comment.

Creates a new group in the shortcut system with customizable properties. this endpoint allows you to set up a group with a unique mention name, display name, optional description, and various customization options. use this when you need to establish a new team, department, or any other collective within your shortcut workspace. the created group can include members, associated workflows, and visual customizations like color and icon. this endpoint is particularly useful for organizing your shortcut workspace structure, facilitating team collaboration, and streamlining workflow management. note that while member and workflow associations can be set during creation, they can also be modified later using separate endpoints.

The createiteration endpoint allows you to create a new iteration in shortcut, which represents a time-boxed period for completing a set of stories or tasks. this endpoint is crucial for teams using agile methodologies, enabling them to plan and track progress over specific time periods. use this endpoint when setting up sprint cycles, planning releases, or organizing work into manageable timeframes. the endpoint requires essential information such as the iteration's name and date range, while also offering options to add followers, associate groups, and attach labels for better organization and tracking. it's important to note that while multiple groups can be added via the api, the current web ui only displays one group association. this endpoint should not be used for modifying existing iterations; instead, use the dedicated update endpoint for such changes.

Create label allows you to create a new label in shortcut.

Create linked file allows you to create a new linked file in shortcut.

(deprecated: use 'create objective') create milestone allows you to create a new milestone in shortcut.

Create multiple stories allows you to create multiple stories in a single request using the same syntax as [create story](https://developer.shortcut.com/api/rest/v3#create-story).

Create objective allows you to create a new objective in shortcut.

Create project is used to create a new shortcut project.

Create story is used to add a new story to your shortcut workspace. this endpoint requires that either **workflow state id** or **project id** be provided, but will reject the request if both or neither are specified. the workflow state id has been marked as required and is the recommended field to specify because we are in the process of sunsetting projects in shortcut.

Create comment allows you to create a comment on any story.