# Asterisk Project : Asterisk 13 Recordings REST API

Created by wikibot on Aug 08, 2014

# Recordings

Method | Path | Return Model | Summary
--- | --- | --- | ---
GET | /recordings/stored | List[StoredRecording] | List recordings that are complete.
GET | /recordings/stored/{recordingName} | StoredRecording | Get a stored recording's details.
DELETE | /recordings/stored/{recordingName} | void | Delete a stored recording.
POST | /recordings/stored/{recordingName}/copy | StoredRecording | Copy a stored recording.
GET | /recordings/live/{recordingName} | LiveRecording | List live recordings.
DELETE | /recordings/live/{recordingName} | void | Stop a live recording and discard it.
POST | /recordings/live/{recordingName}/stop | void | Stop a live recording and store it.
POST | /recordings/live/{recordingName}/pause | void | Pause a live recording.
DELETE | /recordings/live/{recordingName}/pause | void | Unpause a live recording.
POST | /recordings/live/{recordingName}/mute | void | Mute a live recording.
DELETE | /recordings/live/{recordingName}/mute | void | Unmute a live recording.

## GET /recordings/stored

List recordings that are complete.

## GET /recordings/stored/{recordingName}

Get a stored recording's details.

### Path parameters

- recordingName: string - The name of the recording

### Error Responses

- 404 - Recording not found

## DELETE /recordings/stored/{recordingName}

Delete a stored recording.

### Path parameters

- recordingName: string - The name of the recording

### Error Responses

- 404 - Recording not found

## POST /recordings/stored/{recordingName}/copy

Copy a stored recording.

### Path parameters

- recordingName: string - The name of the recording to copy

### Query parameters

- destinationRecordingName: string - (required) The destination name of the recording

### Error Responses

- 404 - Recording not found
- 409 - A recording with the same name already exists on the system

## GET /recordings/live/{recordingName}

List live recordings.

### Path parameters

- recordingName: string - The name of the recording

### Error Responses

- 404 - Recording not found

## DELETE /recordings/live/{recordingName}

Stop a live recording and discard it.

### Path parameters

- recordingName: string - The name of the recording

### Error Responses

- 404 - Recording not found

## POST /recordings/live/{recordingName}/stop

Stop a live recording and store it.

### Path parameters

- recordingName: string - The name of the recording

### Error Responses

- 404 - Recording not found

## POST /recordings/live/{recordingName}/pause

Pause a live recording. Pausing a recording suspends silence detection, which will be restarted when the recording is unpaused. Paused time is not included in the accounting for maxDurationSeconds.

### Path parameters

- recordingName: string - The name of the recording

### Error Responses

- 404 - Recording not found
- 409 - Recording not in session

## DELETE /recordings/live/{recordingName}/pause

Unpause a live recording.

### Path parameters

- recordingName: string - The name of the recording

### Error Responses

- 404 - Recording not found
- 409 - Recording not in session

## POST /recordings/live/{recordingName}/mute

Mute a live recording. Muting a recording suspends silence detection, which will be restarted when the recording is unmuted.

### Path parameters

- recordingName: string - The name of the recording

### Error Responses

- 404 - Recording not found
- 409 - Recording not in session

## DELETE /recordings/live/{recordingName}/mute

Unmute a live recording.

### Path parameters

- recordingName: string - The name of the recording

### Error Responses

- 404 - Recording not found
- 409 - Recording not in session