# Conferences - Interface Definition

Conferences RESTful interface definition

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

dialogic/conferences and dialogic/conference XML definitions

<conferences size="<size>">
<conference identifier="<identifier>" appid="<appid>"
href="http://server/dialogicwebservice/mediacontrol/conferences/<identifier>">
<mediastream identfier="<stream identifier>" action=”<action>” />
<mediastream identfier="<stream identifier>" action=”<action>” />
<mediastream identfier="<stream identifier>" action=”<action>” "/>
...
</conference>
<conference identifier="<identifier>" appid="<appid>"
href="http://server/dialogicwebservice/mediacontrol/conferences/<identifier>">
<mediastream identfier="<stream identifier>" action=”<action>” "/>
<mediastream identfier="<stream identifier>" action=”<action>” "/>
<mediastream identfier="<stream identifier>" action=”<action>” "/>
...
</conference>
...
</conferences>

For more information refer to Conference.