Account1

Adhoc Retrievers3

Agent Sessions11

Alerts16

Analytics41

Annotations9

Apps34

Batches4

Bucket Batches22

Bucket Objects10

Bucket Syncs15

Bucket Uploads7

Buckets7

BYO Documents5

Cluster Executions7

Cluster Triggers8

Clusters9

Collection Documents19

Collection Lifecycle2

Collection Schema1

Collection Taxonomies1

Collections14

Custom Models8

Data Subject Access Requests3

Discovery4

Document Lineage3

Documents6

Events1

Extractor Publishing5

Extractors5

Feature Extractors2

Feature Search1

Features1

Health4

Inference1

Manifest7

Marketplace14

Models6

Namespace Clone1

Namespace Extractors2

Namespace Migrations7

Namespace Snapshots6

Namespaces10

Notifications12

Onboarding2

Organization API Keys5

Organization Audit5

Organization Billing22

Organization Connections8

Organization Infrastructure1

Organization Secrets4

Organization Targets1

Organization Usage3

Organization Users5

Organizations3

Pricing1

Public Apps API5

Public Extractor Marketplace2

Public Notifications API1

Public Retriever API7

Public Templates API8

Published Retrievers8

Quickstart1

Resource Search1

Retriever API Keys3

Retriever Benchmarks4

Retriever Evaluations9

Retriever Interactions5

Retriever Stages1

Retrievers15

Scaffold Templates3

Signup1

Source Adapter2

Support14

Tasks3

Taxonomies13

Taxonomy Analytics6

Templates23

Triggers10

Webhooks5

Namespace Migrations

Create Migration

Changed on Oct 9, 2026

Create a new namespace migration.

This endpoint creates a migration and optionally validates it. Use start_immediately=True to begin execution immediately.

Args: request: FastAPI request create_request: Migration configuration

Returns: CreateMigrationResponse with migration ID and status

post/v1/namespaces/migrations/

Request

Base URL: https://api.mixpeek.com
URL: https://api.mixpeek.com/v1/namespaces/migrations/
Auth: HTTP bearer

Request body

start_immediatelyboolean

Start execution immediately after validation

Example request

{
  "config": {
    "feature_extractors": [
      {
        "feature_extractor_name": "openai_text_embedding",
        "parameters": {
          "model": "text-embedding-3-large"
        },
        "version": "v3"
      }
    ],
    "migration_type": "re_extract",
    "source_namespace_id": "ns_abc123",
    "target_namespace_name": "my_namespace_v2"
  },
  "start_immediately": false
}

Response

Successful Response

migration_idstring required

Created migration ID

Migration execution status.

created_atstring date-time required

Creation timestamp

messagestring required

Human-readable message

Example response

{
  "created_at": "2025-12-03T10:00:00Z",
  "message": "Migration created successfully. Use POST /migrations/{id}/start to begin execution.",
  "migration_id": "mig_abc123xyz789",
  "status": "draft",
  "validation_result": {
    "errors": [],
    "estimated_duration_seconds": 1800,
    "estimated_resources": {
      "cluster": 1,
      "collection": 5,
      "taxonomy": 2
    },
    "valid": true,
    "warnings": []
  }
}

Changes

Oct 9, 202661a175e8eb9a Revision changes
- breaking
  removed the required property //// from the response with the status
- breaking
  removed the required property //// from the response with the status
- breaking
  removed the required property //// from the response with the status
- breaking
  removed the required property //// from the response with the status
- breaking
  removed the required property //// from the response with the status
- breaking
  removed the required property //// from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
- info
  added the required property //// to the response with the status
Oct 4, 202638e0822db900 Revision changes
- breaking
  removed the success response with the status
- info
  added the success response with the status

Operation history (3 revisions)