search-epics
Locate Shortcut epics by filtering specific attributes such as ID, name, state, owner, team, deadlines, or comments using advanced search options.
Instructions
Find Shortcut epics.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
comment | No | Find only epics matching the specified comment | |
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 epics matching the specified description | |
due | No | ||
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. | |
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. | |
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. | |
id | No | Find only epics with the specified public ID | |
isArchived | No | Find only entities that are archived when true, or only entities that are not archived 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. | |
isUnstarted | No | Find only entities that are unstarted when true, or only entities that are not unstarted when false. | |
name | No | Find only epics matching the specified name | |
objective | No | Find only epics 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. | |
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. | |
state | No | Find only epics matching the specified state | |
team | No | Find only epics matching the specified team. Should be a team's mention name. | |
updated | No |