Create linked file
Create linked file allows you to create a new linked file in shortcut.
Create milestone
(deprecated: use 'create objective') create milestone allows you to create a new milestone in shortcut.
Create multiple stories
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
Create objective allows you to create a new objective in shortcut.
Create project
Create project is used to create a new shortcut project.
Create story
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 re…
Create story comment
Create comment allows you to create a comment on any story.
Create story from template
Create story from template is used to add a new story derived from a template to your shortcut workspace.
Create story link
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: sub…
Create story reaction
Create a reaction to a story comment.
Create task
Create task is used to create a new task in a story.
Delete category
Delete category can be used to delete any category.
Delete custom field
Deletes a specific custom field from the shortcut system using its unique public identifier. this endpoint should be used when you need to permanently remove a custom field that …
Delete entity template
Deletes a specific entity template from the shortcut api. this endpoint should be used when you need to permanently remove a template that is no longer needed or is obsolete. it'…
Delete epic
Delete epic can be used to delete the epic. the only required parameter is epic id.
Delete epic comment
This endpoint allows you to delete a comment from an epic.
Delete file
Delete file deletes a previously uploaded file.
Delete iteration
Deletes a specific iteration from the shortcut project management system. this endpoint should be used when you need to permanently remove an iteration and all its associated dat…
Delete label
Delete label can be used to delete any label.
Delete linked file
Delete linked file can be used to delete any previously attached linked-file.
Delete milestone
(deprecated: use 'delete objective') delete milestone can be used to delete any milestone.
Delete multiple stories
Delete multiple stories allows you to delete multiple archived stories at once.
Delete objective
Delete objective can be used to delete any objective.
Delete project
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 w…
Delete story
Delete story can be used to delete any story.
Delete story comment
Delete a comment from any story.
Delete story link
Removes the relationship between the stories for the given story link.
Delete story reaction
Delete a reaction from any story comment.
Delete task
Delete task can be used to delete any previously created task on a story.
Disable iterations
Disables iterations for the current workspace
Disable story templates
Disables the story template feature for the workspace.
Enable iterations
Enables iterations for the current workspace
Enable story templates
Enables the story template feature for the workspace.
Get category
Get category returns information about the selected category.
Get current member info
Returns information about the authenticated member.
Get custom field
Retrieves detailed information about a specific custom field in shortcut using its unique public identifier. this endpoint allows developers to fetch the properties and configura…
Get entity template
Get entity template returns information about a given entity template.
Get epic
Get epic returns information about the selected epic.
Get epic comment
This endpoint returns information about the selected epic comment.
Get epic workflow
Returns the epic workflow for the workspace.
Get external link stories
Get stories which have a given external link associated with them.
Get file
Get file returns information about the selected uploadedfile.
Get group
Retrieves detailed information about a specific group in the shortcut workspace using its unique public identifier. this endpoint allows developers to fetch comprehensive data ab…
Get iteration
Retrieves detailed information about a specific iteration in the shortcut project management system. this endpoint allows users to fetch comprehensive data about a single iterati…
Get key result
Get key result returns information about a chosen key result.
Get label
Get label returns information about the selected label.
Get linked file
Get file returns information about the selected linked file.
Get member
Returns information about a member.
Get milestone
(deprecated: use 'get objective') get milestone returns information about a chosen milestone.
Get objective
Get objective returns information about a chosen objective.
Get project
Get project returns information about the selected project.
Get repository
Get repository returns information about the selected repository.
Get story
Get story returns information about a chosen story.
Get story comment
Get comment is used to get comment information.
Get story link
Returns the stories and their relationship for the given story link.
Get task
Returns information about a chosen task.
Get workflow
Get workflow returns information about a chosen workflow.
List categories
List categories returns a list of all categories and their attributes.
List category milestones
List category milestones returns a list of all milestones with the category.
List category objectives
Returns a list of all objectives with the category.
List custom fields
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 t…
List entity templates
List all the entity templates for the workspace.
List epic comments
Get a list of all comments on an epic.
List epics
List epics returns a list of all epics and their attributes.
List epic stories
Get a list of all stories in an epic.
List files
List files returns a list of all uploadedfiles in the workspace.
List groups
A group in our api maps to a \
List group stories
List the stories assigned to the group. (by default, limited to 1,000).
List iterations
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 organiz…
List iteration stories
Get a list of all stories in an iteration.
List label epics
List all of the epics with the label.
List labels
List labels returns a list of all labels and their attributes.
List label stories
List all of the stories with the label.
List linked files
List linked files returns a list of all linked-files and their attributes.
List members
Returns information about members of the workspace.
List milestone epics
(deprecated: use 'list objective epics') list all of the epics within the milestone.
List milestones
(deprecated: use 'list objectives') list milestones returns a list of all milestones and their attributes.
List objective epics
List all of the epics within the objective.
List objectives
List objectives returns a list of all objectives and their attributes.
List projects
List projects returns a list of all projects and their attributes.
List repositories
List repositories returns a list of all repositories and their attributes.
List stories
List stories returns a list of all stories in a selected project and their attributes.
List story comment
Lists comments associated with a story
List workflows
Returns a list of all workflows in the workspace.
Search
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…
Search epics
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` …
Search iterations
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 create…
Search milestones
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 create…
Search objectives
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 create…
Search stories
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 `…
Search stories old
Search stories lets you search stories based on desired parameters.
Story history
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 revi…
Unlink comment thread from slack
Unlinks a comment from its linked slack thread (comment replies and slack replies will no longer be synced)
Unlink productboard from epic
This endpoint allows you to unlink a productboard epic.
Update category
Update category allows you to replace a category name with another name. if you try to name a category something that already exists, you will receive a 422 response.
Update custom field
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 delet…
Update entity template
Update an entity template's name or its contents.
Update epic
Update epic can be used to update numerous fields in the epic. the only required parameter is epic id, which can be found in the shortcut ui.
Update epic comment
This endpoint allows you to update a threaded comment on an epic.
Update file
Update file updates the properties of an uploadedfile (but not its content).
Update group
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 associ…
Update iteration
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 m…
Update key result
Update key result allows updating a key result's name or initial, observed, or target values.
Update label
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.
Update linked file
Updated linked file allows you to update properties of a previously attached linked-file.
Update milestone
(deprecated: use 'update objective') update milestone can be used to update milestone properties.
Update multiple stories
Update multiple stories allows you to make changes to numerous stories at once.
Update objective
Update objective can be used to update objective properties.
Update project
Update project can be used to change properties of a project.
Update story
Update story can be used to update story properties.
Update story comment
Update comment replaces the text of the existing comment.
Update story link
Updates the stories and/or the relationship for the given story link.
Update task
Update task can be used to update task properties.
Upload files
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 …