{
  "name": "save_issue",
  "description": "Create or update a Linear issue. If `id` is provided, updates the existing issue; otherwise creates a new one. When creating, `title` and `team` are required. Note: use `assignee` (not `assigneeId`) to set the assignee — it accepts a user ID, name, email, or \"me\".",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "id": {
        "description": "Only for updating an existing issue. Pass the issue ID or identifier (e.g., LIN-123). Do NOT pass this parameter when creating a new issue.",
        "type": "string"
      },
      "title": {
        "description": "Issue title (required when creating)",
        "type": "string"
      },
      "description": {
        "description": "Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)",
        "type": "string"
      },
      "team": {
        "description": "Team name or ID (required when creating)",
        "type": "string"
      },
      "cycle": {
        "description": "Cycle name, number, or ID. Null to remove",
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ]
      },
      "milestone": {
        "description": "Milestone name or ID",
        "type": "string"
      },
      "priority": {
        "description": "0=None, 1=Urgent, 2=High, 3=Medium, 4=Low",
        "type": "number"
      },
      "project": {
        "description": "Project name, ID, or slug",
        "type": "string"
      },
      "state": {
        "description": "State type, name, or ID",
        "type": "string"
      },
      "assignee": {
        "description": "User ID, name, email, or \"me\". Null to remove",
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ]
      },
      "delegate": {
        "description": "Agent name or ID. When the user asks to delegate to \"Linear\" or \"the Linear agent\", this refers to the \"Linear\" app user specifically. Null to remove",
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ]
      },
      "labels": {
        "description": "Label names or IDs",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "dueDate": {
        "description": "Due date (ISO format)",
        "type": "string"
      },
      "parentId": {
        "description": "Parent issue ID or identifier (e.g., LIN-123). Null to remove",
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ]
      },
      "estimate": {
        "description": "Issue estimate value. On create, pass null or omit for no estimate. On update, pass null to clear the estimate; omitting leaves it unchanged. 0 is a real estimate only on teams that allow zero estimates.",
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ]
      },
      "links": {
        "description": "Link attachments to add [{url, title}]. Append-only; existing links are never removed",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "url": {
              "type": "string",
              "format": "uri"
            },
            "title": {
              "type": "string",
              "minLength": 1
            }
          },
          "required": [
            "url",
            "title"
          ]
        }
      },
      "releases": {
        "description": "Release IDs or slugs to set on the issue. Cannot be combined with addReleases/removeReleases",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "addReleases": {
        "description": "Release IDs or slugs to add. Append-only; existing releases are never removed",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "removeReleases": {
        "description": "Release IDs or slugs to remove. Only valid when updating an existing issue",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "blocks": {
        "description": "Issue IDs/identifiers this blocks. Append-only; existing relations are never removed",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "blockedBy": {
        "description": "Issue IDs/identifiers blocking this. Append-only; existing relations are never removed",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "relatedTo": {
        "description": "Related issue IDs/identifiers. Append-only; existing relations are never removed",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "duplicateOf": {
        "description": "Duplicate of issue ID/identifier. Null to remove",
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ]
      },
      "removeBlocks": {
        "description": "Issue IDs/identifiers to stop blocking",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "removeBlockedBy": {
        "description": "Issue IDs/identifiers to remove as blockers of this issue",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "removeRelatedTo": {
        "description": "Related issue IDs/identifiers to remove",
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "additionalProperties": false
  }
}