---
title: "Get Migration"
method: GET
path: "/v1/namespaces/migrations/{migration_id}"
tags: ["Namespace Migrations"]
---

# Get Migration

`GET /v1/namespaces/migrations/{migration_id}`

Get migration details and status.

Args:
    request: FastAPI request
    migration_id: Migration ID

Returns:
    GetMigrationResponse with full migration details

## Path parameters

- `migration_id` string, required

## Response `200`

Successful Response

- GetMigrationResponse — Response for getting migration details.
  - `migration_id` string, required — Migration ID
  - `internal_id` string, required — Organization internal ID
  - `namespace_id` string, required — Source namespace ID
  - `config` MigrationConfig, required — Configuration for a namespace migration.
    - `migration_type` 're_extract' | 'copy' | 'extend', required — Types of namespace migrations.
    - `source_namespace_id` string, required — Source namespace ID
    - `target_namespace_id` string, nullable — Target namespace ID (auto-generated if not provided)
    - `target_namespace_name` string, nullable — Name for target namespace
    - `feature_extractors` SharedNamespacesMigrationsModelsFeatureExtractorConfig[], nullable — New extractors to use (RE_EXTRACT only)
      - `feature_extractor_name` string, required — Name of the extractor
      - `version` string, nullable — Version to use
      - `parameters` object, nullable — Extractor parameters
    - `filters` ResourceFilter — Filters for selective resource migration.
      - `collection_ids` string[], nullable — Specific collection IDs to migrate
      - `taxonomy_ids` string[], nullable — Specific taxonomy IDs to migrate
      - `cluster_ids` string[], nullable — Specific cluster IDs to migrate
      - `retriever_ids` string[], nullable — Specific retriever IDs to migrate
      - `date_range` object, nullable — Date range filter (after, before)
      - `auto_include_dependencies` boolean — Automatically include required dependencies
    - `batch_options` BatchOptions — Options for batch processing in migration.
      - `batch_size` integer — Documents per batch
      - `max_workers` integer — Maximum parallel workers
      - `retry_failed` boolean — Retry failed batches
    - `taxonomy_options` TaxonomyOptions — Options for taxonomy migration.
      - `preserve_taxonomy_ids` boolean — Keep same taxonomy IDs in target
      - `preserve_enrichment_fields` boolean — Keep _taxonomy_* fields in documents
      - `re_run_enrichment` boolean — Re-run taxonomy enrichment after migration
      - `migrate_reference_collections` boolean — Automatically migrate reference collections
    - `cluster_options` ClusterOptions — Options for cluster migration.
      - `preserve_cluster_ids` boolean — Keep same cluster IDs in target
      - `preserve_assignments` boolean — Keep cluster_id in documents
      - `migrate_artifacts` boolean — Copy parquet artifacts from S3
      - `preserve_centroids` boolean — Keep centroid collections
      - `recompute_clusters` boolean — Recompute clusters instead of copying
    - `retriever_options` RetrieverOptions — Options for retriever migration.
      - `preserve_retriever_ids` boolean — Keep same retriever IDs (avoid conflicts)
      - `migrate_interactions` boolean — Migrate user interaction data
      - `migrate_execution_history` boolean — Migrate past execution history
      - `validate_references` boolean — Pre-flight check all references exist
    - `preserve_resource_ids` boolean — Preserve original resource IDs in target
    - `dry_run` boolean — Validate only, don't execute
    - `webhook_url` string, nullable — Webhook URL for status notifications
  - `status` 'draft' | 'validating' | 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled', required — Migration execution status.
  - `progress` MigrationProgress, required — Overall progress tracking for a migration.
    - `overall_status` 'draft' | 'validating' | 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled', required — Migration execution status.
    - `overall_progress_percent` number — Overall progress %
    - `current_stage` 'namespace_setup' | 'batch_creation' | 'batch_processing' | 'cluster_execution' | 'taxonomy_enrichment' | 'benchmark_evaluation' | 'finalization' — Stages of migration execution.
    - `stages` StageProgress[] — Progress for each stage
      - `stage` 'namespace_setup' | 'batch_creation' | 'batch_processing' | 'cluster_execution' | 'taxonomy_enrichment' | 'benchmark_evaluation' | 'finalization', required — Stages of migration execution.
      - `status` 'draft' | 'validating' | 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled', required — Migration execution status.
      - `started_at` string, date-time, nullable — Stage start time
      - `completed_at` string, date-time, nullable — Stage completion time
      - `progress_percent` number — Progress %
      - `items_total` integer — Total items to process
      - `items_completed` integer — Items completed
      - `items_failed` integer — Items failed
      - `error_message` string, nullable — Error if failed
    - `resources` ResourceProgress[] — Progress for each resource
      - `resource_id` string, required — Resource ID
      - `resource_type` 'bucket' | 'collection' | 'taxonomy' | 'cluster' | 'retriever', required — Types of resources that can be migrated.
      - `status` 'draft' | 'validating' | 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled', required — Migration execution status.
      - `progress_percent` number — Progress %
      - `error_message` string, nullable — Error if failed
    - `started_at` string, date-time, nullable — Migration start time
    - `estimated_completion` string, date-time, nullable — Estimated completion time
  - `validation_result` ValidationResult — Result of pre-flight validation.
    - `valid` boolean, required — Whether migration can proceed
    - `errors` ValidationError[] — Validation errors
      - `loc` union[], required
        - union
          - string
          - integer
      - `msg` string, required
      - `type` string, required
      - `input` unknown
      - `ctx` object
    - `warnings` ValidationError[] — Validation warnings
      - `loc` union[], required
        - union
          - string
          - integer
      - `msg` string, required
      - `type` string, required
      - `input` unknown
      - `ctx` object
    - `estimated_resources` object — Estimated resource counts
    - `estimated_duration_seconds` integer, nullable — Estimated migration duration
  - `dependency_graph` DependencyGraph — Dependency graph for migration ordering.
    - `nodes` DependencyNode[] — All resource nodes
      - `resource_id` string, required — Resource ID
      - `resource_type` 'bucket' | 'collection' | 'taxonomy' | 'cluster' | 'retriever', required — Types of resources that can be migrated.
      - `dependencies` string[] — IDs of resources this depends on
      - `tier` integer — Dependency tier (0=no deps)
    - `execution_order` string[] — Topologically sorted execution order
  - `task_id` string, nullable — Task ID for tracking migration progress
  - `created_at` string, date-time, required — Creation timestamp
  - `started_at` string, date-time, nullable — Start timestamp
  - `completed_at` string, date-time, nullable — Completion timestamp
  - `error_message` string, nullable — Error if failed
  - `additional_data` object — Additional metadata

## 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/revisions/04b379bdbb7c/schema)