update-story

update-story

Modify and manage Shortcut stories by updating specific fields such as name, description, type, or workflow state. Includes assigning owners, labels, and adjusting iteration or epic details based on provided 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
`description`	No	The description 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
`labels`	No	Labels to assign to the story
`name`	No	The name of the story
`owner_ids`	No	Array of user UUIDs to assign as owners of the story
`storyPublicId`	Yes	The public ID of the story to update
`type`	No	The type of the story
`workflow_state_id`	No	The workflow state ID to move the story to

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "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"
}

Shortcut MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Shortcut MCP Server

Related Tools

MCP directory API