Shortcut
for LuumenAI
Read epics, docs, and templates in Shortcut, and post updates as approved steps.
Connect Shortcut and Luumen can read your epics, their health history, comments, docs, categories, and entity templates without leaving the terminal. When work needs recording — a health update on a slipping epic, a comment with incident context, a new doc — Luumen drafts the change, shows it to you, and waits for approval before writing. Authentication is by API key.
The Shortcut toolbox
136 tools: 67 read, 69 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadGet categoryGet Category returns information about the selected Category.
- ReadGet current member infoReturns information about the authenticated member.
- ReadGet custom fieldRetrieves detailed information about a specific custom field in Shortcut using its unique public identifier.
- ReadGet docGet Doc returns information about a chosen Doc by its public ID.
- ReadGet entity templateGet Entity Template returns information about a given entity template.
- ReadGet epicGet Epic returns information about the selected Epic.
- ReadGet epic commentThis endpoint returns information about the selected Epic Comment.
- ReadGet epic healthGet the current health status for the specified Epic.
- ReadGet epic workflowReturns the Epic Workflow for the Workspace.
- ReadGet external link storiesGet Stories which have a given External Link associated with them.
- ReadGet fileGet File returns information about the selected UploadedFile.
- ReadGet generic integrationGet Generic Integration returns information about a webhook integration by its ID.
- ReadGet groupRetrieves detailed information about a specific group in the Shortcut workspace using its unique public identifier.
- ReadGet iterationRetrieves detailed information about a specific iteration in the Shortcut project management system.
- ReadGet key resultGet Key Result returns information about a chosen Key Result.
- ReadGet labelGet Label returns information about the selected Label.
- ReadGet linked fileGet File returns information about the selected Linked File.
- ReadGet memberReturns information about a Member.
- ReadGet objectiveGet Objective returns information about a chosen Objective.
- ReadGet projectGet Project returns information about the selected Project.
- ReadGet repositoryGet Repository returns information about the selected Repository.
- ReadGet storyGet Story returns information about a chosen Story.
- ReadGet story commentGet Comment is used to get Comment information.
- ReadGet story linkReturns the stories and their relationship for the given Story Link.
- ReadGet taskReturns information about a chosen Task.
- ReadGet workflowGet Workflow returns information about a chosen Workflow.
- ReadList categoriesList Categories returns a list of all Categories and their attributes.
- ReadList category milestonesList Category Milestones returns a list of all Milestones with the Category.
- ReadList category objectivesReturns a list of all Objectives with the Category.
- ReadList custom fieldsRetrieves a list of all custom fields defined in the Shortcut API.
- ReadList docsList Docs that the current user can read.
- ReadList document epicsRetrieve all Epics related to a specific Document.
- ReadList entity templatesList all the entity templates for the Workspace.
- ReadList epic commentsGet a list of all Comments on an Epic.
- ReadList epic documentsGet a list of all Documents related to this Epic.
- ReadList epic healthsList the history of health statuses for the specified Epic, most recent first.
- ReadList epicsList Epics returns a list of all Epics and their attributes.
- ReadList epics paginatedList Epics with pagination returns a paginated list of Epics and their attributes.
- ReadList epic storiesGet a list of all Stories in an Epic.
- ReadList filesList Files returns a list of all UploadedFiles in the workspace.
- ReadList groupsA group in our API maps to a "Team" within the Shortcut Product.
- ReadList group storiesList the Stories assigned to the Group.
- ReadList iterationsRetrieves a list of all iterations in the Shortcut project management system.
- ReadList iteration storiesGet a list of all Stories in an Iteration.
- ReadList label epicsList all of the Epics with the Label.
- ReadList labelsList Labels returns a list of all Labels and their attributes.
- ReadList label storiesList all of the Stories with the Label.
- ReadList linked filesList Linked Files returns a list of all Linked-Files and their attributes.
- ReadList membersReturns information about members of the Workspace.
- ReadList members (slim)Returns minimal member data optimized for Korey integration.
- ReadList objective epicsList all of the Epics within the Objective.
- ReadList objectivesList Objectives returns a list of all Objectives and their attributes.
- ReadList projectsList Projects returns a list of all Projects and their attributes.
- ReadList repositoriesList Repositories returns a list of all Repositories and their attributes.
- ReadList storiesList Stories returns a list of all Stories in a selected Project and their attributes.
- ReadList story commentLists Comments associated with a Story
- ReadList story sub-tasksList all Sub-task Stories for a given parent Story.
- ReadList workflowsReturns a list of all Workflows in the Workspace.
- ReadSearchSearch lets you search Epics and Stories based on desired parameters.
- ReadSearch documentsSearch Documents based on title and filters.
- ReadSearch epicsSearch Epics lets you search Epics based on desired parameters.
- ReadSearch iterationsSearch Iterations lets you search Iterations based on desired parameters.
- ReadSearch milestonesSearch Milestones lets you search Milestones based on desired parameters.
- ReadSearch objectivesSearch Objectives lets you search Objectives based on desired parameters.
- ReadSearch storiesSearch Stories lets you search Stories based on desired parameters.
- ReadSearch stories oldSearch Stories lets you search Stories based on desired parameters.
- ReadStory historyRetrieves the complete history of changes for a specific story in the Shortcut project management system.
- WriteCreate categoryCreate Category allows you to create a new Category in Shortcut. Approval by default
- WriteCreate docCreate Doc allows you to create a new document in Shortcut. Approval by default
- WriteCreate entity templateCreate a new entity template for the Workspace. Approval by default
- WriteCreate epicCreate Epic allows you to create a new Epic in Shortcut. Approval by default
- WriteCreate epic commentThis endpoint allows you to create a threaded Comment on an Epic. Approval by default
- WriteCreate epic comment commentThis endpoint allows you to create a nested Comment reply to an existing Epic Comment. Approval by default
- WriteCreate epic healthCreate a new health status for the specified Epic. Approval by default
- WriteCreate generic integrationCreate a generic webhook integration in Shortcut. Approval by default
- WriteCreate groupCreates a new group in the Shortcut system with customizable properties. Approval by default
- WriteCreate iterationThe CreateIteration endpoint allows you to create a new Iteration in Shortcut, which represents a time-boxed period for completing a set of stories or tasks. Approval by default
- WriteCreate labelCreate Label allows you to create a new Label in Shortcut. Approval by default
- WriteCreate linked fileCreate Linked File allows you to create a new Linked File in Shortcut. Approval by default
- WriteCreate multiple storiesCreate 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). Approval by default
- WriteCreate objectiveCreate Objective allows you to create a new Objective in Shortcut. Approval by default
- WriteCreate projectCreate Project is used to create a new Shortcut Project. Approval by default
- WriteCreate storyCreate Story is used to add a new story to your Shortcut Workspace. Approval by default
- WriteCreate story commentCreate Comment allows you to create a Comment on any Story. Approval by default
- WriteCreate story from templateCreate Story From Template is used to add a new story derived from a template to your Shortcut Workspace. Approval by default
- WriteCreate story linkStory Links (called Story Relationships in the UI) allow you create semantic relationships between two stories. Approval by default
- WriteCreate story reactionCreate a reaction to a story comment. Approval by default
- WriteCreate taskCreate Task is used to create a new task in a Story. Approval by default
- WriteDelete categoryDelete Category can be used to delete any Category. Approval by default
- WriteDelete custom fieldDeletes a specific custom field from the Shortcut system using its unique public identifier. Approval by default
- WriteDelete docPermanently deletes a Doc and its associated data from Shortcut. Approval by default
- WriteDelete entity templateDeletes a specific entity template from the Shortcut API. Approval by default
- WriteDelete epicDelete Epic can be used to delete the Epic. Approval by default
- WriteDelete epic commentThis endpoint allows you to delete a Comment from an Epic. Approval by default
- WriteDelete fileDelete File deletes a previously uploaded file. Approval by default
- WriteDelete generic integrationDelete a generic webhook integration from Shortcut. Approval by default
- WriteDelete iterationDeletes a specific iteration from the Shortcut project management system. Approval by default
- WriteDelete labelDelete Label can be used to delete any Label. Approval by default
- WriteDelete linked fileDelete Linked File can be used to delete any previously attached Linked-File. Approval by default
- WriteDelete multiple storiesDelete Multiple Stories allows you to delete multiple archived stories at once. Approval by default
- WriteDelete objectiveDelete Objective can be used to delete any Objective. Approval by default
- WriteDelete projectDelete Project can be used to delete a Project. Approval by default
- WriteDelete storyDelete Story can be used to delete any Story. Approval by default
- WriteDelete story commentDelete a Comment from any story. Approval by default
- WriteDelete story linkRemoves the relationship between the stories for the given Story Link. Approval by default
- WriteDelete story reactionDelete a reaction from any story comment. Approval by default
- WriteDelete taskDelete Task can be used to delete any previously created Task on a Story. Approval by default
- WriteDisable iterationsDisables Iterations for the current workspace Approval by default
- WriteDisable story templatesDisables the Story Template feature for the Workspace. Approval by default
- WriteEnable iterationsEnables Iterations for the current workspace Approval by default
- WriteEnable story templatesEnables the Story Template feature for the Workspace. Approval by default
- WriteLink document to epicCreate a relationship between a Document and an Epic. Approval by default
- WriteUnlink comment thread from slackUnlinks a Comment from its linked Slack thread (Comment replies and Slack replies will no longer be synced) Approval by default
- WriteUnlink document from epicRemove the relationship between a Document and an Epic. Approval by default
- WriteUnlink productboard from epicThis endpoint allows you to unlink a productboard epic. Approval by default
- WriteUpdate categoryUpdate Category allows you to replace a Category name with another name. Approval by default
- WriteUpdate custom fieldUpdate Custom Field can be used to update the definition of a Custom Field. Approval by default
- WriteUpdate DocUpdate an existing Doc's title and/or content. Approval by default
- WriteUpdate entity templateUpdate an entity template's name or its contents. Approval by default
- WriteUpdate epicUpdate Epic can be used to update numerous fields in the Epic. Approval by default
- WriteUpdate epic commentThis endpoint allows you to update a threaded Comment on an Epic. Approval by default
- WriteUpdate fileUpdate File updates the properties of an UploadedFile (but not its content). Approval by default
- WriteUpdate groupUpdates an existing group in the Shortcut workspace. Approval by default
- WriteUpdate health statusUpdate an existing health status by its ID. Approval by default
- WriteUpdate iterationThis endpoint allows you to update an existing iteration in Shortcut. Approval by default
- WriteUpdate key resultUpdate Key Result allows updating a Key Result's name or initial, observed, or target values. Approval by default
- WriteUpdate labelUpdate Label allows you to replace a Label name with another name. Approval by default
- WriteUpdate linked fileUpdated Linked File allows you to update properties of a previously attached Linked-File. Approval by default
- WriteUpdate multiple storiesUpdate Multiple Stories allows you to make changes to numerous stories at once. Approval by default
- WriteUpdate objectiveUpdate Objective can be used to update Objective properties. Approval by default
- WriteUpdate projectUpdate Project can be used to change properties of a Project. Approval by default
- WriteUpdate storyUpdate Story can be used to update Story properties. Approval by default
- WriteUpdate story commentUpdate Comment replaces the text of the existing Comment. Approval by default
- WriteUpdate story linkUpdates the stories and/or the relationship for the given Story Link. Approval by default
- WriteUpdate taskUpdate Task can be used to update Task properties. Approval by default
- WriteUpload filesUpload Files uploads one or many files and optionally associates them with a story. Approval by default
One prompt, start to finish
What a governed Shortcut run looks like inside Luumen.
Questions
How does LuumenAI connect to Shortcut?
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in Shortcut on its own?
Read actions answer immediately. Anything that writes — create category, create doc, create entity template, create epic, and more — is shown as a plan and requires approval by default, including the 23 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to Shortcut — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Put Shortcut to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.