Sign in

v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB
Namespace Migrations

Start Migration

Start a migration execution.

Args: request: FastAPI request migration_id: Migration ID start_request: Start options

Returns: StartMigrationResponse with task ID

post/v1/namespaces/migrations/{migration_id}/start

Path parameters

migration_idstring required

Request body

forceboolean

Force start even if validation warnings exist

Response

Successful Response

migration_idstring required

Migration ID

status'draft' | 'validating' | 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled' required

Migration execution status.

task_idstring required

Task ID for tracking migration progress

started_atstring date-time required

Start timestamp

messagestring required

Human-readable message

Example response

{
  "message": "Migration started successfully. Track progress at GET /migrations/{id}",
  "migration_id": "mig_abc123xyz789",
  "started_at": "2025-12-03T10:05:00Z",
  "status": "pending",
  "task_id": "task_xyz789"
}