Jump to

• Request
• Response

List Workflows

get

[host-url]/dt-rest/v2/workflows

Retrieves a list of all workflows. This method supports various query parameters to filter and customize the response:

• fields: specifies the fields to include in the response (comma-separated)
• name: filters workflows by name
• parentFolder: filters workflows by parent folder

The following examples demonstrate supported query patterns for this endpoint:

• Retrieve all workflows (no filters):

  Retrieves all available workflows without any name filtering. All default fields for these workflows will be included in the response.

  /workflows


• Retrieve all workflows with specific fields:

  Retrieves all available workflows without any name filtering, and the response will only include the fields specified in the fields parameter.

  /workflows?fields=name,workflowId,...


• Retrieve a workflow by name:

  Retrieves workflows that match the given name. All default fields for these workflows will be included in the response.

  /workflows?name=your_workflow_name


• Retrieve a workflow by name with specific fields:

  Retrieves workflows that match the given name, and the response will only include the fields specified in the fields parameter.

  /workflows?name=your_workflow_name&fields=name,workflowId,...


• Retrieves workflows by parentFolder:

  Retrieves workflows that match the given parentFolder. All default fields for these workflows will be included in the response.

  /workflows?parentFolder=your_workflow_parentFolder


• Retrieves workflows by parentFolder with specific fields:

  Retrieves workflows that match the given parentFolder, and the response will only include the fields specified in the fields parameter.

  /workflows?parentFolder=your_workflow_parentFolder&fields=name,workflowId,...

Request

Query Parameters

• fields: string
  Optional. A comma-separated list of fields to include in the response for each workflow (e.g., "workflowId,name,projectName").
• name: string
  QueryParam parameter name
• parentFolder: string
  QueryParam parameter parentFolder

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

A Response object containing a list of workflows.

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object WorkflowBaseDTO
  JSON that represents a workflow with basic information.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/WorkflowBaseDTO"
    }
}

Nested Schema : WorkflowBaseDTO

Type: object

JSON that represents a workflow with basic information.

Show Source

• dateCreated: string (date-time)
• dateUpdated: string (date-time)
• description: string
• name(required): string
• parentFolder: string
• projectName: string
• workflowId: string

{
    "type":"object",
    "description":"JSON that represents a workflow with basic information.",
    "required":[
        "name"
    ],
    "properties":{
        "name":{
            "type":"string"
        },
        "workflowId":{
            "type":"string"
        },
        "dateCreated":{
            "type":"string",
            "format":"date-time"
        },
        "dateUpdated":{
            "type":"string",
            "format":"date-time"
        },
        "projectName":{
            "type":"string"
        },
        "parentFolder":{
            "type":"string"
        },
        "description":{
            "type":"string"
        }
    }
}

401 Response

Unauthorized

Back to Top