Page tree

Release 6.4.2



For the latest updates on available API endpoints and documentation, see

This is the latest version of the APIs.


Retrieve the flow information for a specified flow identifier.  

Version: v4

Required Permissions

The authenticated user must have access to the specified flow.

NOTE: Each request to the Designer Cloud Powered by Trifacta® platform must include authentication credentials. See


Request Type: GET


<id>Internal identifier of the flow to retrieve.

Endpoint with flow name:

Instead of submitting the internal identifier, you can use the following endpoint and parameter to request the flow object by its display name:


Display name of the flow to retrieve.

NOTE: This value is case-insensitive. If multiple flow names match with different capitalization, both flow objects are returned.

Request URI - Example:


Query parameter reference:

The following query parameters can be submitted with this endpoint:

Query ParameterData TypeDescription

Comma-separated list of objects to include part of the response.


If set to true, response includes deleted objects.

For more information, see API Common Query Parameters v4.

Request Body:



Response Status Code - Success:  200 - OK

Response Body Example:

    "id": 6,
    "name": "2013 POS",
    "description": null,
    "createdAt": "2019-01-08T17:25:21.392Z",
    "updatedAt": "2019-01-08T17:30:30.959Z",
    "creator": {
        "id": 1
    "updater": {
        "id": 1
    "folder": null,
    "workspace": {
        "id": 1


idInternal identifier for the flow
nameDisplay text for the flow
descriptionUser-friendly description for the flow
createdAtTimestamp for when the flow was created
updatedAtTimestamp for when the flow was last modified

(Returned only when retrieving flow by display name)

NOTE: For internal platform use only. Do not attempt to modify.

creator.idInternal ID of the user who created the flow.
updater.idInternal identifier of the user who last updated the flow.
folderIf the flow has been added to a folder, this value contains the path to the folder.
workspace.idInternal identifier of the workspace to which this flow belongs. In most environments, this value is 1.

This page has no comments.