Shortcut
Create and manage stories in Shortcut, the project management platform for software teams.
Connectors
Choose the connector that matches your authentication method. The options below use the names shown in StackAI.
Shortcut
API Token
Shortcut
Connect to Shortcut with a workspace API token to create and manage stories.
Set up in Shortcut
Prepare the Shortcut account or service that the workflow will access. Grant access to the required resources and operations.
API Token: Shortcut API token for your workspace. Create one in Shortcut under Settings > Account > API Tokens.
Set up in StackAI
Open Settings → Connections, add a connection, and select Shortcut.
Enter the credentials and connection details in the fields below.
Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.
Connection fields
API Token
Yes
Shortcut API token for your workspace. Create one in Shortcut under Settings > Account > API Tokens. Provider instructions.
Verify the connection
Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.
If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.
Use an action
Add the required Shortcut action to the workflow.
Select a connection when the action requests one.
Complete the required fields. Use the reference picker when a value comes from another workflow step.
Run the workflow and inspect the action’s output. Check the result before using it in a later step.
Actions
Create Story
Create a new story in Shortcut.
Inputs
Name
string
Yes
The story's title (max 512 characters).
Description
textarea
No
Optional details about the story.
Story Type
select (string)
No
The kind of story: feature, bug, or chore. Available values: Feature, Bug, Chore. Default: feature.
Workflow State
select (string)
No
Select a workflow state, or type its numeric ID manually. Options load from the selected connection.
Epic
select (string)
No
Select an epic to attach this story to, or type its numeric ID. Options load from the selected connection.
Deadline
datetime
No
Optional due date for the story.
Outputs
Story ID
integer
The numeric ID of the created story, for downstream nodes.
Name
string
The story's title.
Story URL
string
Link to the story in the Shortcut web app.
Story Type
string
The story's type: feature, bug, or chore.
Workflow State ID
integer
The numeric ID of the story's current workflow state.
Epic ID
integer
The numeric ID of the epic this story belongs to, if any.
Deadline
string
The story's due date, if set.
Created At
string
When the story was created.
Result Message
string
Human-readable result summary.
Search Stories
Search for stories in Shortcut using search operators.
Inputs
Query
string
Yes
Shortcut search query using search operators.
Page Size
integer
No
Number of stories to return per page (max 100).
Next Page Cursor
string
No
Cursor from a previous search's 'next' output, to fetch the next page.
Outputs
Stories
array
The stories matching the search query on this page.
Next Page Cursor
string
Cursor for the next page of results, or empty if this is the last page.
Story IDs
array
Numeric IDs of the matching stories, for downstream nodes.
Stories Count
integer
Number of stories returned on this page.
Result Message
string
Human-readable result summary.
Get Story
Fetch a single story from Shortcut by its ID.
Inputs
Story ID
string
Yes
The numeric ID of the story to fetch.
Outputs
Story ID
integer
The numeric ID of the story, for downstream nodes.
Name
string
The story's title.
Story URL
string
Link to the story in the Shortcut web app.
Story Type
string
The story's type: feature, bug, or chore.
Workflow State ID
integer
The numeric ID of the story's current workflow state.
Epic ID
integer
The numeric ID of the epic this story belongs to, if any.
Description
string
The story's description, if any.
Deadline
string
The story's due date, if set.
Estimate
integer
The story's point estimate, if set.
Archived
boolean
Whether the story is archived.
Created At
string
When the story was created.
Updated At
string
When the story was last updated.
Result Message
string
Human-readable result summary.
Update Story
Update a story in Shortcut. Only the fields you set are changed.
Inputs
Story ID
string
Yes
The numeric ID of the story to update.
Name
string
No
New title for the story. Leave blank to keep the current title.
Description
textarea
No
New description. Replaces the current description; leave blank to keep it.
Story Type
select (string)
No
New story type: feature, bug, or chore. Leave blank to keep the current type. Available values: Feature, Bug, Chore.
Workflow State
select (string)
No
Move the story to a different workflow state, or type its numeric ID. Options load from the selected connection.
Epic
select (string)
No
Attach the story to a different epic, or type its numeric ID. Options load from the selected connection.
Deadline
datetime
No
New due date for the story. Leave blank to keep the current deadline.
Archived
boolean
No
Archive or unarchive the story. Leave blank to keep its current state.
Estimate
integer
No
New point estimate for the story. Leave blank to keep the current estimate.
Labels
string
No
Comma-separated label names.
Outputs
Story ID
integer
The numeric ID of the updated story, for downstream nodes.
Name
string
The story's current title.
Story URL
string
Link to the story in the Shortcut web app.
Story Type
string
The story's current type: feature, bug, or chore.
Workflow State ID
integer
The numeric ID of the story's current workflow state.
Epic ID
integer
The numeric ID of the epic this story belongs to, if any.
Archived
boolean
Whether the story is archived after the update.
Updated At
string
When the story was last updated.
Result Message
string
Human-readable result summary.
Create Epic
Create a new epic in Shortcut.
Inputs
Name
string
Yes
The epic's title.
Description
textarea
No
Optional details about the epic.
Outputs
Epic ID
integer
The numeric ID of the created epic, for downstream nodes.
Name
string
The epic's title.
Description
string
The epic's description, if any.
Epic URL
string
Link to the epic in the Shortcut web app.
Archived
boolean
Whether the epic is archived.
Created At
string
When the epic was created.
Result Message
string
Human-readable result summary.
Important behavior
Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.
The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.
Last updated
Was this helpful?

