Shortcut

Get Category returns information about the selected Category.

Returns information about the authenticated member.

Retrieves detailed information about a specific custom field in Shortcut using its unique public identifier. This endpoint allows developers to fetch the properties and configuration of a custom field, which can include its name, type, possible values, and any other associated metadata. It's particularly useful when you need to inspect or validate a custom field's settings programmatically, or when integrating custom field data into external systems. The endpoint should be used when detailed information about a single custom field is required, rather than for bulk operations or listing all custom fields. Note that this endpoint only provides read access to custom field data and cannot be used to modify the custom field.

Get Entity Template returns information about a given entity template.

Get Epic returns information about the selected Epic.

This endpoint returns information about the selected Epic Comment.

Get the current health status for the specified Epic. Use when you need to check the health status of an Epic.

Returns the Epic Workflow for the Workspace.

Get Stories which have a given External Link associated with them.

Get File returns information about the selected UploadedFile.

Get Generic Integration returns information about a webhook integration by its ID. Use when you need to retrieve details about a specific webhook integration.

Retrieves detailed information about a specific group in the Shortcut workspace using its unique public identifier. This endpoint allows developers to fetch comprehensive data about a group, including its name, type, and associated metadata. It's particularly useful when you need to access or verify group details programmatically, such as during workflow automations or when building integrations that involve group management. The endpoint provides more granular control and information compared to what's available through the web application, making it valuable for advanced group-related operations and data analysis within your Shortcut projects.

Retrieves detailed information about a specific iteration in the Shortcut project management system. This endpoint allows users to fetch comprehensive data about a single iteration, including its name, status, start and end dates, associated stories, and progress metrics. It should be used when detailed information about a particular iteration is needed, such as during sprint planning, progress tracking, or retrospective analysis. The endpoint provides a snapshot of the iteration at the time of the request and does not include real-time updates. It's particularly useful for project managers, scrum masters, and team members who need to review or report on iteration-specific data. Note that this endpoint only retrieves information and does not allow for modification of the iteration details.

Get Key Result returns information about a chosen Key Result.

Get Label returns information about the selected Label.

Get File returns information about the selected Linked File.

Returns information about a Member.

(Deprecated: Use 'Get Objective') Get Milestone returns information about a chosen Milestone.

Get Objective returns information about a chosen Objective.

Get Repository returns information about the selected Repository.

Get Story returns information about a chosen Story.

Get Comment is used to get Comment information.

Returns the stories and their relationship for the given Story Link.

Returns information about a chosen Task.

Get Workflow returns information about a chosen Workflow.

List Category Milestones returns a list of all Milestones with the Category.

Returns a list of all Objectives with the Category.

Retrieves a list of all custom fields defined in the Shortcut API. This endpoint allows developers to fetch information about user-defined fields that have been added to extend the functionality of standard fields in integrations. It's particularly useful when you need to understand the structure and types of custom data being used across the system. The endpoint returns details about each custom field, which may include their identifiers, names, types, and any associated metadata. Use this endpoint when you need to inventory existing custom fields, prepare for data migrations, or dynamically adjust your application's data model to accommodate custom fields. Note that this endpoint does not create, modify, or delete custom fields; it's purely for retrieval of existing custom field definitions.

Tool to retrieve all Epics related to a specific Document. Use when you need to understand which Epics are associated with a given document in Shortcut.

List all the entity templates for the Workspace.

Get a list of all Comments on an Epic.

Get a list of all Documents related to this Epic.

List the history of health statuses for the specified Epic, most recent first. Use when you need to track health status changes over time.

Get a list of all Stories in an Epic.

List Files returns a list of all UploadedFiles in the workspace.

List the Stories assigned to the Group. (By default, limited to 1,000).

A group in our API maps to a "Team" within the Shortcut Product. A Team is a collection of Users that can be associated to Stories, Epics, and Iterations within Shortcut.

Get a list of all Stories in an Iteration.

Retrieves a list of all iterations in the Shortcut project management system. Iterations represent specific time periods for planning and tracking work, allowing teams to organize their development cycles. This endpoint provides comprehensive information about each iteration, including its name, start and end dates, status, and associated stories or tasks. Use this endpoint when you need an overview of all iterations for project planning, progress tracking, or reporting purposes. It's particularly useful for analyzing past performance, planning future sprints, or getting a high-level view of the project timeline. Note that the response may be paginated for projects with a large number of iterations, and you might need to make multiple requests to retrieve the full dataset.

List all of the Epics with the Label.

List all of the Stories with the Label.

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

List Linked Files returns a list of all Linked-Files and their attributes.

Returns information about members of the Workspace.

Returns minimal member data optimized for Korey integration. Use this when you need basic member information without full profile details. Returns all workspace members with disabled status indicated in the response.

(Deprecated: Use 'List Objective Epics') List all of the Epics within the Milestone.

List all of the Epics within the Objective.

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

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

List Stories returns a list of all Stories in a selected Project and their attributes.

Lists Comments associated with a Story

Tool to list all Sub-task Stories for a given parent Story. Use when you need to retrieve all sub-tasks associated with a specific story.

Returns a list of all Workflows in the Workspace.

