RyTask docs
MCP tools

update_issue

Update a work item's fields (optimistic version; logs activity per field) — a RyTask MCP tool for AI agents over the Model Context Protocol (requires the work:write permission).

View as MarkdownOpen in ChatGPTOpen in Claude

Update a work item's fields (optimistic version; logs activity per field).

Required permissionwork:write
Capability IDworkItems.update
DestructiveNo

Parameters

ParameterTypeRequiredNotes
versionintegeryes
titlestringno
descriptionstring | nullno
statusIdstring (uuid)no
priorityURGENT | HIGH | MEDIUM | LOW | NONEno
assigneeIdstring (uuid) | nullno
parentIdstring (uuid) | nullno
estimateValuenumber | nullno
startDatestring | nullno
endDatestring | nullno
dueDatestring | nullno
idstring (uuid)yes

Input schema (JSON Schema)

{
  "type": "object",
  "properties": {
    "version": {
      "type": "integer",
      "minimum": 0
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "statusId": {
      "type": "string",
      "format": "uuid"
    },
    "priority": {
      "type": "string",
      "enum": [
        "URGENT",
        "HIGH",
        "MEDIUM",
        "LOW",
        "NONE"
      ]
    },
    "assigneeId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ]
    },
    "parentId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ]
    },
    "estimateValue": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ]
    },
    "startDate": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "/^\\d{4}-\\d{2}-\\d{2}$/"
        },
        {
          "type": "null"
        }
      ]
    },
    "endDate": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "/^\\d{4}-\\d{2}-\\d{2}$/"
        },
        {
          "type": "null"
        }
      ]
    },
    "dueDate": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "/^\\d{4}-\\d{2}-\\d{2}$/"
        },
        {
          "type": "null"
        }
      ]
    },
    "id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "version",
    "id"
  ],
  "additionalProperties": false
}

Access control

A call succeeds only when the personal access token's scopes and the holder's role both allow work:write (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.

On this page