Get a dataset (Deprecated)

GET

/v2/datasets/:datasetId

GET

/v2/datasets/:datasetId

$ curl https://api.sigmacomputing.com/v2/datasets/datasetId \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

200Retrieved

1 {
2   "datasetId": "dset-9f8b7c6a5e4d3c2b1a0f",
3   "createdBy": "alice.jones@example.com",
4   "updatedBy": "bob.smith@example.com",
5   "createdAt": "2024-01-15T09:30:00Z",
6   "updatedAt": "2024-04-10T14:45:00Z",
7   "name": "Sales Performance Q1 2024",
8   "description": "Dataset containing sales performance metrics for Q1 2024 across all regions.",
9   "url": "https://app.sigmacomputing.com/datasets/dset-9f8b7c6a5e4d3c2b1a0f",
10   "owner": "carol.williams@example.com",
11   "referenceCount": 5,
12   "path": "/Workspaces/Marketing/Reports/Q1 2024",
13   "migrationToDataModel": {
14     "dataModelId": "dm-1234567890abcdef",
15     "dataModelUrl": "https://app.sigmacomputing.com/datamodels/dm-1234567890abcdef",
16     "migratedAt": "2024-05-01T11:00:00Z",
17     "migratedBy": "david.lee@example.com"
18   },
19   "migrationStatus": "migrated",
20   "isArchived": false
21 }

Get a specific dataset by datasetId

Deprecation notice: Datasets are deprecated. Starting June 2, 2026, you will no longer be able to create datasets or edit existing datasets. Migrate your datasets to data models and update any documents that use datasets as a data source to use a different source. See Migrate a dataset to a data model.

Usage notes

Retrieve the datasetId by calling the /v2/datasets endpoint.

Get a specific dataset by datasetId **Deprecation notice**: [Datasets](/docs/datasets) are deprecated. Starting June 2, 2026, you will no longer be able to create datasets or edit existing datasets. Migrate your datasets to data models and update any documents that use datasets as a data source to use a different source. See [Migrate a dataset to a data model](/docs/migrate-a-dataset-to-a-data-model). ### Usage notes - Retrieve the **datasetId** by calling the [/v2/datasets](https://help.sigmacomputing.com/reference/list-datasets) endpoint.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

datasetIdstringRequired

Response

The response body.

datasetIdstring

createdBystring

updatedBystring

createdAtdatetime

updatedAtdatetime

namestring

descriptionstring

urlstring

ownerstring

referenceCountdouble

Count of inbound references to the dataset

pathstring

Path describing dataset's ancestor workspace and folders

migrationToDataModelobject or null

Details about migration to data model

migrationStatusenum

An indicator of the dataset’s migration status as displayed on the dataset migration admin page.

not-required indicates that the dataset is not used as a data source (in other words, it is not referenced by other documents) and likely does not need to be migrated to a data model.
migrated indicates that the dataset has already been migrated to a data model
not-migrated indicates that the dataset has not been migrated and is still in use as a data source

isArchivedboolean