curl --request POST \
--url https://your-instance.example.com/api/workflows/nodes/{type}/test \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"config": {
"webhookId": "wh_64d2f9c5e8a1d4e001a0b1c3"
},
"input": {
"webhookId": "wh_64d2f9c5e8a1d4e001a0b1c3",
"payload": {
"lead": {
"name": "Alex Nguyen",
"email": "alex.nguyen@example.com"
}
}
}
}
'import requests
url = "https://your-instance.example.com/api/workflows/nodes/{type}/test"
payload = {
"config": { "webhookId": "wh_64d2f9c5e8a1d4e001a0b1c3" },
"input": {
"webhookId": "wh_64d2f9c5e8a1d4e001a0b1c3",
"payload": { "lead": {
"name": "Alex Nguyen",
"email": "alex.nguyen@example.com"
} }
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
config: {webhookId: 'wh_64d2f9c5e8a1d4e001a0b1c3'},
input: {
webhookId: 'wh_64d2f9c5e8a1d4e001a0b1c3',
payload: {lead: {name: 'Alex Nguyen', email: 'alex.nguyen@example.com'}}
}
})
};
fetch('https://your-instance.example.com/api/workflows/nodes/{type}/test', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://your-instance.example.com/api/workflows/nodes/{type}/test",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'config' => [
'webhookId' => 'wh_64d2f9c5e8a1d4e001a0b1c3'
],
'input' => [
'webhookId' => 'wh_64d2f9c5e8a1d4e001a0b1c3',
'payload' => [
'lead' => [
'name' => 'Alex Nguyen',
'email' => 'alex.nguyen@example.com'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://your-instance.example.com/api/workflows/nodes/{type}/test"
payload := strings.NewReader("{\n \"config\": {\n \"webhookId\": \"wh_64d2f9c5e8a1d4e001a0b1c3\"\n },\n \"input\": {\n \"webhookId\": \"wh_64d2f9c5e8a1d4e001a0b1c3\",\n \"payload\": {\n \"lead\": {\n \"name\": \"Alex Nguyen\",\n \"email\": \"alex.nguyen@example.com\"\n }\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://your-instance.example.com/api/workflows/nodes/{type}/test")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"config\": {\n \"webhookId\": \"wh_64d2f9c5e8a1d4e001a0b1c3\"\n },\n \"input\": {\n \"webhookId\": \"wh_64d2f9c5e8a1d4e001a0b1c3\",\n \"payload\": {\n \"lead\": {\n \"name\": \"Alex Nguyen\",\n \"email\": \"alex.nguyen@example.com\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://your-instance.example.com/api/workflows/nodes/{type}/test")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"config\": {\n \"webhookId\": \"wh_64d2f9c5e8a1d4e001a0b1c3\"\n },\n \"input\": {\n \"webhookId\": \"wh_64d2f9c5e8a1d4e001a0b1c3\",\n \"payload\": {\n \"lead\": {\n \"name\": \"Alex Nguyen\",\n \"email\": \"alex.nguyen@example.com\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"output": {
"webhookId": "wh_64d2f9c5e8a1d4e001a0b1c3",
"payload": {
"lead": {
"name": "Alex Nguyen",
"email": "alex.nguyen@example.com"
}
}
},
"durationMs": 4
}{
"success": false,
"message": "Workflow not found"
}{
"success": false,
"message": "Workflow not found"
}Validate and dry-run a single workflow node definition
Per-node dry-run endpoint used by the workflow builder when an author clicks “Test” on a node. The supplied config is parsed against the node’s configSchema; on validation failure the response is HTTP 200 with success:false and a Zod-style issues[] array so the UI can render field-level errors (4xx is intentionally avoided because the client wrapper throws on 4xx and strips the issues payload). On success: trigger-category nodes are executed against a synthesized ExecutionContext built from input (so the response reflects the actual trigger output a workflow would see) and side-effecting nodes return a mocked output derived from outputShape (real execution is deferred until per-executor dryRun guards land). Special case: WebhookTrigger simulates the HTTP-boundary validation done by /api/webhook/workflow and surfaces the same webhookId checks the real evaluator would apply.
curl --request POST \
--url https://your-instance.example.com/api/workflows/nodes/{type}/test \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"config": {
"webhookId": "wh_64d2f9c5e8a1d4e001a0b1c3"
},
"input": {
"webhookId": "wh_64d2f9c5e8a1d4e001a0b1c3",
"payload": {
"lead": {
"name": "Alex Nguyen",
"email": "alex.nguyen@example.com"
}
}
}
}
'import requests
url = "https://your-instance.example.com/api/workflows/nodes/{type}/test"
payload = {
"config": { "webhookId": "wh_64d2f9c5e8a1d4e001a0b1c3" },
"input": {
"webhookId": "wh_64d2f9c5e8a1d4e001a0b1c3",
"payload": { "lead": {
"name": "Alex Nguyen",
"email": "alex.nguyen@example.com"
} }
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
config: {webhookId: 'wh_64d2f9c5e8a1d4e001a0b1c3'},
input: {
webhookId: 'wh_64d2f9c5e8a1d4e001a0b1c3',
payload: {lead: {name: 'Alex Nguyen', email: 'alex.nguyen@example.com'}}
}
})
};
fetch('https://your-instance.example.com/api/workflows/nodes/{type}/test', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://your-instance.example.com/api/workflows/nodes/{type}/test",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'config' => [
'webhookId' => 'wh_64d2f9c5e8a1d4e001a0b1c3'
],
'input' => [
'webhookId' => 'wh_64d2f9c5e8a1d4e001a0b1c3',
'payload' => [
'lead' => [
'name' => 'Alex Nguyen',
'email' => 'alex.nguyen@example.com'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://your-instance.example.com/api/workflows/nodes/{type}/test"
payload := strings.NewReader("{\n \"config\": {\n \"webhookId\": \"wh_64d2f9c5e8a1d4e001a0b1c3\"\n },\n \"input\": {\n \"webhookId\": \"wh_64d2f9c5e8a1d4e001a0b1c3\",\n \"payload\": {\n \"lead\": {\n \"name\": \"Alex Nguyen\",\n \"email\": \"alex.nguyen@example.com\"\n }\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://your-instance.example.com/api/workflows/nodes/{type}/test")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"config\": {\n \"webhookId\": \"wh_64d2f9c5e8a1d4e001a0b1c3\"\n },\n \"input\": {\n \"webhookId\": \"wh_64d2f9c5e8a1d4e001a0b1c3\",\n \"payload\": {\n \"lead\": {\n \"name\": \"Alex Nguyen\",\n \"email\": \"alex.nguyen@example.com\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://your-instance.example.com/api/workflows/nodes/{type}/test")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"config\": {\n \"webhookId\": \"wh_64d2f9c5e8a1d4e001a0b1c3\"\n },\n \"input\": {\n \"webhookId\": \"wh_64d2f9c5e8a1d4e001a0b1c3\",\n \"payload\": {\n \"lead\": {\n \"name\": \"Alex Nguyen\",\n \"email\": \"alex.nguyen@example.com\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"output": {
"webhookId": "wh_64d2f9c5e8a1d4e001a0b1c3",
"payload": {
"lead": {
"name": "Alex Nguyen",
"email": "alex.nguyen@example.com"
}
}
},
"durationMs": 4
}{
"success": false,
"message": "Workflow not found"
}{
"success": false,
"message": "Workflow not found"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Registered node type (e.g. WebhookTrigger, SendMessage, IfCondition).
Body
config is parsed against the node's configSchema. input is only consumed by trigger-category nodes; for non-trigger nodes it is ignored and a mocked outputShape is returned. Trigger nodes receive input flattened into an ExecutionContext (so fields like contactId, messageId, from/to/subject are read from the top level).
Response
Test executed (success, mocked output, or validation failure). Inspect success to disambiguate.
Always 200 OK. Inspect success to disambiguate: true → trigger executed or non-trigger returned a mocked outputShape; false → config validation failed (issues array populated) OR WebhookTrigger boundary-check failed.