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
Name | Reference | Type | Required | Default | Options | Description |
---|---|---|---|---|---|---|
Access Token | SHORTCUT_ACCESS_TOKEN | Password | ✅ | - | - | In order to generate a Workspace specific API token, navigate to Settings > Your Account > API Tokens. |
Story Name | SHORTCUT_STORY_NAME | Alphanumeric | ✅ | - | - | The name/title of the new story. |
Workflow State ID | SHORTCUT_WORKFLOW_STATE_ID | Integer | ✅ | - | - | The ID of the workflow state for the new story. |
Description | SHORTCUT_DESCRIPTION | Alphanumeric | ➖ | - | - | The description of the new story. |
Story Type | SHORTCUT_STORY_TYPE | Select | ✅ | - | Feature: feature Bug: bug Chore: chore | The type of the new story (feature, bug, or chore). |
Labels | SHORTCUT_LABELS | Alphanumeric | ➖ | - | - | Comma-separated labels to be added to the new story. |
Deadline | SHORTCUT_DEADLINE | Alphanumeric | ➖ | - | - | The deadline for the new story. |
Tasks | SHORTCUT_TASKS | Alphanumeric | ➖ | - | - | Comma-separated tasks to be added to the new story. |
YAML
Below is the YAML template
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