--- title: "List Migrations" method: POST path: "/v1/namespaces/migrations/list" tags: ["Namespace Migrations"] --- # List Migrations `POST /v1/namespaces/migrations/list` List migrations with optional filters. Args: request: FastAPI request list_request: Filter and pagination parameters Returns: ListMigrationsResponse with migrations list ## Request body - ListMigrationsRequest — Request to list migrations with filters. - `status` 'draft' | 'validating' | 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled' — Migration execution status. - `migration_type` 're_extract' | 'copy' | 'extend' — Types of namespace migrations. - `source_namespace_id` string, nullable — Filter by source namespace - `limit` integer — Maximum results - `offset` integer — Result offset for pagination ## Response `200` Successful Response - ListMigrationsResponse — Response for listing migrations. - `results` GetMigrationResponse[], required — List of migrations - `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 - `total` integer, required — Total count matching filters - `limit` integer, required — Results limit - `offset` integer, required — Results offset ## 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/23e05292e326/schema)