# Asterisk Project : Asterisk 12 Recordings REST API

Added by dlee , edited by dlee on Aug 29, 2013

# 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.
GET | /recordings/live | List[LiveRecording] | List libe recordings.
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.
POST | /recordings/live/{recordingName}/unpause | void | Unpause a live recording.
POST | /recordings/live/{recordingName}/mute | void | Mute a live recording.
POST | /recordings/live/{recordingName}/unmute | 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

## DELETE /recordings/stored/{recordingName}

Delete a stored recording.

### Path parameters

- recordingName: string - The name of the recording

## GET /recordings/live

List libe recordings.

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

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

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

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

Unmute a live recording.

### Path parameters

- recordingName: string - The name of the recording

### Error Responses

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