---
title: "Start Migration"
method: POST
path: "/v1/namespaces/migrations/{migration_id}/start"
tags: ["Namespace Migrations"]
---

# Start Migration

`POST /v1/namespaces/migrations/{migration_id}/start`

Start a migration execution.

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

Returns:
    StartMigrationResponse with task ID

## Path parameters

- `migration_id` string, required

## Request body

- StartMigrationRequest — Request to start a migration.
  - `force` boolean — Force start even if validation warnings exist

## Response `200`

Successful Response

- StartMigrationResponse — Response after starting a migration.
  - `migration_id` string, required — Migration ID
  - `status` 'draft' | 'validating' | 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled', required — Migration execution status.
  - `task_id` string, required — Task ID for tracking migration progress
  - `started_at` string, date-time, required — Start timestamp
  - `message` string, required — Human-readable message

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/versions/220a3b263fda/schema)