Skip to main content
Skip table of contents

Shortcut - Create Story

Overview

Use this blueprint to create a new story in Shortcut. The script requires an access token, story name, workflow state ID, and story type to create the new story. Optional arguments like description, labels, deadline, and tasks can also be provided to add additional details to the story.

Variables

NameReferenceTypeRequiredDefaultOptionsDescription
Access TokenSHORTCUT_ACCESS_TOKENPassword--In order to generate a Workspace specific API token, navigate to Settings > Your Account > API Tokens.
Story NameSHORTCUT_STORY_NAMEAlphanumeric--The name/title of the new story.
Workflow State IDSHORTCUT_WORKFLOW_STATE_IDInteger--The ID of the workflow state for the new story.
DescriptionSHORTCUT_DESCRIPTIONAlphanumeric--The description of the new story.
Story TypeSHORTCUT_STORY_TYPESelect-Feature: feature

Bug: bug

Chore: chore
The type of the new story (feature, bug, or chore).
LabelsSHORTCUT_LABELSAlphanumeric--Comma-separated labels to be added to the new story.
DeadlineSHORTCUT_DEADLINEAlphanumeric--The deadline for the new story.
TasksSHORTCUT_TASKSAlphanumeric--Comma-separated tasks to be added to the new story.

YAML

Below is the YAML template

YAML

source:
  template: Shortcut - Create Story
  inputs:
    SHORTCUT_ACCESS_TOKEN:
    SHORTCUT_STORY_NAME:
    SHORTCUT_WORKFLOW_STATE_ID:
    SHORTCUT_DESCRIPTION:
    SHORTCUT_STORY_TYPE:
    SHORTCUT_LABELS:
    SHORTCUT_DEADLINE:
    SHORTCUT_TASKS:
  type: TEMPLATE
guardrails:
  retry_count: 1
  retry_wait: 0h0m0s
  runtime_cutoff: 1h0m0s
  exclude_exit_code_ranges:
    - 200
    - 201
    - 202
    - 203

      
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.