# Recorders - Interface Definition

Recorders RESTful interface definition

Get all recorders
URL | http://<server>/dialogicwebservice/mediacontrol/recorders?appid=<appid>
Method | GET
Returns | 200 OK & XML (dialogic/recorders+xml)
Create a new recorder
URL | http://<server>/dialogicwebservice/mediacontrol/recorders?appid=<appid>
Method | POST
Request Body | XML (dialogic/recorder+xml)
Returns | 201 Created & Location + XML (dialogic/recorder+xml)
415 Unsupported Media Type
Get a specific recorder
URL | http://<server>/dialogicwebservice/mediacontrol/recorders/<identifier>?appid=<appid>
Method | GET
Returns | 200 OK & XML (dialogic/recorder+xml)
404 Not Found
Delete a specific recorder
URL | http://<server>/dialogicwebservice/mediacontrol/recorders/<identifier>?appid=<appid>
Method | DELETE
Returns | 204 No Content
404 Not Found
Update a specific recorder
URL | http://<server>/dialogicwebservice/mediacontrol/recorders/<identifier>?appid=<appid>
Method | PUT
Request Body | XML (dialogic/recorder+xml)
Returns | 201 Created & Location
404 Not Found
415 Unsupported Media Type

dialogic/recorders and dialogic/recorder XML definitions

recorders size="<size>">
<recorder identifier="<identifier>" appid="<appid>"
href="http://server/dialogicwebservice/mediacontrol/recorders/<identifier>"
streamidentifier="<stream identifier>" conferenceidentifier="<conference identifier>"
destination="<destination>" append="< boolean >" duration=”<duration>”
dtmfterminate=”<digits>” initsilence=”<milliseconds>” endsilence=”<milliseconds>”/>
<recorder identifier="<identifier>" appid="<appid>"
href="http://server/dialogicwebservice/mediacontrol/recorders/<dentifier>"
streamidentifier="<stream identifier>" conferenceidentifier="<conference identifier>"
destination="<destination>" append="< boolean >" duration=”<duration>”
dtmfterminate=”<digits>” initsilence=”<milliseconds>” endsilence=”<milliseconds>”/>
<recorder identifier="<identifier>" appid="<appid>"
href="http://server/dialogicwebservice/mediacontrol/recorders/<identifier>"
streamidentifier="<stream identifier>" conferenceidentifier="<conference identifier>"
destination="<destination>" append="< boolean >" duration=”<duration>”
dtmfterminate=”<digits>” initsilence=”<milliseconds>” endsilence=”<milliseconds>”/>
...
</recorders>

For more information refer to Recorder.