Datasets

Manage datasets (tables) used for building charts.

Method	Endpoint	Path
DELETE	Bulk delete datasets (soft delete, recoverable via restore, when the SOFT_DELETE feature flag is enabled; permanent otherwise)	/api/v1/dataset/
GET	Get a list of datasets	/api/v1/dataset/
POST	Create a new dataset	/api/v1/dataset/
GET	Get metadata information about this API resource (dataset--info)	/api/v1/dataset/_info
GET	Get a dataset	/api/v1/dataset/{id_or_uuid}
GET	Get charts and dashboards count associated to a dataset	/api/v1/dataset/{id_or_uuid}/related_objects
DELETE	Delete a dataset (soft delete, recoverable via restore, when the SOFT_DELETE feature flag is enabled; permanent otherwise)	/api/v1/dataset/{pk}
PUT	Update a dataset	/api/v1/dataset/{pk}
DELETE	Delete a dataset column	/api/v1/dataset/{pk}/column/{column_id}
GET	Get dataset drill info	/api/v1/dataset/{pk}/drill_info/
DELETE	Delete a dataset metric	/api/v1/dataset/{pk}/metric/{metric_id}
POST	Preview a partition filter mapping	/api/v1/dataset/{pk}/partition_mapping/preview/
PUT	Refresh and update columns of a dataset	/api/v1/dataset/{pk}/refresh
GET	Get a dataset's activity stream	/api/v1/dataset/{uuid_str}/activity/
GET	Return the version history for a dataset	/api/v1/dataset/{uuid_str}/versions/
GET	Read-only snapshot of the dataset at a given version	/api/v1/dataset/{uuid_str}/versions/{version_uuid_str}/
POST	Revert a dataset to an earlier version (non-destructive)	/api/v1/dataset/{uuid_str}/versions/{version_uuid_str}/restore
POST	Permanently delete a soft-deleted dataset	/api/v1/dataset/{uuid}/purge
GET	Preview the dependency impact of purging an archived dataset	/api/v1/dataset/{uuid}/purge-impact
POST	Restore a soft-deleted dataset	/api/v1/dataset/{uuid}/restore
GET	Get distinct values from field data (dataset-distinct-column-name)	/api/v1/dataset/distinct/{column_name}
POST	Duplicate a dataset	/api/v1/dataset/duplicate
GET	Download multiple datasets as YAML files	/api/v1/dataset/export/
POST	Retrieve a table by name, or create it if it does not exist	/api/v1/dataset/get_or_create/
POST	Import dataset(s) with associated databases	/api/v1/dataset/import/
GET	Get related fields data (dataset-related-column-name)	/api/v1/dataset/related/{column_name}
PUT	Warm up the cache for each chart powered by the given table	/api/v1/dataset/warm_up_cache