Skip to main content
POST
FetchDatasetContentsAPI mirrors the erdo_fetch_dataset_contents MCP tool as a REST endpoint.

Authorizations

Authorization
string
header
required

An Erdo API key (erdo_api_...) or scoped token (erdo_token_...).

Path Parameters

datasetSlug
string
required

Body

application/json
dataset_slug
string
filter_names
string[]
limit
integer<int64>
resource_key
string
revision_id
string

File datasets keep every superseded version of their file; restoring one is reading it and writing the rows back through the normal write path.

sql_query
string
view
string

"declared_schema", which returns only the dataset's declared write contract and reads no rows, or "resource_schema", which returns the physical file shape or discovered integration resource columns.

Response

Success response

columns
string[]
declared_schema
DeclaredSchema is a table-class dataset's declared column contract, stored as · object

jsonb on the dataset row (declared_schema) and surfaced on the schema/details read endpoints.

resources
ResourceSchema is set only by the resource_schema view. Integration · object[]

entries intentionally contain only resource identity and catalog columns.

row_count
integer<int64>
rows
string[][]
schema_provenance
string
view
string

absent for a rows read.