Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version r0682

D s api version

D toc

Add the specified wrangled dataset to a flow as a reference. A reference is a link from one flow to the output of a wrangled dataset that is sourced from another flow.


Tip: In the

D s webapp
UI, the WrangledDataset object is called a recipe.


NOTE: Datasets can be added to flows based on the permissions of the access token used on this endpoint. Datasets can be added to flows that are shared by the user.

Version:  v4

Required Permissions

D s api auth


Request Type: POST


Code Block


<id>Internal identifier for the wrangled dataset

Request URI - Example:

Code Block

Request Body:

Code Block
    "flow": {
        "id": 27


Response Status Code - Success:  201 - Created

Response Body:

Code Block
    "id": 43,
    "wrangled": false,
    "updatedAt": "2019-01-26T01:09:38.022Z",
    "createdAt": "2019-01-26T01:09:38.022Z",
    "referenceInfo": null,
    "activeSample": null,
    "creator": {
        "id": 1
    "updater": {
        "id": 1
    "recipe": null,
    "referencedFlowNode": {
        "id": 27
    "flow": {
        "id": 15


idInternal identifier for the new wrangled dataset.

If true, the dataset is a wrangled dataset.

If false, the dataset is a reference dataset.


Timestamp for when the dataset was updated.


Timestamp for when the dataset was created.

referenceInfoIf the wrangled dataset has a reference object defined for it, its information is listed here.

Internal identifier for the currently active sample for the dataset.

If null, there is no currently active sample for the dataset.

creator.IdInternal identifier of the user who created the flow.
updater.IdInternal identifier of the user who performed the update.

Internal identifier for the recipe associated with the dataset in its new flow.

If null, the dataset has not been wrangled in the Transformer page.

referencedFlowNode.idInternal identifier of the original dataset's internal identifier.
flow.IdInternal identifier of the flow that contains this dataset