Skip to content

List migrations

GET
/dataset-tables/{tableId}/migrations

List all migrations for a dataset table.

tableId
required

Unique identifier of the table to retrieve

string

Unique identifier of the table to retrieve

Migrations retrieved successfully

object
migrations
required

Array of migration objects

Array<object>
object
migrationId
required

Unique identifier for the migration

string
datasetId
required

ID of the parent dataset

string
tableId
required

ID of the table being migrated

string
fromSchemaId
required

Schema version ID before migration, null for initial schema

string
nullable
toSchemaId
required

Schema version ID after migration

string
operations
required

Migration operations that were executed

Array
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
status
required

Migration status (pending or succeeded)

string
Allowed values: pending succeeded
startedAt
required

When the migration started

string
completedAt
required

When the migration completed

string
nullable
createdAt
required

When the migration was created

string
createdBy
required

User ID who initiated the migration

string
nullable

Bad Request - Validation error or invalid input

object
error
required
string
code
string
details
nullable
retryable
boolean

Unauthorized - Authentication required or invalid token

object
error
required
string
code
string
details
nullable
retryable
boolean

Forbidden - Insufficient permissions

object
error
required
string
code
string
details
nullable
retryable
boolean

Not Found - Resource does not exist

object
error
required
string
code
string
details
nullable
retryable
boolean

Internal Server Error - Unexpected server error

object
error
required
string
code
string
details
nullable
retryable
boolean