## Verb attributes

###### action

string

The `action` attribute takes in an absolute or relative URL. SignalWire will make a `GET` or `POST` request to this URL when recording is completed. The current document’s URL will be requested if no `action` is provided which can lead to unwanted looping behavior if you’re not careful.

###### finishOnKey

string

The set of digits, (0-9, \*, #), that can end a recording.

###### maxLength

integer

The maximum length, in seconds, of the recording. A value of zero means 3600 seconds.

###### method

stringDefaults to POST

The `method` attribute specifies whether the request to action is a `GET` or a `POST`. Valid values are `GET` or `POST`.

###### playBeep

booleanDefaults to true

Whether or not a sound is played before the start of a recording.

###### recordingStatusCallback

string

The `recordingStatusCallback` attribute takes in an absolute or relative URL. SignalWire will make a `GET` or `POST` request to this URL when recording is accessible.

###### recordingStatusCallbackEvent

stringDefaults to completed

The different recording statuses. Possible values are `completed`, `in-progress`, and `absent`. To specify multiple events, separate with a space.

###### recordingStatusCallbackMethod

stringDefaults to POST

The type of HTTP request to use when requesting a `recordingStatusCallback`.

###### storageUrl

string

The `storageUrl` attribute accepts an absolute URL as the destination to send a recording to, if you prefer to host your own recordings and bypass SignalWire storage.

###### storageUrlMethod

stringDefaults to POST

Specifies which HTTP verb to use when sending the recording to the `storageUrl`. Available values are: **POST** and **PUT**.

###### timeout

integer

The `timeout` attribute specifies the number of seconds of silence that ends a recording.

###### transcribe

booleanDefaults to false

The `transcribe` attribute identifies whether to produce a text transcription of the recording. There is an additional charge for this service, so is turned off by default.

###### transcribeCallback

string

The ability to define a URL to which SignalWire will make a `POST` request to once the transcription is complete.

###### trim

stringDefaults to trim-silence

Whether or not silence in the beginning and end of recordings are removed. Allowed values are `trim-silence` and `do-not-trim`.

##### the sound of silence

If no audio data is received, including when a caller is silent and `trim-silence` is enabled, SignalWire will not save a recording.
If you wish to save silence, be sure to set `trim="do-not-trim"`.

Note also that SignalWire will trim leading and trailing silence from your audio files, causing the duration of calls to be less than the time spent recording.

##### avoid looping

When recording finishes, including when no audio data is received, `<Record>` will always request its `action` URL and process the cXML instructions that are returned.
If no `action` URL is set, SignalWire will re-request the current cXML document’s URL by default.
**This can lead to unwanted looping behavior**, so make sure to end the call using `action` as seen in the

#### Request parameters for `action` URL

The `action` request contains the [Standard Request Parameters](/content/docs/compatibility-api/cxml/reference/voice#request-parameters/index.html) as well as:

###### Digits

string

The buttons pressed to end a recording.

###### RecordingDuration

integer

The duration, in seconds, of the audio recording.

###### RecordingUrl

string

The URL of the recorded audio file.

#### Request parameters for `recordingStatusCallback`

#### Request parameters for `transcribeCallback`

## Nesting

No other verbs can be nested within `<Record>` and you cannot nest `<Record>` within any other verbs.

## Examples

### Recording a voicemail

```xml
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Say>
        Please leave a message at the beep.
        Press the pound key when finished.
    </Say>
    <Record
        action="http://your-application.com/handleRecording.php"
        method="GET"
        maxLength="15"
        finishOnKey="#"
        />
</Response>
```

This prompt will play before the ‘beep’, asking the caller to leave a message. The caller can only leave a message that is 15s long.

### Transcribing a recording

```xml
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Record
        transcribe="true"
        transcribeCallback="http://your-application.com/handle_transcribe.php" />
</Response>
```

SignalWire will record the caller and transcribe the recording once it is complete.
Then, SignalWire will make a `POST` request to the `transcribeCallback` URL with the transcription as a parameter.