Skip to content

Plan schema migration

POST
/dataset-tables/{tableId}/migrations/plan

Validate a set of migration operations without executing them. Returns what would happen.

tableId
required
string
object
operations
required
Array
>= 1 items
One of:
object
type
required
string
Allowed values: add_column
params
required
object
name
required
string
dataType
required
string
nullable
required
boolean
position
integer
nullable
defaultValue
nullable

Migration plan generated

object
isValid
required
boolean
validationErrors
required
Array<string>
estimatedDurationMs
number
indexImpacts
required
Array<object>
object
indexName
required
string
impact
required
string
Allowed values: none rebuild drop
reason
string
requiresRewrite
boolean

Bad request - invalid migration operations

Dataset table not found