setValidation | SignalWire

Toggle verb schema validation at runtime. When validation is enabled (the default), addVerb() validates each verb’s config against the schema and throws if it fails. Disable validation for performance-sensitive call paths or when constructing verbs with custom schemas not known to the built-in schema utilities.

Matches the Python schema_validation constructor parameter on AgentBase. For SWML service validation at construct time, pass schemaValidation: false to the SwmlBuilder constructor via SwmlBuilderOptions.

Parameters

enabled

booleanRequired

true to enable schema validation on subsequent addVerb() calls, false to disable.

Returns

void

Example

1 import { SwmlBuilder } from '@signalwire/sdk';
2 
3 const builder = new SwmlBuilder();
4 
5 // Validation on (default) — throws on invalid verb
6 builder.answer();
7 
8 // Disable validation for a hot path
9 builder.setValidation(false);
10 builder.addVerb('custom_verb', { unusual: 'payload' });

1	import { SwmlBuilder } from '@signalwire/sdk';
2
3	const builder = new SwmlBuilder();
4
5	// Validation on (default) — throws on invalid verb
6	builder.answer();
7
8	// Disable validation for a hot path
9	builder.setValidation(false);
10	builder.addVerb('custom_verb', { unusual: 'payload' });