# task_move_to_workspace

Move Task To Workspace

## Beschreibung

Moves a task to a different workspace. The task keeps its
comments, attachments, history, assignee, due date,
estimate and priority — but gets a fresh issue key on the
target workspace (e.g. ENG-12 → DEV-5). Labels are stripped
(labels are workspace-bound); the project is cleared unless you
pass `project_id` of a project that belongs to the target
workspace. Status is remapped to the equivalent column in the
target workspace when one exists (by `symbolic_key`).

Auth: moving an issue changes its identifier and outer access
boundary, so only account admins can perform this operation.

## 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_…). |
| `task_id` | string | Ja | Task prefix ID (task_…) or issue key (ENG-12). |
| `workspace_id` | string | Ja | Target workspace — prefix ID (wsp_…) or short key (e.g. DEV). Legacy team_ links remain accepted during migration. |
| `project_id` | string | Nein | Optional project prefix ID (proj_…). Must belong to the target workspace. Pass empty / omit to leave the task project-less after the move. |

## Eingabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Account prefix ID (acct_…)."
    },
    "task_id": {
      "type": "string",
      "description": "Task prefix ID (task_…) or issue key (ENG-12)."
    },
    "workspace_id": {
      "type": "string",
      "description": "Target workspace — prefix ID (wsp_…) or short key (e.g. DEV). Legacy team_ links remain accepted during migration."
    },
    "project_id": {
      "type": "string",
      "description": "Optional project prefix ID (proj_…). Must belong to the target workspace. Pass empty / omit to leave the task project-less after the move."
    }
  },
  "required": [
    "account_id",
    "task_id",
    "workspace_id"
  ],
  "type": "object"
}
```

## Ausgabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "task": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "key": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "previous_key": {
          "type": "string"
        },
        "cleared": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "id",
        "key",
        "title",
        "previous_key",
        "cleared"
      ]
    }
  },
  "required": [
    "task"
  ],
  "type": "object"
}
```