Skip to main content

WorkflowStructureResultResponse

errCodeintegerrequired
Constant value: 0
errMessagestringrequired
Constant value:
data objectrequired
workflowIdstringrequired
workflowNamestringrequired
targetstringrequired
resolvedTargetstringrequired
structure objectrequired
projectTypeWorkflowProjectTyperequired

Workflow/Conversation is declared by executor.projectType;Kanban is declared package.json.workflowCode.projectType declaration. This allows the host to choose a running or static preview interface.

Possible values: [workflow, conversation, kanban]

workflow objectrequired
property name*any
definitions objectrequired

Project-level nodes, API calls, variables, and registry static definitions.

property name*any

Project-level nodes, API calls, variables, and registry static definitions.

diagnostics objectrequired

Project-level warnings and violations.

property name*any

Project-level warnings and violations.

defaultEntrypointstring

Returns only Workflow; must hit one of entrypoints.

Possible values: Value must match regular expression ^[a-z][a-z0-9_-]{0,63}$

entrypoints object[]

Only Workflow returns the flat independent entry directory in the same order as the source declaration.

Possible values: >= 1

  • Array [
  • idstringrequired

    Possible values: Value must match regular expression ^[a-z][a-z0-9_-]{0,63}$

    titlestringrequired

    Possible values: non-empty

    descriptionstring
    workflowNamestringrequired
    execution objectrequired
    kindstringrequired
    Constant value: sequence
    location object
    property name*any
    childrenobject[]required
    params object[]
  • Array [
  • namestringrequired
    flagstring
    shortFlagstring
    typestringrequired

    Possible values: [string, number, boolean, positional, file]

    requiredboolean
    labelstring
    descriptionstring
    defaultValuestring
    multipleboolean
    controlstring

    Shared form control hint. Date-related controls keep string values: date uses YYYY-MM-DD, time uses HH:mm:ss, datetime uses local YYYY-MM-DDTHH:mm:ss, and date-range uses inclusive YYYY-MM-DD/YYYY-MM-DD. Date controls do not support panel=quick.

    Possible values: [text, textarea, radio, select, checkboxes, date, time, datetime, date-range]

    panelstring

    Possible values: [main, auxiliary, quick]

    resolveOnInputboolean

    Whether main composer input changes trigger the selected entrypoint resolver (or the Conversation executor resolver). Defaults to false.

    options object[]
  • Array [
  • valuestringrequired
    labelstring
    descriptionstring
  • ]
  • acceptstring[]
    formatstring

    Possible values: [json]

  • ]
  • paramResolver object
    enabledbooleanrequired
    Constant value: true
    toolsobject[]
    tokenUsage object
    property name*any
    registryobject[]
  • ]
  • schedulePresets object[]

    Only Workflow can declare the proposed plan; the host must be created by user confirmation after presentation and is not automatically enabled.

    Possible values: <= 20

  • Array [
  • idstringrequired

    Possible values: Value must match regular expression ^[a-z][a-z0-9_-]{0,63}$

    titlestringrequired

    Possible values: non-empty and <= 100 characters

    descriptionstring

    Possible values: <= 500 characters

    entrypointIdstringrequired

    Possible values: Value must match regular expression ^[a-z][a-z0-9_-]{0,63}$

    timezonestringrequired
    trigger objectrequired
    kind stringrequired

    Possible values: [WorkflowScheduleWindowIntervalTrigger, WorkflowScheduleCronTrigger]

    weekdaysinteger[]required

    Monday to Sunday correspond to 1 to 7.

    Possible values: >= 1

    windows object[]required

    Local time windows that do not overlap, with start and end times included in the trigger range.

    Possible values: >= 1, <= 12

  • Array [
  • startstringrequired

    Possible values: Value must match regular expression ^(?:[01]\d|2[0-3]):[0-5]\d$

    endstringrequired

    Possible values: Value must match regular expression ^(?:[01]\d|2[0-3]):[0-5]\d$

  • ]
  • intervalMinutesintegerrequired

    Possible values: >= 1 and <= 1440

    paramValues objectrequired
    property name*any
  • ]
  • execution object

    Conversation single-entry execution structure;Workflow does not return this top-level compatible field.

    kindstringrequired
    Constant value: sequence
    location object
    property name*any
    childrenobject[]required
    params object[]

    Conversation executor parameters;Workflow parameters in each entrypoint.

  • Array [
  • namestringrequired
    flagstring
    shortFlagstring
    typestringrequired

    Possible values: [string, number, boolean, positional, file]

    requiredboolean
    labelstring
    descriptionstring
    defaultValuestring
    multipleboolean
    controlstring

    Shared form control hint. Date-related controls keep string values: date uses YYYY-MM-DD, time uses HH:mm:ss, datetime uses local YYYY-MM-DDTHH:mm:ss, and date-range uses inclusive YYYY-MM-DD/YYYY-MM-DD. Date controls do not support panel=quick.

    Possible values: [text, textarea, radio, select, checkboxes, date, time, datetime, date-range]

    panelstring

    Possible values: [main, auxiliary, quick]

    resolveOnInputboolean

    Whether main composer input changes trigger the selected entrypoint resolver (or the Conversation executor resolver). Defaults to false.

    options object[]
  • Array [
  • valuestringrequired
    labelstring
    descriptionstring
  • ]
  • acceptstring[]
    formatstring

    Possible values: [json]

  • ]
  • paramResolver object
    property name*any
    toolsobject[]

    Conversation executor tools;Workflow tools are located in each entrypoint.

    tokenUsage object
    property name*any
    registryobject[]
    kanban object

    Kanban static artifact boundary.

    artifactDirstringrequired

    Static product directory relative to the project root; old projects default ..

    Example: dist
    entrystringrequired

    Relative artifactDir HTML entry; default index.html.

    Example: index.html
    manifest object
    versionintegerrequired
    Constant value: 1
    params object[]required
  • Array [
  • namestringrequired
    flagstring
    shortFlagstring
    typestringrequired

    Possible values: [string, number, boolean, positional, file]

    requiredboolean
    labelstring
    descriptionstring
    defaultValuestring
    multipleboolean
    controlstring

    Shared form control hint. Date-related controls keep string values: date uses YYYY-MM-DD, time uses HH:mm:ss, datetime uses local YYYY-MM-DDTHH:mm:ss, and date-range uses inclusive YYYY-MM-DD/YYYY-MM-DD. Date controls do not support panel=quick.

    Possible values: [text, textarea, radio, select, checkboxes, date, time, datetime, date-range]

    panelstring

    Possible values: [main, auxiliary, quick]

    resolveOnInputboolean

    Whether main composer input changes trigger the selected entrypoint resolver (or the Conversation executor resolver). Defaults to false.

    options object[]
  • Array [
  • valuestringrequired
    labelstring
    descriptionstring
  • ]
  • acceptstring[]
    formatstring

    Possible values: [json]

  • ]
  • property name*any
    WorkflowStructureResultResponse
    {
    "errCode": 0,
    "errMessage": "string",
    "data": {
    "workflowId": "string",
    "workflowName": "string",
    "target": "string",
    "resolvedTarget": "string",
    "structure": {
    "projectType": "workflow",
    "workflow": {},
    "definitions": {},
    "diagnostics": {},
    "defaultEntrypoint": "string",
    "entrypoints": [
    {
    "id": "string",
    "title": "string",
    "description": "string",
    "workflowName": "string",
    "execution": {
    "kind": "sequence",
    "location": {},
    "children": [
    {}
    ]
    },
    "params": [
    {
    "name": "string",
    "flag": "string",
    "shortFlag": "string",
    "type": "string",
    "required": true,
    "label": "string",
    "description": "string",
    "defaultValue": "string",
    "multiple": true,
    "control": "text",
    "panel": "main",
    "resolveOnInput": true,
    "options": [
    {
    "value": "string",
    "label": "string",
    "description": "string"
    }
    ],
    "accept": [
    "string"
    ],
    "format": "json"
    }
    ],
    "paramResolver": {
    "enabled": true
    },
    "tools": [
    {}
    ],
    "tokenUsage": {},
    "registry": [
    {}
    ]
    }
    ],
    "schedulePresets": [
    {
    "id": "string",
    "title": "string",
    "description": "string",
    "entrypointId": "string",
    "timezone": "string",
    "trigger": {
    "kind": "window-interval",
    "weekdays": [
    0
    ],
    "windows": [
    {
    "start": "string",
    "end": "string"
    }
    ],
    "intervalMinutes": 0
    },
    "paramValues": {}
    }
    ],
    "execution": {
    "kind": "sequence",
    "location": {},
    "children": [
    {}
    ]
    },
    "params": [
    {
    "name": "string",
    "flag": "string",
    "shortFlag": "string",
    "type": "string",
    "required": true,
    "label": "string",
    "description": "string",
    "defaultValue": "string",
    "multiple": true,
    "control": "text",
    "panel": "main",
    "resolveOnInput": true,
    "options": [
    {
    "value": "string",
    "label": "string",
    "description": "string"
    }
    ],
    "accept": [
    "string"
    ],
    "format": "json"
    }
    ],
    "paramResolver": {},
    "tools": [
    {}
    ],
    "tokenUsage": {},
    "registry": [
    {}
    ],
    "kanban": {
    "artifactDir": "dist",
    "entry": "index.html",
    "manifest": {
    "version": 1,
    "params": [
    {
    "name": "string",
    "flag": "string",
    "shortFlag": "string",
    "type": "string",
    "required": true,
    "label": "string",
    "description": "string",
    "defaultValue": "string",
    "multiple": true,
    "control": "text",
    "panel": "main",
    "resolveOnInput": true,
    "options": [
    {
    "value": "string",
    "label": "string",
    "description": "string"
    }
    ],
    "accept": [
    "string"
    ],
    "format": "json"
    }
    ]
    }
    }
    }
    }
    }