update-story

update-story

Modify Shortcut stories by updating specific fields such as name, description, type, epic, estimate, owners, workflow state, or labels. Provide the story ID and only the fields to be changed for precise updates.

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
`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"
      ]
    },
    "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