ceven

Shortcut

Syncs product requirements and engineering tasks between your strategy docs and development board, automates story creation from feedback, and tracks objective progress in real time.

Try Shortcut in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Shortcut integration

    • Describe the outcome and Ceven picks the right Shortcut calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Shortcut data, across all 136 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Shortcut access.
    • Per user and per environment credentials instead of shared keys.

  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Shortcut, when, and on whose behalf.
    • The agent pauses and asks when Shortcut is unclear instead of plowing ahead.

  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Shortcut.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Shortcut action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Shortcut, and when to use it.

Create story
Use this to add a new story to your workspace. You must provide either a workflow state id or a project id.
Create epic
Use this to group related stories under a larger product goal or feature set.
Create objective
Define a high level company goal to track progress across multiple epics and stories.
Create iteration
Set up a time boxed period for completing a set of stories, typical for sprint planning.
Create story comment
Add a discussion point or update to a specific story for team visibility.
Create task
Break down a story into smaller, actionable checklist items.
Create story link
Establish a semantic relationship between two stories to show dependencies or blocks.
Create multiple stories
Use this to bulk upload several stories in one request to speed up backlog population.
Create label
Add a new organizational tag to categorize stories or epics by theme.
Create project
Initialize a new project container to house stories and track specific workstreams.
Create category
Organize your projects into broader categories for better workspace navigation.
Create group
Create a user group for easier mentions and assignment of bulk tasks.
Create entity template
Create a new entity template for the workspace.
Create epic comment
This endpoint allows you to create a threaded comment on an epic.
Create epic comment comment
This endpoint allows you to create a nested comment reply to an existing epic comment.
Create linked file
Create linked file allows you to create a new linked file in shortcut.
Create milestone
(deprecated: use 'create objective') create milestone allows you to create a new milestone in shortcut.
Create story from template
Create story from template is used to add a new story derived from a template to your shortcut workspace.
Create story reaction
Create a reaction to a story comment.
Delete category
Delete category can be used to delete any category.
Delete custom field
Deletes a specific custom field from the shortcut system using its unique public identifier. this endpoint should be used when you need to permanently remove a custom field that is no longer required in your workflows or project structure.
Delete entity template
Deletes a specific entity template from the shortcut api. this endpoint should be used when you need to permanently remove a template that is no longer needed or is obsolete. it's important to note that this operation cannot be undone, so i
Delete epic
Delete epic can be used to delete the epic. the only required parameter is epic id.
Delete epic comment
This endpoint allows you to delete a comment from an epic.
Delete file
Delete file deletes a previously uploaded file.
Delete iteration
Deletes a specific iteration from the shortcut project management system. this endpoint should be used when you need to permanently remove an iteration and all its associated data from your project workflow. it's particularly useful for cle
Delete label
Delete label can be used to delete any label.
Delete linked file
Delete linked file can be used to delete any previously attached linked file.
Delete milestone
(deprecated: use 'delete objective') delete milestone can be used to delete any milestone.
Delete multiple stories
Delete multiple stories allows you to delete multiple archived stories at once.

30 actions · scroll to see them all

Frequently asked questions

Ceven implements a smart queuing system to respect the Shortcut API rate limits. Shortcut imposes a limit on the number of requests per minute per token. If the agent detects a 429 Too Many Requests response, it automatically pauses the workflow and uses an exponential backoff strategy. This ensures that your integration remains stable even during heavy bulk operations like creating fifty stories at once. You will see a status indicator in the workflow log showing that the agent is waiting for the rate limit window to reset before resuming the remaining tasks.
Yes, but there is a specific requirement. According to the Shortcut API, a story must have either a project id or a workflow state id. If you do not provide a project, Ceven must know which workflow state the story should start in. If the agent has access to your workspace settings, it will pull the default starting state for your team. If no default is found and no project is specified, the API will reject the request. The agent is designed to check for these dependencies before sending the call to prevent failed workflow runs.
Ceven uses the subject verb object syntax required by Shortcut to create semantic relationships. When you tell the agent to link two stories, it determines the relationship type, such as blocks or relates to, based on your prompt. It then calls the create story link endpoint to bind the two IDs. This allows the agent to build complex dependency maps automatically. For example, if a story is marked as a prerequisite for another, the agent can ensure the second story is not moved into an active iteration until the first is closed.
Ceven can fully automate your iteration lifecycle. It can create a new iteration with a specific start and end date, then pull stories from the backlog based on priority or label to populate that iteration. It can also disable iterations entirely for the workspace if your team moves to a continuous flow model. The agent can monitor the end date of the current iteration and automatically trigger a notification to the team to perform a retrospective or move unfinished stories to the next period.
Yes, the agent uses the create multiple stories endpoint to minimize API overhead. Instead of making ten separate calls to create ten stories, Ceven bundles the data into a single request. This is particularly useful when converting a long list of requirements from a document into a Shortcut backlog. The agent parses the document, identifies the individual requirements, and pushes them as a batch. This process is faster and significantly reduces the risk of hitting the API rate limits mentioned earlier.
Ceven treats objectives as the top level of your hierarchy. It can create a new objective and then link multiple epics to it. As stories within those epics are completed, the agent can pull the completion percentage and update a separate reporting tool or send a progress update to a Slack channel. This creates a closed loop where low level engineering work automatically rolls up into high level business goals without any manual status reporting from the project manager.
The Shortcut API prevents the deletion of a project if it still contains stories. If Ceven attempts to delete a project and receives a 422 response, it will scan for any remaining stories. Depending on your workflow settings, the agent can either archive those stories, move them to a general backlog project, or alert you that the project cannot be deleted until the stories are handled. This prevents accidental data loss and ensures your workspace remains clean and organized.
Ceven can use the create story from template endpoint to ensure consistency across your tickets. If your team has predefined templates for bug reports or feature requests, the agent can trigger the specific template ID. This ensures that all necessary fields, such as reproduction steps or acceptance criteria, are included. The agent can then fill in the template variables using data pulled from the original trigger, such as a customer support ticket or a product requirement document.

Alternatives to Shortcut

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

Jira logoJiraLinear logoLinearMonday logoMondayAsana logoAsana

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Shortcut and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free