Create a new entity template for the Workspace.
CreateEntityTemplate
Create Entity Template
POST:/api/v3/entity-templates
Create Epic allows you to create a new Epic in Shortcut.
CreateEpic
Create Epic
POST:/api/v3/epics
This endpoint allows you to create a threaded Comment on an Epic.
CreateEpicComment
Create Epic Comment
POST:/api/v3/epics/{epic-public-id}/comments
This endpoint allows you to create a nested Comment reply to an existing Epic Comment.
CreateEpicCommentComment
Create Epic Comment Comment
POST:/api/v3/epics/{epic-public-id}/comments/{comment-public-id}
Protected
createNo description
CreateGroup
Create Group
POST:/api/v3/groups
No description
CreateIteration
Create Iteration
POST:/api/v3/iterations
Create Label allows you to create a new Label in Shortcut.
CreateLabel
Create Label
POST:/api/v3/labels
Create Linked File allows you to create a new Linked File in Shortcut.
CreateLinkedFile
Create Linked File
POST:/api/v3/linked-files
(Deprecated: Use 'Create Objective') Create Milestone allows you to create a new Milestone in Shortcut.
CreateMilestone
Create Milestone
POST:/api/v3/milestones
Create Multiple Stories allows you to create multiple stories in a single request using the same syntax as Create Story.
CreateMultipleStories
Create Multiple Stories
POST:/api/v3/stories/bulk
Create Objective allows you to create a new Objective in Shortcut.
CreateObjective
Create Objective
POST:/api/v3/objectives
Create Project is used to create a new Shortcut Project.
CreateProject
Create Project
POST:/api/v3/projects
Create Story is used to add a new story to your Shortcut Workspace.
CreateStory
Create Story
POST:/api/v3/stories
Create Comment allows you to create a Comment on any Story.
CreateStoryComment
Create Story Comment
POST:/api/v3/stories/{story-public-id}/comments
Create Story From Template is used to add a new story derived from a template to your Shortcut Workspace.
CreateStoryFromTemplate
Create Story From Template
POST:/api/v3/stories/from-template
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”
CreateStoryLink
Create Story Link
POST:/api/v3/story-links
Create a reaction to a story comment.
CreateStoryReaction
Create Story Reaction
POST:/api/v3/stories/{story-public-id}/comments/{comment-public-id}/reactions
Create Task is used to create a new task in a Story.
CreateTask
Create Task
POST:/api/v3/stories/{story-public-id}/tasks
Delete Category can be used to delete any Category.
DeleteCategory
Delete Category
DELETE:/api/v3/categories/{category-public-id}
No description
DeleteCustomField
Delete Custom Field
DELETE:/api/v3/custom-fields/{custom-field-public-id}
No description
DeleteEntityTemplate
Delete Entity Template
DELETE:/api/v3/entity-templates/{entity-template-public-id}
Delete Epic can be used to delete the Epic. The only required parameter is Epic ID.
DeleteEpic
Delete Epic
DELETE:/api/v3/epics/{epic-public-id}
This endpoint allows you to delete a Comment from an Epic.
DeleteEpicComment
Delete Epic Comment
DELETE:/api/v3/epics/{epic-public-id}/comments/{comment-public-id}
Delete File deletes a previously uploaded file.
DeleteFile
Delete File
DELETE:/api/v3/files/{file-public-id}
No description
DeleteIteration
Delete Iteration
DELETE:/api/v3/iterations/{iteration-public-id}
Delete Label can be used to delete any Label.
DeleteLabel
Delete Label
DELETE:/api/v3/labels/{label-public-id}
Delete Linked File can be used to delete any previously attached Linked-File.
DeleteLinkedFile
Delete Linked File
DELETE:/api/v3/linked-files/{linked-file-public-id}
(Deprecated: Use 'Delete Objective') Delete Milestone can be used to delete any Milestone.
DeleteMilestone
Delete Milestone
DELETE:/api/v3/milestones/{milestone-public-id}
Delete Multiple Stories allows you to delete multiple archived stories at once.
DeleteMultipleStories
Delete Multiple Stories
DELETE:/api/v3/stories/bulk
Delete Objective can be used to delete any Objective.
DeleteObjective
Delete Objective
DELETE:/api/v3/objectives/{objective-public-id}
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.
DeleteProject
Delete Project
DELETE:/api/v3/projects/{project-public-id}
Delete Story can be used to delete any Story.
DeleteStory
Delete Story
DELETE:/api/v3/stories/{story-public-id}
Delete a Comment from any story.
DeleteStoryComment
Delete Story Comment
DELETE:/api/v3/stories/{story-public-id}/comments/{comment-public-id}
Removes the relationship between the stories for the given Story Link.
DeleteStoryLink
Delete Story Link
DELETE:/api/v3/story-links/{story-link-public-id}
Delete a reaction from any story comment.
DeleteStoryReaction
Delete Story Reaction
DELETE:/api/v3/stories/{story-public-id}/comments/{comment-public-id}/reactions
Delete Task can be used to delete any previously created Task on a Story.
DeleteTask
Delete Task
DELETE:/api/v3/stories/{story-public-id}/tasks/{task-public-id}
Disables the Story Template feature for the Workspace.
DisableStoryTemplates
Disable Story Templates
PUT:/api/v3/entity-templates/disable
Enables the Story Template feature for the Workspace.
EnableStoryTemplates
Enable Story Templates
PUT:/api/v3/entity-templates/enable
Get Category returns information about the selected Category.
GetCategory
Get Category
GET:/api/v3/categories/{category-public-id}
Returns information about the authenticated member.
GetCurrentMemberInfo
Get Current Member Info
GET:/api/v3/member
No description
GetCustomField
Get Custom Field
GET:/api/v3/custom-fields/{custom-field-public-id}
Get Entity Template returns information about a given entity template.
GetEntityTemplate
Get Entity Template
GET:/api/v3/entity-templates/{entity-template-public-id}
Get Epic returns information about the selected Epic.
GetEpic
Get Epic
GET:/api/v3/epics/{epic-public-id}
This endpoint returns information about the selected Epic Comment.
GetEpicComment
Get Epic Comment
GET:/api/v3/epics/{epic-public-id}/comments/{comment-public-id}
Returns the Epic Workflow for the Workspace.
GetEpicWorkflow
Get Epic Workflow
GET:/api/v3/epic-workflow
The external link associated with one or more stories.
2048
^https?://.+$
Get Stories which have a given External Link associated with them.
GetExternalLinkStories
Get External Link Stories
GET:/api/v3/external-link/stories
Get File returns information about the selected UploadedFile.
GetFile
Get File
GET:/api/v3/files/{file-public-id}
No description
GetIteration
Get Iteration
GET:/api/v3/iterations/{iteration-public-id}
Get Key Result returns information about a chosen Key Result.
GetKeyResult
Get Key Result
GET:/api/v3/key-results/{key-result-public-id}
Get Label returns information about the selected Label.
GetLabel
Get Label
GET:/api/v3/labels/{label-public-id}
Get File returns information about the selected Linked File.
GetLinkedFile
Get Linked File
GET:/api/v3/linked-files/{linked-file-public-id}
Optional
query: { Optional
Optional
org-The unique ID of the Organization to limit the lookup to.
uuid
Returns information about a Member.
GetMember
Get Member
GET:/api/v3/members/{member-public-id}
(Deprecated: Use 'Get Objective') Get Milestone returns information about a chosen Milestone.
GetMilestone
Get Milestone
GET:/api/v3/milestones/{milestone-public-id}
Get Objective returns information about a chosen Objective.
GetObjective
Get Objective
GET:/api/v3/objectives/{objective-public-id}
Get Project returns information about the selected Project.
GetProject
Get Project
GET:/api/v3/projects/{project-public-id}
Get Repository returns information about the selected Repository.
GetRepository
Get Repository
GET:/api/v3/repositories/{repo-public-id}
Get Story returns information about a chosen Story.
GetStory
Get Story
GET:/api/v3/stories/{story-public-id}
Get Comment is used to get Comment information.
GetStoryComment
Get Story Comment
GET:/api/v3/stories/{story-public-id}/comments/{comment-public-id}
Returns the stories and their relationship for the given Story Link.
GetStoryLink
Get Story Link
GET:/api/v3/story-links/{story-link-public-id}
Returns information about a chosen Task.
GetTask
Get Task
GET:/api/v3/stories/{story-public-id}/tasks/{task-public-id}
Get Workflow returns information about a chosen Workflow.
GetWorkflow
Get Workflow
GET:/api/v3/workflows/{workflow-public-id}
List Categories returns a list of all Categories and their attributes.
ListCategories
List Categories
GET:/api/v3/categories
List Category Milestones returns a list of all Milestones with the Category.
ListCategoryMilestones
List Category Milestones
GET:/api/v3/categories/{category-public-id}/milestones
Returns a list of all Objectives with the Category.
ListCategoryObjectives
List Category Objectives
GET:/api/v3/categories/{category-public-id}/objectives
No description
ListCustomFields
List Custom Fields
GET:/api/v3/custom-fields
List all the entity templates for the Workspace.
ListEntityTemplates
List Entity Templates
GET:/api/v3/entity-templates
Get a list of all Comments on an Epic.
ListEpicComments
List Epic Comments
GET:/api/v3/epics/{epic-public-id}/comments
Optional
query: { Optional
Optional
includes_A true/false boolean indicating whether to return Stories with their descriptions.
Get a list of all Stories in an Epic.
ListEpicStories
List Epic Stories
GET:/api/v3/epics/{epic-public-id}/stories
Optional
query: { Optional
Optional
includes_A true/false boolean indicating whether to return Epics with their descriptions.
List Epics returns a list of all Epics and their attributes.
ListEpics
List Epics
GET:/api/v3/epics
List Files returns a list of all UploadedFiles in the workspace.
ListFiles
List Files
GET:/api/v3/files
Optional
query: { Optional
Optional
limit?: numberThe maximum number of results to return. (Defaults to 1000, max 1000)
int64
Optional
offset?: numberThe offset at which to begin returning results. (Defaults to 0)
int64
List the Stories assigned to the Group. (By default, limited to 1,000).
ListGroupStories
List Group Stories
GET:/api/v3/groups/{group-public-id}/stories
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.
ListGroups
List Groups
GET:/api/v3/groups
Optional
query: { Optional
Optional
includes_A true/false boolean indicating whether to return Stories with their descriptions.
Get a list of all Stories in an Iteration.
ListIterationStories
List Iteration Stories
GET:/api/v3/iterations/{iteration-public-id}/stories
No description
ListIterations
List Iterations
GET:/api/v3/iterations
List all of the Epics with the Label.
ListLabelEpics
List Label Epics
GET:/api/v3/labels/{label-public-id}/epics
Optional
query: { Optional
Optional
includes_A true/false boolean indicating whether to return Stories with their descriptions.
List all of the Stories with the Label.
ListLabelStories
List Label Stories
GET:/api/v3/labels/{label-public-id}/stories
Optional
query: { Optional
Optional
slim?: booleanA true/false boolean indicating if the slim versions of the Label should be returned.
List Labels returns a list of all Labels and their attributes.
ListLabels
List Labels
GET:/api/v3/labels
List Linked Files returns a list of all Linked-Files and their attributes.
ListLinkedFiles
List Linked Files
GET:/api/v3/linked-files
Optional
query: { Optional
Optional
org-The unique ID of the Organization to limit the list to.
uuid
Returns information about members of the Workspace.
ListMembers
List Members
GET:/api/v3/members
(Deprecated: Use 'List Objective Epics') List all of the Epics within the Milestone.
ListMilestoneEpics
List Milestone Epics
GET:/api/v3/milestones/{milestone-public-id}/epics
(Deprecated: Use 'List Objectives') List Milestones returns a list of all Milestones and their attributes.
ListMilestones
List Milestones
GET:/api/v3/milestones
List all of the Epics within the Objective.
ListObjectiveEpics
List Objective Epics
GET:/api/v3/objectives/{objective-public-id}/epics
List Objectives returns a list of all Objectives and their attributes.
ListObjectives
List Objectives
GET:/api/v3/objectives
List Repositories returns a list of all Repositories and their attributes.
ListRepositories
List Repositories
GET:/api/v3/repositories
Optional
query: { Optional
Optional
includes_A true/false boolean indicating whether to return Stories with their descriptions.
List Stories returns a list of all Stories in a selected Project and their attributes.
ListStories
List Stories
GET:/api/v3/projects/{project-public-id}/stories
Lists Comments associated with a Story
ListStoryComment
List Story Comment
GET:/api/v3/stories/{story-public-id}/comments
Protected
mergeOptional
detail?: "full" | "slim"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".
Optional
entity_A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, objective, story.
Optional
next?: stringThe next page token.
Optional
page_The number of search results to include in a page. Minimum of 1 and maximum of 25.
int64
See our help center article on search operators
1
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
Search
GET:/api/v3/search
Optional
detail?: "full" | "slim"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".
Optional
entity_A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, objective, story.
Optional
next?: stringThe next page token.
Optional
page_The number of search results to include in a page. Minimum of 1 and maximum of 25.
int64
See our help center article on search operators
1
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.
SearchEpics
Search Epics
GET:/api/v3/search/epics
Optional
detail?: "full" | "slim"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".
Optional
entity_A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, objective, story.
Optional
next?: stringThe next page token.
Optional
page_The number of search results to include in a page. Minimum of 1 and maximum of 25.
int64
See our help center article on search operators
1
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.
SearchIterations
Search Iterations
GET:/api/v3/search/iterations
Optional
detail?: "full" | "slim"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".
Optional
entity_A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, objective, story.
Optional
next?: stringThe next page token.
Optional
page_The number of search results to include in a page. Minimum of 1 and maximum of 25.
int64
See our help center article on search operators
1
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.
SearchMilestones
Search Milestones
GET:/api/v3/search/milestones
Optional
detail?: "full" | "slim"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".
Optional
entity_A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, objective, story.
Optional
next?: stringThe next page token.
Optional
page_The number of search results to include in a page. Minimum of 1 and maximum of 25.
int64
See our help center article on search operators
1
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.
SearchObjectives
Search Objectives
GET:/api/v3/search/objectives
Optional
detail?: "full" | "slim"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".
Optional
entity_A collection of entity_types to search. Defaults to story and epic. Supports: epic, iteration, objective, story.
Optional
next?: stringThe next page token.
Optional
page_The number of search results to include in a page. Minimum of 1 and maximum of 25.
int64
See our help center article on search operators
1
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.
SearchStories
Search Stories
GET:/api/v3/search/stories
Search Stories lets you search Stories based on desired parameters.
SearchStoriesOld
Search Stories (Old)
POST:/api/v3/stories/search
Protected
stringifyUnlinks a Comment from its linked Slack thread (Comment replies and Slack replies will no longer be synced)
UnlinkCommentThreadFromSlack
Unlink Comment thread from Slack
POST:/api/v3/stories/{story-public-id}/comments/{comment-public-id}/unlink-from-slack
This endpoint allows you to unlink a productboard epic.
UnlinkProductboardFromEpic
Unlink Productboard from Epic
POST:/api/v3/epics/{epic-public-id}/unlink-productboard
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.
UpdateCategory
Update Category
PUT:/api/v3/categories/{category-public-id}
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'}).
UpdateCustomField
Update Custom Field
PUT:/api/v3/custom-fields/{custom-field-public-id}
Update an entity template's name or its contents.
UpdateEntityTemplate
Update Entity Template
PUT:/api/v3/entity-templates/{entity-template-public-id}
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.
UpdateEpic
Update Epic
PUT:/api/v3/epics/{epic-public-id}
This endpoint allows you to update a threaded Comment on an Epic.
UpdateEpicComment
Update Epic Comment
PUT:/api/v3/epics/{epic-public-id}/comments/{comment-public-id}
Update File updates the properties of an UploadedFile (but not its content).
UpdateFile
Update File
PUT:/api/v3/files/{file-public-id}
No description
UpdateGroup
Update Group
PUT:/api/v3/groups/{group-public-id}
No description
UpdateIteration
Update Iteration
PUT:/api/v3/iterations/{iteration-public-id}
Update Key Result allows updating a Key Result's name or initial, observed, or target values.
UpdateKeyResult
Update Key Result
PUT:/api/v3/key-results/{key-result-public-id}
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.
UpdateLabel
Update Label
PUT:/api/v3/labels/{label-public-id}
Updated Linked File allows you to update properties of a previously attached Linked-File.
UpdateLinkedFile
Update Linked File
PUT:/api/v3/linked-files/{linked-file-public-id}
(Deprecated: Use 'Update Objective') Update Milestone can be used to update Milestone properties.
UpdateMilestone
Update Milestone
PUT:/api/v3/milestones/{milestone-public-id}
Update Multiple Stories allows you to make changes to numerous stories at once.
UpdateMultipleStories
Update Multiple Stories
PUT:/api/v3/stories/bulk
Update Objective can be used to update Objective properties.
UpdateObjective
Update Objective
PUT:/api/v3/objectives/{objective-public-id}
Update Project can be used to change properties of a Project.
UpdateProject
Update Project
PUT:/api/v3/projects/{project-public-id}
Update Story can be used to update Story properties.
UpdateStory
Update Story
PUT:/api/v3/stories/{story-public-id}
Update Comment replaces the text of the existing Comment.
UpdateStoryComment
Update Story Comment
PUT:/api/v3/stories/{story-public-id}/comments/{comment-public-id}
Updates the stories and/or the relationship for the given Story Link.
UpdateStoryLink
Update Story Link
PUT:/api/v3/story-links/{story-link-public-id}
Update Task can be used to update Task properties.
UpdateTask
Update Task
PUT:/api/v3/stories/{story-public-id}/tasks/{task-public-id}
A file upload. At least one is required.
binary
Optional
file1?: FileOptional additional files.
binary
Optional
file2?: FileOptional additional files.
binary
Optional
file3?: FileOptional additional files.
binary
Optional
story_The story ID that these files will be associated with.
int64
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.
UploadFiles
Upload Files
POST:/api/v3/files
Generated using TypeDoc
Description
Create Category allows you to create a new Category in Shortcut.
Name
CreateCategory
Summary
Create Category
Request
POST:/api/v3/categories
Secure