Skip to main content
POST
Create Migration

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing, malformed, unknown, revoked, inactive or expired key returns 401; a key without the permission, scope or plan an operation needs returns 403.

Body

application/json

Keys this body does not declare are ignored, and the response's warnings name them, until 2026-11-02; from 2026-11-02 they are refused with 422 extra_forbidden naming the accepted keys.

Request to create a new migration.

config
MigrationConfig · object
required

Migration configuration

start_immediately
boolean
default:false

Start execution immediately after validation

Response

Successful Response

Response after creating a migration.

migration_id
string
required

Created migration ID

status
enum<string>
required

Current status

Available options:
draft,
validating,
pending,
in_progress,
completed,
failed,
cancelled
created_at
string<date-time>
required

Creation timestamp

message
string
required

Human-readable message

validation_result
ValidationResult · object | null

Validation result if available