Skip to main content
POST
/
tasks
/
migrate
Migrate Tasks Between Versions
curl --request POST \
  --url https://api.example.com/tasks/migrate \
  --header 'Content-Type: application/json' \
  --data '
{
  "from_version_id": "<string>",
  "task_ids": [
    "<string>"
  ],
  "to_latest": false,
  "to_version_id": "<string>"
}
'
{
  "branch_id": "<string>",
  "tasks": [
    {
      "filesystem_id": "<string>",
      "id": "<string>",
      "namespace_id": "<string>",
      "agents": [
        {
          "created_at": "2023-11-07T05:31:56Z",
          "description": "<string>",
          "id": "<string>",
          "name": "<string>",
          "namespace_id": "<string>",
          "updated_at": "2023-11-07T05:31:56Z",
          "agent_input_type": "text",
          "registered_at": "2023-11-07T05:31:56Z",
          "registration_metadata": {},
          "status": "ACTIVE",
          "status_reason": "<string>"
        }
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "created_version_id": "<string>",
      "current_version_id": "<string>",
      "name": "<string>",
      "params": {},
      "status": "IDLE",
      "status_reason": "<string>",
      "task_metadata": {},
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "to_version": {
    "acp_type": "sync",
    "author_email": "<string>",
    "author_name": "<string>",
    "branch_id": "<string>",
    "deployed_at": "2023-11-07T05:31:56Z",
    "git_branch": "<string>",
    "git_hash": "<string>",
    "id": "<string>",
    "image_url": "<string>",
    "sdk_type": "claude_agent_sdk",
    "status": "DEPLOYING",
    "created_at": "2023-11-07T05:31:56Z",
    "failure_diagnostics": {},
    "failure_reason": "<string>",
    "git_message": "",
    "image_expires_at": "2023-11-07T05:31:56Z",
    "is_dirty": false,
    "last_rollback_at": "2023-11-07T05:31:56Z",
    "replicas": 0,
    "retired_at": "2023-11-07T05:31:56Z",
    "rollback_count": 0,
    "rolled_back_at": "2023-11-07T05:31:56Z",
    "source_filesystem_id": "<string>",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "from_version_id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.terminaluse.com/llms.txt

Use this file to discover all available pages before exploring further.

Migrate tasks between versions within the same branch. Supports two modes:
  • Bulk migration: Migrate all tasks from a source version (from_version_id)
  • Specific tasks: Migrate specific tasks (task_ids)
Target can be explicit (to_version_id) or the latest active version (to_latest).

Body

application/json

Request model for migrating tasks between versions.

​
from_version_id
string | null

Migrate ALL RUNNING tasks from this version

​
task_ids
string[] | null

OR migrate specific task IDs

​
to_latest
boolean
default:false

OR migrate to ACTIVE/DEPLOYING version on branch

​
to_version_id
string | null

Explicit target version ID

Response

Successful Response

Response model for task migration operation.

​
branch_id
string
required

Branch both versions belong to

​
tasks
TaskResponse · object[]
required

Migrated tasks

​
to_version
VersionResponse · object
required

Target version details

​
from_version_id
string | null

Source version (if bulk mode)