create-story
Create new Shortcut stories by specifying a name and team or workflow, automatically placing them in the appropriate workflow state for project management.
Instructions
Create a new Shortcut story. Name is required, and either a Team or Workflow must be specified:
If only Team is specified, we will use the default workflow for that team.
If Workflow is specified, it will be used regardless of Team. The story will be added to the default state for the workflow.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The name of the story. Required. | |
| description | No | The description of the story | |
| type | No | The type of the story | feature |
| owner | No | The user id of the owner of the story | |
| epic | No | The epic id of the epic the story belongs to | |
| iteration | No | The iteration id of the iteration the story belongs to | |
| team | No | The team ID or mention name of the team the story belongs to. Required unless a workflow is specified. | |
| workflow | No | The workflow ID to add the story to. Required unless a team is specified. |
Input Schema (JSON Schema)
{
"properties": {
"description": {
"description": "The description of the story",
"maxLength": 10000,
"type": "string"
},
"epic": {
"description": "The epic id of the epic the story belongs to",
"type": "number"
},
"iteration": {
"description": "The iteration id of the iteration the story belongs to",
"type": "number"
},
"name": {
"description": "The name of the story. Required.",
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"owner": {
"description": "The user id of the owner of the story",
"type": "string"
},
"team": {
"description": "The team ID or mention name of the team the story belongs to. Required unless a workflow is specified.",
"type": "string"
},
"type": {
"default": "feature",
"description": "The type of the story",
"enum": [
"feature",
"bug",
"chore"
],
"type": "string"
},
"workflow": {
"description": "The workflow ID to add the story to. Required unless a team is specified.",
"type": "number"
}
},
"required": [
"name"
],
"type": "object"
}