get_artifact_rows
curl --request GET \
--url https://ndi-api.nace.ai/v1/workspaces/{workspace_id}/artifacts/rows \
--header 'X-API-Key: <api-key>'{
"columns": [
{
"data_type": "<string>",
"name": "<string>"
}
],
"limit": 123,
"path": "<string>",
"rows": [
{}
],
"start_row": 123,
"total_rows": 123
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}get_artifact_rows
One page of a parquet, csv or jsonl artifact’s rows, in file order, by exact workspace-relative path.
GET
/
v1
/
workspaces
/
{workspace_id}
/
artifacts
/
rows
get_artifact_rows
curl --request GET \
--url https://ndi-api.nace.ai/v1/workspaces/{workspace_id}/artifacts/rows \
--header 'X-API-Key: <api-key>'{
"columns": [
{
"data_type": "<string>",
"name": "<string>"
}
],
"limit": 123,
"path": "<string>",
"rows": [
{}
],
"start_row": 123,
"total_rows": 123
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}Authorizations
Path Parameters
Workspace identifier.
Query Parameters
Exact workspace-relative path of a live source, derivative, or query-result artifact.
Required string length:
1 - 1024Pattern:
^[^/]File row number of the first row in the page, 0-based.
Required range:
x >= 0Rows per page.
Required range:
1 <= x <= 200Ascending, non-overlapping inclusive row ranges to read instead of a contiguous window, e.g. '3-3,17-19'. Replaces start_row/limit; the ranges may cover at most as many rows as the page limit allows.
Maximum string length:
8400Pattern:
^\d+-\d+(,\d+-\d+)*$Response
Successful Response
One page of rows from a tabular workspace artifact.
Rows are returned in file order, so start_row is both the request
offset and the file row number of rows[0] — callers can label each
row with its source row number without another lookup.