Skip to content

List schema versions

GET
/dataset-tables/{tableId}/schema/versions

List all schema versions for a dataset table.

tableId
required

Unique identifier of the table to retrieve

string

Unique identifier of the table to retrieve

Schema versions retrieved successfully

object
versions
required

Array of schema version objects

Array<object>
object
schemaVersionId
required

Unique identifier for this schema version

string
datasetId
required

ID of the parent dataset

string
versionNumber

Sequential version number

number
arrowSchema
required

Full Arrow schema in JSON format

string
fields
required

Array of field definitions

Array<object>
object
name
required

Column name

string
arrowType
required

Arrow data type

string
nullable
required

Whether the column allows null values

boolean
primaryKeyColumns
required

Column names that form the primary key

Array<string>
appliedAt
required

When this schema version was applied

string
description

Optional description of schema changes

string

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