Search lets you search Epics and Stories based on desired parameters. Since ordering of the results can change over time (due to search ranking decay, new Epics and Stories 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.

Search Epics lets you search Epics based on desired parameters. Since ordering of stories can change over time (due to search ranking decay, new Epics 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.

Search Iterations lets you search Iterations based on desired parameters. Since ordering of results can change over time (due to search ranking decay, new Iterations 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.

Search Milestones lets you search Milestones based on desired parameters. Since ordering of results can change over time (due to search ranking decay, new Milestones 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.

Search Stories lets you search Stories based on desired parameters. Since ordering of stories can change over time (due to search ranking decay, new stories 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.

Search Stories lets you search Stories based on desired parameters.

Retrieves the complete history of changes for a specific story in the Shortcut project management system. This endpoint allows users to track all modifications, updates, and revisions made to a story over time, providing a comprehensive timeline of its evolution. It's particularly useful for project managers, team members, and stakeholders who need to understand how a story has changed, who made the changes, and when they occurred. The endpoint returns a chronological list of all events and modifications associated with the specified story, helping teams maintain transparency and accountability in their project workflows. Note that this endpoint focuses solely on the history of a single story and does not provide information about related stories or overall project status.

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.

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.

Create Story From Template is used to add a new story derived from a template to your Shortcut Workspace.

Story Links (called Story Relationships in the UI) allow you create semantic relationships between two stories. The parameters read like an active voice grammatical sentence: subject -> verb -> object. The subject story acts on the object Story; the object story is the direct object of the sentence. The subject story "blocks", "duplicates", or "relates to" the object story. Examples: - "story 5 blocks story 6” -- story 6 is now "blocked" until story 5 is moved to a Done workflow state. - "story 2 duplicates story 1” -- Story 2 represents the same body of work as Story 1 (and should probably be archived). - "story 7 relates to story 3”

Create a reaction to a story comment.

Create Task is used to create a new task in a Story.

Upload Files uploads one or many files and optionally associates them with a story. Use the multipart/form-data content-type to upload. Each `file` key should contain a separate file. Each UploadedFile's name comes from the Content-Disposition header "filename" directive for that field.

This endpoint allows you to update a threaded Comment on an Epic.

Update File updates the properties of an UploadedFile (but not its content).

Updates an existing group in the Shortcut workspace. This endpoint allows you to modify various properties of a group, including its name, description, color, members, and associated workflows. Use this when you need to change group details, add or remove members, or update the group's visual representation. It's particularly useful for team reorganizations, project changes, or general maintenance of your Shortcut workspace structure. Note that while many fields are optional, you should include any fields you wish to modify; omitted fields will retain their current values.

Update an existing health status by its ID. Use when you need to modify the health tracking status of an Epic or Objective.

This endpoint allows you to update an existing iteration in Shortcut. It provides comprehensive control over various aspects of an iteration, including its metadata, associated members and groups, labels, and timeframe. Use this endpoint when you need to modify any details of an ongoing or upcoming iteration, such as adjusting dates, adding followers, or updating labels. The endpoint is particularly useful for project managers or team leads who need to refine iteration details as the project progresses. Note that while you can update multiple aspects of an iteration in a single call, only the fields you include in the request will be modified; omitted fields will retain their current values.

Update Key Result allows updating a Key Result's name or initial, observed, or target values.

Update Label allows you to replace a Label name with another name. If you try to name a Label something that already exists, you will receive a 422 response.

Updated Linked File allows you to update properties of a previously attached Linked-File.

(Deprecated: Use 'Update Objective') Update Milestone can be used to update Milestone properties.

Update Multiple Stories allows you to make changes to numerous stories at once.

Update Objective can be used to update Objective properties.

Update Project can be used to change properties of a Project.

Update Story can be used to update Story properties.

Update Comment replaces the text of the existing Comment.

Updates the stories and/or the relationship for the given Story Link.

Update Task can be used to update Task properties.

Delete Linked File can be used to delete any previously attached Linked-File.

(Deprecated: Use 'Delete Objective') Delete Milestone can be used to delete any Milestone.

Delete Multiple Stories allows you to delete multiple archived stories at once.

Delete Objective can be used to delete any Objective.

Delete Project can be used to delete a Project. Projects can only be deleted if all associated Stories are moved or deleted. In the case that the Project cannot be deleted, you will receive a 422 response.

Delete Story can be used to delete any Story.

Delete a Comment from any story.

Removes the relationship between the stories for the given Story Link.

Delete a reaction from any story comment.

Delete Task can be used to delete any previously created Task on a Story.

Disables Iterations for the current workspace

Unlinks a Comment from its linked Slack thread (Comment replies and Slack replies will no longer be synced)

Tool to remove the relationship between a Document and an Epic. Use when you need to unlink a previously associated document from an epic.

Update Custom Field can be used to update the definition of a Custom Field. The order of items in the 'values' collection is interpreted to be their ascending sort order.To delete an existing enum value, simply omit it from the 'values' collection. New enum values may be created inline by including an object in the 'values' collection having a 'value' entry with no 'id' (eg. {'value': 'myNewValue', 'color_key': 'green'}).