update-story
Modify existing Shortcut stories by updating fields like name, description, type, epic, estimate, iteration, owners, workflow state, and labels using the story's public ID.
Instructions
Update an existing Shortcut story. Only provide fields you want to update. The story public ID will always be included in updates.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| storyPublicId | Yes | The public ID of the story to update | |
| name | No | The name of the story | |
| description | No | The description of the story | |
| type | No | The type of the story | |
| epic | No | The epic id of the epic the story belongs to, or null to unset | |
| estimate | No | The point estimate of the story, or null to unset | |
| iteration | No | The iteration id of the iteration the story belongs to, or null to unset | |
| owner_ids | No | Array of user UUIDs to assign as owners of the story | |
| workflow_state_id | No | The workflow state ID to move the story to | |
| labels | No | Labels to assign to the story |
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, or null to unset",
"type": [
"number",
"null"
]
},
"estimate": {
"description": "The point estimate of the story, or null to unset",
"type": [
"number",
"null"
]
},
"iteration": {
"description": "The iteration id of the iteration the story belongs to, or null to unset",
"type": [
"number",
"null"
]
},
"labels": {
"description": "Labels to assign to the story",
"items": {
"additionalProperties": false,
"properties": {
"color": {
"description": "The color of the label",
"type": "string"
},
"description": {
"description": "The description of the label",
"type": "string"
},
"name": {
"description": "The name of the label",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": "array"
},
"name": {
"description": "The name of the story",
"maxLength": 512,
"type": "string"
},
"owner_ids": {
"description": "Array of user UUIDs to assign as owners of the story",
"items": {
"type": "string"
},
"type": "array"
},
"storyPublicId": {
"description": "The public ID of the story to update",
"exclusiveMinimum": 0,
"type": "number"
},
"type": {
"description": "The type of the story",
"enum": [
"feature",
"bug",
"chore"
],
"type": "string"
},
"workflow_state_id": {
"description": "The workflow state ID to move the story to",
"type": "number"
}
},
"required": [
"storyPublicId"
],
"type": "object"
}