---
schema_version: "1"
id: 12e9ec8708003e5265872203fc5b1d95853e86d8ace7c54bb6c5bd213fcdfafe
title: Dataflow Resource
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest/bi_resources_dataflows_id.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_dataflows_id.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: e93aa9f23bda2fe69720b7aef0103fc04c35ec8eb0d364412538ccebb5ee2f31
description: Returns a dataflow. Reverts a dataflow to a previous version.
---
# Dataflow Resource

Returns a dataflow. Reverts a dataflow to a previous version.

Resource URL

/wave/dataflows/<dataflowId>

Formats

JSON

Available Version

37.0

## Available in Postman

To view and test a working example of this resource, see [getDataflow](https://www.postman.com/salesforce-developers/workspace/salesforce-developers/request/12721794-429f4832-5584-479c-a67d-f932a801e14b?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.").

HTTP Methods

GET PATCH (50.0) PUT

Run a Dataflow

To schedule a dataflow, use the [Dataflow Jobs Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_dataflowjobs.htm "Returns a list of dataflow jobs and starts a new dataflow job. Includes standard dataflows and recipes.") API. For examples of how to start and stop dataflows, see [Start and Stop a Dataflow Job or Recipe](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_run_schedule_sync_data.htm#start_stop_dataflows).

Schedule a Dataflow

To schedule a dataflow, use the [Schedule Resource](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_schedule.htm "Retrieve, create or delete a schedule for a dataflow, recipe, or connection sync.") API. For examples of how to schedule dataflows, see [Schedule Dataflows, Recipes, and Data Syncs](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_run_schedule_sync_data.htm#schedule_data_assets).

Request parameters for GET

| Parameter Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| historyId | String | Use the history ID to request a specific dataflow version. | Optional | 42.0 |

Response body for GET, PATCH, and PUT

[Dataflow](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_dataflow.htm "An Analytics dataflow.")

Request body for PATCH

[Dataflow Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_dataflow_input.htm "An Analytics dataflow.")

Request body for PUT

Use the PUT API request to revert to a previous historical version. [Asset Revert History Input](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_requests_asset_revert_history_input.htm "The Analytics asset history to use for a revert request.")

The following JSON shows the revert request for a dataflow version.

{
  "historyId" : "0RmS7000000xxxxxxx"
}