search-stories
Locate specific stories in Shortcut by filtering criteria such as ID, name, type, state, owner, team, or completion status. Streamline project management and data retrieval with targeted searches.
Instructions
Find Shortcut stories.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| branch | No | Find only stories matching the specified branch | |
| comment | No | Find only stories matching the specified comment | |
| commit | No | Find only stories matching the specified commit | |
| completed | No | ||
| created | No | The date in "YYYY-MM-DD" format, or one of the keywords: "yesterday", "today", "tomorrow", or a date range in the format "YYYY-MM-DD..YYYY-MM-DD". The date range can also be open ended by using "*" for one of the bounds. Examples: "2023-01-01", "today", "2023-01-01..*" (from Jan 1, 2023 to any future date), "*.2023-01-31" (any date up to Jan 31, 2023), "today..*" (from today onwards), "*.yesterday" (any date up to yesterday). The keywords cannot be used to calculate relative dates (e.g. the following are not valid: "today-1" or "tomorrow+1"). | |
| description | No | Find only stories matching the specified description | |
| due | No | ||
| epic | No | Find only stories matching the specified epic | |
| estimate | No | Find only stories matching the specified estimate | |
| hasAttachment | No | Find only entities that have an attachment when true, or only entities that do not have an attachment when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner. | |
| hasBranch | No | Find only entities that have a branch when true, or only entities that do not have a branch when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner. | |
| hasComment | No | Find only entities that have a comment when true, or only entities that do not have a comment when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner. | |
| hasCommit | No | Find only entities that have a commit when true, or only entities that do not have a commit when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner. | |
| hasDeadline | No | Find only entities that have a deadline when true, or only entities that do not have a deadline when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner. | |
| hasEpic | No | Find only entities that have an epic when true, or only entities that do not have an epic when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner. | |
| hasLabel | No | Find only entities that have a label when true, or only entities that do not have a label when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner. | |
| hasOwner | No | Find only entities that have an owner when true, or only entities that do not have an owner when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner. | |
| hasPr | No | Find only entities that have a pr when true, or only entities that do not have a pr when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner. | |
| hasTask | No | Find only entities that have a task when true, or only entities that do not have a task when false. Example: hasOwner: true will find stories with an owner, hasOwner: false will find stories without an owner. | |
| id | No | Find only stories with the specified public ID | |
| isArchived | No | Find only entities that are archived when true, or only entities that are not archived when false. | |
| isBlocked | No | Find only entities that are blocked when true, or only entities that are not blocked when false. | |
| isBlocker | No | Find only entities that are blocking when true, or only entities that are not blocking when false. | |
| isDone | No | Find only entities that are completed when true, or only entities that are not completed when false. | |
| isOverdue | No | Find only entities that are overdue when true, or only entities that are not overdue when false. | |
| isStarted | No | Find only entities that are started when true, or only entities that are not started when false. | |
| isUnestimated | No | Find only entities that are unestimated when true, or only entities that are not unestimated when false. | |
| isUnstarted | No | Find only entities that are unstarted when true, or only entities that are not unstarted when false. | |
| label | No | Find only stories matching the specified label | |
| name | No | Find only stories matching the specified name | |
| objective | No | Find only stories matching the specified objective | |
| owner | No | Find entities where the owner match the specified user. This must either be the user's mention name or the keyword "me" for the current user. | |
| pr | No | Find only stories matching the specified pull request | |
| priority | No | Find only stories matching the specified priority | |
| productArea | No | Find only stories matching the specified product area | |
| project | No | Find only stories matching the specified project | |
| requester | No | Find entities where the requester match the specified user. This must either be the user's mention name or the keyword "me" for the current user. | |
| severity | No | Find only stories matching the specified severity | |
| skillSet | No | Find only stories matching the specified skill set | |
| state | No | Find only stories matching the specified state | |
| team | No | Find only stories matching the specified team. This can be a team mention name or team name. | |
| technicalArea | No | Find only stories matching the specified technical area | |
| type | No | Find only stories of the specified type | |
| updated | No |