List dataset tables

GET

/dataset-tables

• Production API

Authorizations

• bearerAuth
• cookieAuth

Parameters

Query Parameters

datasetTableIds

Comma-separated list of table IDs to filter by

string

nullable

Comma-separated list of table IDs to filter by

datasetIds

Comma-separated list of dataset IDs to filter by

string

nullable

Comma-separated list of dataset IDs to filter by

tableName

Filter by table name (partial match)

string

Filter by table name (partial match)

managed

Filter by managed status (true for managed tables, false for external)

string

Allowed values: true false

Filter by managed status (true for managed tables, false for external)

page

Page number for pagination (starts at 1)

number

>= 1

Page number for pagination (starts at 1)

pageSize

Number of results per page (1-100)

number

>= 1 <= 100

Number of results per page (1-100)

orderBy

Field to sort results by

string

Allowed values: createdAt tableName updatedAt

Field to sort results by

orderDirection

Sort direction (asc or desc)

string

Allowed values: asc desc

Sort direction (asc or desc)

Responses

200

Dataset tables retrieved successfully

object

tables

required

Array of table objects

Array<object>

object

tableId

required

Unique identifier for the table

string

datasetId

required

ID of the parent dataset

string

tableName

required

Human-readable name of the table

string

description

required

Optional description of the table’s purpose

string

nullable

createdAt

required

When the table was created

string format: date-time

updatedAt

required

When the table was last modified

string format: date-time

total

required

Total number of tables matching the query

number

page

required

Current page number

number

pageSize

required

Number of results per page

number

400

Bad Request - Validation error or invalid input

object

error

required

string

code

string

details

nullable

retryable

boolean

401

Unauthorized - Authentication required or invalid token

object

error

required

string

code

string

details

nullable

retryable

boolean

403

Forbidden - Insufficient permissions

object

error

required

string

code

string

details

nullable

retryable

boolean