curl --request POST \
--url https://api.mixpeek.com/v1/namespaces/migrations/validate \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"config": {
"migration_type": "re_extract",
"source_namespace_id": "<string>",
"target_namespace_id": "<string>",
"target_namespace_name": "<string>",
"feature_extractors": [
{
"feature_extractor_name": "<string>",
"version": "<string>",
"parameters": {}
}
],
"filters": {
"collection_ids": [
"<string>"
],
"taxonomy_ids": [
"<string>"
],
"cluster_ids": [
"<string>"
],
"retriever_ids": [
"<string>"
],
"date_range": {},
"auto_include_dependencies": true
},
"batch_options": {
"batch_size": 100,
"max_workers": 10,
"retry_failed": true
},
"taxonomy_options": {
"preserve_taxonomy_ids": true,
"preserve_enrichment_fields": true,
"re_run_enrichment": false,
"migrate_reference_collections": true
},
"cluster_options": {
"preserve_cluster_ids": true,
"preserve_assignments": true,
"migrate_artifacts": true,
"preserve_centroids": true,
"recompute_clusters": false
},
"retriever_options": {
"preserve_retriever_ids": false,
"migrate_interactions": false,
"migrate_execution_history": false,
"validate_references": true
},
"preserve_resource_ids": false,
"dry_run": false,
"webhook_url": "<string>"
}
}
'{
"message": "Configuration is valid with 1 warning",
"validation_result": {
"errors": [],
"estimated_duration_seconds": 1800,
"estimated_resources": {
"collection": 5,
"taxonomy": 2
},
"valid": true,
"warnings": [
{
"error_code": "RE_EXTRACT_COST_WARNING",
"message": "RE_EXTRACT migration will reprocess all documents and incur processing costs",
"severity": "warning"
}
]
}
}Validate a migration configuration without creating it.
Use this endpoint to check if a migration configuration is valid before actually creating and running it.
Args: request: FastAPI request validate_request: Configuration to validate
Returns: ValidateMigrationResponse with validation results
curl --request POST \
--url https://api.mixpeek.com/v1/namespaces/migrations/validate \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"config": {
"migration_type": "re_extract",
"source_namespace_id": "<string>",
"target_namespace_id": "<string>",
"target_namespace_name": "<string>",
"feature_extractors": [
{
"feature_extractor_name": "<string>",
"version": "<string>",
"parameters": {}
}
],
"filters": {
"collection_ids": [
"<string>"
],
"taxonomy_ids": [
"<string>"
],
"cluster_ids": [
"<string>"
],
"retriever_ids": [
"<string>"
],
"date_range": {},
"auto_include_dependencies": true
},
"batch_options": {
"batch_size": 100,
"max_workers": 10,
"retry_failed": true
},
"taxonomy_options": {
"preserve_taxonomy_ids": true,
"preserve_enrichment_fields": true,
"re_run_enrichment": false,
"migrate_reference_collections": true
},
"cluster_options": {
"preserve_cluster_ids": true,
"preserve_assignments": true,
"migrate_artifacts": true,
"preserve_centroids": true,
"recompute_clusters": false
},
"retriever_options": {
"preserve_retriever_ids": false,
"migrate_interactions": false,
"migrate_execution_history": false,
"validate_references": true
},
"preserve_resource_ids": false,
"dry_run": false,
"webhook_url": "<string>"
}
}
'{
"message": "Configuration is valid with 1 warning",
"validation_result": {
"errors": [],
"estimated_duration_seconds": 1800,
"estimated_resources": {
"collection": 5,
"taxonomy": 2
},
"valid": true,
"warnings": [
{
"error_code": "RE_EXTRACT_COST_WARNING",
"message": "RE_EXTRACT migration will reprocess all documents and incur processing costs",
"severity": "warning"
}
]
}
}REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.
Request to validate a migration configuration without creating it.
Migration configuration
Show child attributes
Type of migration to perform
re_extract, copy Source namespace ID
Target namespace ID (auto-generated if not provided)
Name for target namespace
Resource selection filters
Show child attributes
Specific collection IDs to migrate
Specific taxonomy IDs to migrate
Specific cluster IDs to migrate
Specific retriever IDs to migrate
Automatically include required dependencies
Batch processing options
Taxonomy migration options
Show child attributes
Keep same taxonomy IDs in target
Keep taxonomy* fields in documents
Re-run taxonomy enrichment after migration
Automatically migrate reference collections
Cluster migration options
Show child attributes
Keep same cluster IDs in target
Keep cluster_id in documents
Copy parquet artifacts from S3
Keep centroid collections
Recompute clusters instead of copying
Retriever migration options
Show child attributes
Keep same retriever IDs (avoid conflicts)
Migrate user interaction data
Migrate past execution history
Pre-flight check all references exist
Preserve original resource IDs in target
Validate only, don't execute
Webhook URL for status notifications
Successful Response
Response for migration validation.
Validation result
Show child attributes
Whether migration can proceed
Estimated migration duration
Human-readable message
Dependency graph if validation passed
Show child attributes
All resource nodes
Show child attributes
Resource ID
Resource type
bucket, collection, taxonomy, cluster, retriever IDs of resources this depends on
Dependency tier (0=no deps)
x >= 0Topologically sorted execution order
Was this page helpful?