> 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.

# swmlTransfer

> Transfer the call to a SWML endpoint with a custom AI response.

[connect]: /docs/server-sdks/reference/typescript/agents/function-result/connect

[functionresult]: /docs/server-sdks/reference/typescript/agents/function-result

Transfer the call to a SWML endpoint. The `aiResponse` text is injected into
the call flow via a SWML `set` verb before the transfer executes.

> **Tip**
>
> For simple phone-number or SIP transfers, use [`connect()`][connect] instead.
> Use `swmlTransfer()` when you need to hand off to another SWML document and
> set up a return message.

## **Parameters**

**`dest`** `string` — required

Destination URL for the transfer (a SWML endpoint, SIP address, etc.).

---

**`aiResponse`** `string` — required

Text injected as `ai_response` via a SWML `set` verb before the transfer
executes.

---

**`final`** `boolean` — default: true

Whether this is a permanent transfer (`true`) or temporary (`false`).

---

## **Returns**

[`FunctionResult`][functionresult] -- `this`, for chaining.

## **Example**

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

const result = new FunctionResult()
  .swmlTransfer('sip:support@example.com', 'Transferring you to support.');
```

> Transfer the call to a SWML endpoint with a custom AI response.