Zum Hauptinhalt springen

Delete Records by Primary Key

POST 
/reference-datasets/:dataset_id/records/delete

Delete records in the current version by primary key.

Rows whose primary-key value appears in primary_keys are removed from the current version. The current version is mutated in place — no new version is created (same semantics as append and records/upsert). Unknown primary-key values are silently ignored. To checkpoint the mutated state into a new immutable version, call POST /reference-datasets/{id}/versions/snapshot afterwards.

Requires primary_key_column to be set on the dataset; otherwise returns 400.

Parameters:

  • dataset_id: UUID of the reference dataset
  • primary_keys: Non-empty list of primary-key values to delete

Request​

Responses​

Current version mutated in place with matching rows removed