Zum Inhalt
Für Agenten

MCP Reference

roadmap_entry_move

Move Roadmap Entry

Markdown Tools als JSON

Beschreibung

Moves a roadmap entry to a different roadmap in the same workspace. The entry keeps its title, description, status, dates and every linked project — only its parent roadmap (and a fresh tail position) change. An entry_moved activity is written to BOTH roadmaps' feeds.

Same-workspace only: an entry inherits its roadmap's workspace and its project links are workspace-bound, so a cross-workspace target is rejected. Move the projects' workspace or unlink first if you need to reorganise across workspaces.

Two-step confirmation (the move is not silent): the first call — with confirm omitted or false — performs NO change and returns a preview (confirm_required: true) describing the source and target. Repeat the call with confirm: true to actually move the entry. Surface the preview to the user and get their go-ahead before confirming.

Auth: the actor must be able to update both the entry's current roadmap and the target roadmap.

Zugriff

Zugriffsprofil: gated. Module: projects_tasks. Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

Parameter

Name Typ Pflicht Beschreibung
account_id string Ja Account prefix ID (acct_…).
id string Ja Entry prefix ID (rent_…).
target_roadmap_id string Ja Destination roadmap prefix ID (rmap_…). Must be in the same workspace as the entry.
confirm boolean Nein Must be true to execute. Omit/false returns a dry-run preview and changes nothing.

Eingabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Account prefix ID (acct_…)."
    },
    "id": {
      "type": "string",
      "description": "Entry prefix ID (rent_…)."
    },
    "target_roadmap_id": {
      "type": "string",
      "description": "Destination roadmap prefix ID (rmap_…). Must be in the same workspace as the entry."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true to execute. Omit/false returns a dry-run preview and changes nothing."
    }
  },
  "required": [
    "account_id",
    "id",
    "target_roadmap_id"
  ],
  "type": "object"
}

Ausgabeschema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "moved": {
      "type": "boolean",
      "description": "True once the move has been executed; false on a preview."
    },
    "confirm_required": {
      "type": "boolean",
      "description": "True on a preview — call again with confirm: true to execute."
    },
    "from": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "title": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "title"
      ]
    },
    "to": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "title": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "title"
      ]
    },
    "entry": {
      "type": "object",
      "description": "The entry payload (current state on preview, post-move state on execute)."
    }
  },
  "required": [
    "moved",
    "from",
    "to",
    "entry"
  ],
  "type": "object"
}
Seiten