# VolumeControllers - Interface Definition

The following table contains the VolumeControllers RESTful interface definition.

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

dialogic/volumecontrollers and dialogic/volumecontroller XML definitions

<volumecontrollers size="<size>">
<volumecontroller identifier="<identifier>" appid="<appid>"
href="http://server/dialogicwebservice/mediacontrol/volumecontrollers/<identifier>"
streamidentifier="<stream identifier>"
conferenceidentifier="<conference identifier>"
level=”<level>”
delta=”<delta>” >
</volumecontroller>
<volumecontroller identifier="<identifier>" appid="<appid>"
href="http://server/dialogicwebservice/mediacontrol/volumecontrollers/<identifier>"
streamidentifier="<stream identifier>" conferenceidentifier="<conference identifier>"
level=”<level>” delta=”<delta>” >
</volumecontroller>
...
</volumecontrollers >

For more information refer to VolumeController.