> ## Documentation Index > Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Migrations > List migrations with optional filters. Args: request: FastAPI request list_request: Filter and pagination parameters Returns: ListMigrationsResponse with migrations list ## OpenAPI ````yaml post /v1/namespaces/migrations/list openapi: 3.1.0 info: title: Mixpeek API description: >- This is the Mixpeek API, providing access to various endpoints for data processing and retrieval. termsOfService: https://mixpeek.com/terms contact: name: Mixpeek Support url: https://mixpeek.com/contact email: info@mixpeek.com version: '0.82' servers: - url: https://api.mixpeek.com description: Production security: [] paths: /v1/namespaces/migrations/list: post: tags: - Namespace Migrations summary: List Migrations description: |- List migrations with optional filters. Args: request: FastAPI request list_request: Filter and pagination parameters Returns: ListMigrationsResponse with migrations list operationId: list_migrations_v1_namespaces_migrations_list_post parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ListMigrationsRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ListMigrationsResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: ListMigrationsRequest: properties: status: anyOf: - $ref: '#/components/schemas/MigrationStatus' - type: 'null' description: Filter by status migration_type: anyOf: - $ref: '#/components/schemas/MigrationType' - type: 'null' description: Filter by type source_namespace_id: anyOf: - type: string - type: 'null' title: Source Namespace Id description: Filter by source namespace limit: type: integer maximum: 1000 minimum: 1 title: Limit description: Maximum results default: 20 offset: type: integer minimum: 0 title: Offset description: Result offset for pagination default: 0 type: object title: ListMigrationsRequest description: Request to list migrations with filters. ListMigrationsResponse: properties: results: items: $ref: '#/components/schemas/GetMigrationResponse' type: array title: Results description: List of migrations total: type: integer title: Total description: Total count matching filters limit: type: integer title: Limit description: Results limit offset: type: integer title: Offset description: Results offset type: object required: - results - total - limit - offset title: ListMigrationsResponse description: Response for listing migrations. ErrorResponse: properties: success: type: boolean title: Success description: Always false for error responses default: false status: type: integer title: Status description: HTTP status code for this error error: $ref: '#/components/schemas/ErrorDetail' description: Error details payload type: object required: - status - error title: ErrorResponse description: Error response model. examples: - error: details: id: ns_123 resource: namespace message: Namespace not found type: NotFoundError status: 404 success: false HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError MigrationStatus: type: string enum: - draft - validating - pending - in_progress - completed - failed - cancelled title: MigrationStatus description: Migration execution status. MigrationType: type: string enum: - re_extract - copy - extend title: MigrationType description: Types of namespace migrations. GetMigrationResponse: properties: migration_id: type: string title: Migration Id description: Migration ID internal_id: type: string title: Internal Id description: Organization internal ID namespace_id: type: string title: Namespace Id description: Source namespace ID config: $ref: '#/components/schemas/MigrationConfig' description: Migration configuration status: $ref: '#/components/schemas/MigrationStatus' description: Current status progress: $ref: '#/components/schemas/MigrationProgress' description: Progress tracking validation_result: anyOf: - $ref: '#/components/schemas/ValidationResult' - type: 'null' description: Validation result dependency_graph: anyOf: - $ref: '#/components/schemas/DependencyGraph' - type: 'null' description: Dependency graph task_id: anyOf: - type: string - type: 'null' title: Task Id description: Task ID for tracking migration progress created_at: type: string format: date-time title: Created At description: Creation timestamp started_at: anyOf: - type: string format: date-time - type: 'null' title: Started At description: Start timestamp completed_at: anyOf: - type: string format: date-time - type: 'null' title: Completed At description: Completion timestamp error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error if failed additional_data: additionalProperties: true type: object title: Additional Data description: Additional metadata type: object required: - migration_id - internal_id - namespace_id - config - status - progress - created_at title: GetMigrationResponse description: Response for getting migration details. ErrorDetail: properties: message: type: string title: Message description: Human-readable error message type: type: string title: Type description: Stable error type identifier (machine-readable) code: anyOf: - type: string - type: 'null' title: Code description: >- Fine-grained error code for programmatic handling (e.g., namespace_name_taken, feature_extractor_not_found). Present only when consumers may need to branch on a specific error condition. details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details description: >- Optional structured details to help debugging (validation errors, IDs, etc.) type: object required: - message - type title: ErrorDetail description: Error detail model. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError MigrationConfig: properties: migration_type: $ref: '#/components/schemas/MigrationType' description: Type of migration to perform source_namespace_id: type: string title: Source Namespace Id description: Source namespace ID target_namespace_id: anyOf: - type: string - type: 'null' title: Target Namespace Id description: Target namespace ID (auto-generated if not provided) target_namespace_name: anyOf: - type: string - type: 'null' title: Target Namespace Name description: Name for target namespace feature_extractors: anyOf: - items: $ref: >- #/components/schemas/shared__namespaces__migrations__models__FeatureExtractorConfig type: array - type: 'null' title: Feature Extractors description: New extractors to use (RE_EXTRACT only) filters: anyOf: - $ref: '#/components/schemas/ResourceFilter' - type: 'null' description: Resource selection filters batch_options: anyOf: - $ref: '#/components/schemas/BatchOptions' - type: 'null' description: Batch processing options taxonomy_options: anyOf: - $ref: '#/components/schemas/TaxonomyOptions' - type: 'null' description: Taxonomy migration options cluster_options: anyOf: - $ref: '#/components/schemas/ClusterOptions' - type: 'null' description: Cluster migration options retriever_options: anyOf: - $ref: '#/components/schemas/RetrieverOptions' - type: 'null' description: Retriever migration options preserve_resource_ids: type: boolean title: Preserve Resource Ids description: Preserve original resource IDs in target default: false dry_run: type: boolean title: Dry Run description: Validate only, don't execute default: false webhook_url: anyOf: - type: string - type: 'null' title: Webhook Url description: Webhook URL for status notifications type: object required: - migration_type - source_namespace_id title: MigrationConfig description: Configuration for a namespace migration. MigrationProgress: properties: overall_status: $ref: '#/components/schemas/MigrationStatus' description: Overall migration status overall_progress_percent: type: number maximum: 100 minimum: 0 title: Overall Progress Percent description: Overall progress % default: 0 current_stage: anyOf: - $ref: '#/components/schemas/MigrationStage' - type: 'null' description: Currently executing stage stages: items: $ref: '#/components/schemas/StageProgress' type: array title: Stages description: Progress for each stage resources: items: $ref: '#/components/schemas/ResourceProgress' type: array title: Resources description: Progress for each resource started_at: anyOf: - type: string format: date-time - type: 'null' title: Started At description: Migration start time estimated_completion: anyOf: - type: string format: date-time - type: 'null' title: Estimated Completion description: Estimated completion time type: object required: - overall_status title: MigrationProgress description: Overall progress tracking for a migration. ValidationResult: properties: valid: type: boolean title: Valid description: Whether migration can proceed errors: items: $ref: '#/components/schemas/ValidationError' type: array title: Errors description: Validation errors warnings: items: $ref: '#/components/schemas/ValidationError' type: array title: Warnings description: Validation warnings estimated_resources: additionalProperties: type: integer propertyNames: $ref: >- #/components/schemas/shared__namespaces__migrations__models__ResourceType type: object title: Estimated Resources description: Estimated resource counts estimated_duration_seconds: anyOf: - type: integer - type: 'null' title: Estimated Duration Seconds description: Estimated migration duration type: object required: - valid title: ValidationResult description: Result of pre-flight validation. DependencyGraph: properties: nodes: items: $ref: '#/components/schemas/DependencyNode' type: array title: Nodes description: All resource nodes execution_order: items: type: string type: array title: Execution Order description: Topologically sorted execution order type: object title: DependencyGraph description: Dependency graph for migration ordering. shared__namespaces__migrations__models__FeatureExtractorConfig: properties: feature_extractor_name: type: string title: Feature Extractor Name description: Name of the extractor version: anyOf: - type: string - type: 'null' title: Version description: Version to use parameters: anyOf: - additionalProperties: true type: object - type: 'null' title: Parameters description: Extractor parameters type: object required: - feature_extractor_name title: FeatureExtractorConfig description: Configuration for a feature extractor in migration. ResourceFilter: properties: collection_ids: anyOf: - items: type: string type: array - type: 'null' title: Collection Ids description: Specific collection IDs to migrate taxonomy_ids: anyOf: - items: type: string type: array - type: 'null' title: Taxonomy Ids description: Specific taxonomy IDs to migrate cluster_ids: anyOf: - items: type: string type: array - type: 'null' title: Cluster Ids description: Specific cluster IDs to migrate retriever_ids: anyOf: - items: type: string type: array - type: 'null' title: Retriever Ids description: Specific retriever IDs to migrate date_range: anyOf: - additionalProperties: type: string type: object - type: 'null' title: Date Range description: Date range filter (after, before) auto_include_dependencies: type: boolean title: Auto Include Dependencies description: Automatically include required dependencies default: true type: object title: ResourceFilter description: Filters for selective resource migration. BatchOptions: properties: batch_size: type: integer maximum: 1000 minimum: 1 title: Batch Size description: Documents per batch default: 100 max_workers: type: integer maximum: 50 minimum: 1 title: Max Workers description: Maximum parallel workers default: 10 retry_failed: type: boolean title: Retry Failed description: Retry failed batches default: true type: object title: BatchOptions description: Options for batch processing in migration. TaxonomyOptions: properties: preserve_taxonomy_ids: type: boolean title: Preserve Taxonomy Ids description: Keep same taxonomy IDs in target default: true preserve_enrichment_fields: type: boolean title: Preserve Enrichment Fields description: Keep _taxonomy_* fields in documents default: true re_run_enrichment: type: boolean title: Re Run Enrichment description: Re-run taxonomy enrichment after migration default: false migrate_reference_collections: type: boolean title: Migrate Reference Collections description: Automatically migrate reference collections default: true type: object title: TaxonomyOptions description: Options for taxonomy migration. ClusterOptions: properties: preserve_cluster_ids: type: boolean title: Preserve Cluster Ids description: Keep same cluster IDs in target default: true preserve_assignments: type: boolean title: Preserve Assignments description: Keep cluster_id in documents default: true migrate_artifacts: type: boolean title: Migrate Artifacts description: Copy parquet artifacts from S3 default: true preserve_centroids: type: boolean title: Preserve Centroids description: Keep centroid collections default: true recompute_clusters: type: boolean title: Recompute Clusters description: Recompute clusters instead of copying default: false type: object title: ClusterOptions description: Options for cluster migration. RetrieverOptions: properties: preserve_retriever_ids: type: boolean title: Preserve Retriever Ids description: Keep same retriever IDs (avoid conflicts) default: false migrate_interactions: type: boolean title: Migrate Interactions description: Migrate user interaction data default: false migrate_execution_history: type: boolean title: Migrate Execution History description: Migrate past execution history default: false validate_references: type: boolean title: Validate References description: Pre-flight check all references exist default: true type: object title: RetrieverOptions description: Options for retriever migration. MigrationStage: type: string enum: - namespace_setup - batch_creation - batch_processing - cluster_execution - taxonomy_enrichment - benchmark_evaluation - finalization title: MigrationStage description: Stages of migration execution. StageProgress: properties: stage: $ref: '#/components/schemas/MigrationStage' description: Stage name status: $ref: '#/components/schemas/MigrationStatus' description: Stage status started_at: anyOf: - type: string format: date-time - type: 'null' title: Started At description: Stage start time completed_at: anyOf: - type: string format: date-time - type: 'null' title: Completed At description: Stage completion time progress_percent: type: number maximum: 100 minimum: 0 title: Progress Percent description: Progress % default: 0 items_total: type: integer minimum: 0 title: Items Total description: Total items to process default: 0 items_completed: type: integer minimum: 0 title: Items Completed description: Items completed default: 0 items_failed: type: integer minimum: 0 title: Items Failed description: Items failed default: 0 error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error if failed type: object required: - stage - status title: StageProgress description: Progress tracking for a migration stage. ResourceProgress: properties: resource_id: type: string title: Resource Id description: Resource ID resource_type: $ref: >- #/components/schemas/shared__namespaces__migrations__models__ResourceType description: Resource type status: $ref: '#/components/schemas/MigrationStatus' description: Resource status progress_percent: type: number maximum: 100 minimum: 0 title: Progress Percent description: Progress % default: 0 error_message: anyOf: - type: string - type: 'null' title: Error Message description: Error if failed type: object required: - resource_id - resource_type - status title: ResourceProgress description: Progress tracking for individual resources. DependencyNode: properties: resource_id: type: string title: Resource Id description: Resource ID resource_type: $ref: >- #/components/schemas/shared__namespaces__migrations__models__ResourceType description: Resource type dependencies: items: type: string type: array title: Dependencies description: IDs of resources this depends on tier: type: integer minimum: 0 title: Tier description: Dependency tier (0=no deps) default: 0 type: object required: - resource_id - resource_type title: DependencyNode description: Node in dependency graph. shared__namespaces__migrations__models__ResourceType: type: string enum: - bucket - collection - taxonomy - cluster - retriever title: ResourceType description: Types of resources that can be migrated. ````