Append Rows to Reference Data
POST/reference-datasets/:dataset_id/append
Append rows from a Parquet file to the current version. Maximum file size is 1GB.
The uploaded file's schema must match the current version exactly (same column names in the same order).
Not allowed when the dataset has a primary_key_column configured —
append cannot enforce PK uniqueness against existing rows. Use
POST /reference-datasets/{id}/records/upsert instead, which performs
a PK-aware merge.
Parameters:
- dataset_id: UUID of the reference dataset
- file: Parquet file with rows to append (multipart/form-data)
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 413
- 422
Rows appended to the current version
Validation Error
Unauthorized
Forbidden
Not Found
Request Entity Too Large
Unprocessable Entity