POST /v1/workflows/validate
/v1/workflows/validate
Request Body required
application/jsondefinition
object
REQUIRED
blockExpansions
object
inputSchema
object[]
description
string
key
string
required
boolean
type
string
nodes
object
REQUIRED
sensitivePropKeys
string[]
triggerNodeIds
string[]
TriggerNodeIDs lists the node IDs that are trigger (root) nodes. Every workflow declares this — single-trigger workflows ship ["root"] (the legacy node id), multi-trigger workflows list every trigger node id. Treating single-trigger as a forest-of-1 removes the two-path branching throughout the BE + FE; older rows without the field are backfilled by migration 000282 and the field-missing path stays as a read-side safety net (see FindTriggerNodeIDs) but is no longer exercised by saves.
"root" is also a runtime alias for "the trigger that fired this run" — {{root.X}} variable references resolve to the firing trigger regardless of which trigger fired. Don't repurpose the literal "root" as a trigger id on a multi-trigger workflow.
variableDefs
object[]
default
unknown
description
string
lifetime
string
persist resetname
string
type
string
number text boolean list objectname
string
Responses
application/jsoncode
integer
data
object
errors
object[]
code
string
field
string
message
string
nodeId
string
nodeName
string
type
string
valid
boolean
message
string
requestId
string
curl -X POST 'https://api.example.com/v1/workflows/validate' \ -H 'Authorization: Bearer YOUR_API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{}'
const response = await fetch('https://api.example.com/v1/workflows/validate', { method: 'POST', headers: { "Authorization": "Bearer YOUR_API_TOKEN", "Content-Type": "application/json" }, body: JSON.stringify({})});const data = await response.json();console.log(data);
import requestsheaders = { 'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.post('https://api.example.com/v1/workflows/validate', headers=headers, json={})print(response.json())
package mainimport ( "fmt" "io" "net/http" "strings")func main() { body := strings.NewReader(`{}`) req, _ := http.NewRequest("POST", "https://api.example.com/v1/workflows/validate", body) req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN") req.Header.Set("Content-Type", "application/json") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() result, _ := io.ReadAll(resp.Body) fmt.Println(string(result))}
{ "code": 200, "data": { "errors": [ { "code": "<string>", "field": "<string>", "message": "<string>", "nodeId": "<string>", "nodeName": "<string>", "type": "<string>" } ], "valid": true }, "message": "success", "requestId": "abc-123"}
Try this endpoint
/v1/workflows/validate
