> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# addVerb

> Append a verb to the main section of the SWML document.

Append a verb to the `main` section of the SWML document. Validates the verb config
against the bundled schema when validation is enabled.

> **Unknown verbs and keys throw**
>
> Validation is strict. An unknown verb name, an unknown or misspelled key inside
> the verb config, or a value of the wrong type throws a `SchemaValidationError`
> instead of being dropped silently. Set `SWML_SKIP_SCHEMA_VALIDATION=true` to
> disable validation.

## **Parameters**

**`verbName`** `string` — required

The SWML verb name (e.g., `"answer"`, `"ai"`, `"play"`, `"hangup"`).

---

**`config`** `unknown` — required

The verb's configuration payload. Most verbs accept an object of parameters.
The `sleep` verb accepts a number (duration in milliseconds).

---

## **Returns**

`void` -- Throws a `SchemaValidationError` if the verb fails schema validation
(when validation is enabled).

## **Example**

```typescript {4}
import { SwmlBuilder } from '@signalwire/sdk';

const builder = new SwmlBuilder();
builder.addVerb('answer', {});
builder.addVerb('play', { url: 'https://example.com/greeting.mp3' });
builder.addVerb('hangup', {});

console.log(builder.render());
```

> Append a verb to the main section of the SWML document.