Newer Version Available

This content describes an older version of this product. View Latest

Dataflow Jobs List Resource

Returns a list of dataflow jobs and starts a new dataflow job. Includes standard dataflows and recipes.
Resource URL
1/wave/dataflowjobs
Formats
JSON
Available Version
42.0
HTTP Methods
GET POST
GET Request Parameters
Parameter Name Type Description Required or Optional Available Version
dataflow​Id ID Filters the collection to only contain dataflow jobs tied to this specific dataflow. ID must start with ‘02K’ Optional 42.0
licenseType Connect​Analytics​License​Type​Enum The Tableau CRM license types. Valid values are:
  • EinsteinAnalytics
  • Sonic
Optional 51.0
page String A generated token that indicates the view of dataflow jobs to be returned. Optional 51.0
pageSize Integer The number of items to be returned in a single page. Minimum is 1, maximum is 200, and default is 25. Optional 51.0
q String Search terms. Individual terms are separated by spaces. A wildcard is automatically appended to the last token in the query string. If the user’s search query contains quotation marks or wildcards, those symbols are automatically removed from the query string in the URI along with any other special characters. Optional 51.0
status Connect​Wave​Dataflow​Job​Status​Enum Filters the collection to only contain dataflow jobs with a specific runtime status. Valid values are:
  • Failure
  • Queued
  • Running
  • Success
  • Warning
Optional 51.0
GET Response Body
Property Name Type Description Filter Group and Version Available Version
dataflow​Jobs Dataflow​Job​Representation A list of dataflow jobs. Small, 42.0 42.0
next​Page​Url String The URL to get the next page of results. Small, 51.0 51.0
url String The URL to get the collection. Small, 42.0 42.0
POST Request Body
Use the POST API request to start a Dataflow. To stop a Dataflow, use the PATCH request on /wave/dataflowjobs/<dataflowjobId>.
Dataflow​Job​Input​Representation

The following JSON shows how to start a dataflowJob.

1{
2  "dataflowId": "02KS700000004G3eMAE",
3  "command" : "start"
4}
POST Response Body
Dataflow​Job​Representation
Start or Stop a Dataflow Job
For examples about how to start and stop Dataflow Jobs, see Start and Stop a Dataflow Job or Recipe