***

title: hold
slug: /reference/typescript/agents/function-result/hold
description: Put the call on hold with an optional timeout.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

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

Put the call on hold. The caller hears hold music until the hold is released
or the timeout expires.

## **Parameters**

<ParamField path="timeout" type="number" default="300" toc={true}>
  Maximum hold duration in seconds. Clamped to the range 0--900 (15 minutes max).
</ParamField>

## **Returns**

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

## **Example**

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

// Default 300-second hold
const result = new FunctionResult('Please hold.')
  .hold();
```