JOC API

Version 2.6.5

Download RAML
JOC API
/workflows
POST

Returns workflows


Parameters in the POST body schema

Name Type Description Example Default
controllerId required, string Controller ID myController
workflowIds optional, object Filtered response by a collection of workflows specified by its path and optional version
If this parameter is specified then parameters such as folders, states, regex and agentName where applicable are ignored.
{
"path": "/path/to/workflow",
"versionId": "c79caab4-4e72-4818-bae7-902f1037d8b6"
}
path required, string Field for each item in workflowIds to specify the path of a workflow
versionId optional, string Field for each in workflowIds to specify the version of a workflow
folders optional, array[object] Limits the result to a collection of folders [{
"folder": "/sos",
"recursive": true
}]
compact optional, boolean A compact response is returned if this parameter is true false
states optional, array Filtered all workflows with states such as
  • IN_SYNC
  • NOT_IN_SYNC
  • SUSPENDED
  • OUTSTANDING
["SUSPENDED"]
instructionStates optional, array Filtered all workflows with instruction states such as
  • SKIPPED
  • STOPPED
["SKIPPED", "STOPPED"]
tags optional, array[string] Tag names
regex optional, string Regular expression to filter the collection.
Searched in workflow name and title case insensitiv.
For a case sensitive search start the regex with the inline modifier (?-i)
.*
agentNames optional, array Filters all workflows in which at least one job is processed by one of the specified agents. Name and aliases are considered.