---
schema_version: "1"
id: 347a94d9a19acbaa2c0a9e39ee7207be0eac8ca93d96242dffb44374f8751fdc
title: Dataset Resource
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest/bi_resources_dataset_id.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_dataset_id.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 147237f7695a309d2080d28538a8470e290a820a1bc1f85543e4fa72cf58be1a
description: Returns, deletes, or updates a dataset with the specified ID or API name.
---
# Dataset Resource

Returns, deletes, or updates a dataset with the specified ID or API name.

## Resource URL

/wave/datasets/<datasetIdOrApiName>

## Formats

JSON

## Available Version

## Available in Postman

To view and test a working example of this resource, see [getDataset](https://www.postman.com/salesforce-developers/workspace/salesforce-developers/request/12721794-76b9e92b-ed58-4a54-b618-c61eea634de4?action=share&source=copy-link&creator=26106753 "HTML (New Window)") in Postman. For information about how to authenticate your org with Postman, see the [CRM Analytics Rest API Quick Start](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/crma_rest_api_quick_start.htm "Connect to a Salesforce Trailhead org and authenticate. Then make a request to the CRM Analytics REST API in Postman, and look at the response.").

36.0

## Available Components

- Aura — [<wave:sdk> describeDataset()](https://developer.salesforce.com/docs/atlas.en-us.264.0.bi_dev_guide_sdk.meta/bi_dev_guide_sdk/bi_sdk_asset.htm)
- Aura — [<wave:sdk> getDatasetFields()](https://developer.salesforce.com/docs/atlas.en-us.264.0.bi_dev_guide_sdk.meta/bi_dev_guide_sdk/bi_sdk_asset.htm)
- LWC — [lightning/analyticsWaveApi getDataset()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-wire-adapters-get-dataset.html)
- LWC — [lightning/analyticsWaveApi createDataset()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-analytics-create-dataset.html)
- LWC — [lightning/analyticsWaveApi deleteDataset()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-analytics-delete-dataset.html)
- LWC — [lightning/analyticsWaveApi updateDataset()](https://developer.salesforce.com/docs/platform/lwc/guide/reference-analytics-update-dataset.html)

## HTTP Methods

GET DELETE PATCH

## Response body for GET and PATCH

[Dataset](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_dataset.htm "An Analytics dataset.")

## Request body for PATCH

[Dataset Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_dataset_input.htm "An Analytics dataset.")

The following JSON shows how to edit an existing dataset description.

{
  "description": "This is my dataset",
  "label": "Test Dataset"
}