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
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 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.
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
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}
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 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
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 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}
Returns information about a Member.
GetMember
Get Member
GET:/api/v3/members/{member-public-id}
Get Milestone returns information about a chosen Milestone.
GetMilestone
Get Milestone
GET:/api/v3/milestones/{milestone-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
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
Get a list of all Stories in an Epic.
ListEpicStories
List Epic Stories
GET:/api/v3/epics/{epic-public-id}/stories
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
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
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
List all of the Stories with the Label.
ListLabelStories
List Label Stories
GET:/api/v3/labels/{label-public-id}/stories
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
Returns information about members of the Workspace.
ListMembers
List Members
GET:/api/v3/members
List all of the Epics within the Milestone.
ListMilestoneEpics
List Milestone Epics
GET:/api/v3/milestones/{milestone-public-id}/epics
List Milestones returns a list of all Milestones and their attributes.
ListMilestones
List Milestones
GET:/api/v3/milestones
List Repositories returns a list of all Repositories and their attributes.
ListRepositories
List Repositories
GET:/api/v3/repositories
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
mergeSearch 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
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
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
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
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
stringifyThis 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 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}
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 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