# Asterisk Project : Asterisk 13 Devicestates REST API

Created by wikibot on Aug 08, 2014

# Devicestates

Method | Path | Return Model | Summary
--- | --- | --- | ---
GET | /deviceStates | List[DeviceState] | List all ARI controlled device states.
GET | /deviceStates/{deviceName} | DeviceState | Retrieve the current state of a device.
PUT | /deviceStates/{deviceName} | void | Change the state of a device controlled by ARI. (Note - implicitly creates the device state).
DELETE | /deviceStates/{deviceName} | void | Destroy a device-state controlled by ARI.

## GET /deviceStates

List all ARI controlled device states.

## GET /deviceStates/{deviceName}

Retrieve the current state of a device.

### Path parameters

- deviceName: string - Name of the device

## PUT /deviceStates/{deviceName}

Change the state of a device controlled by ARI. (Note - implicitly creates the device state).

### Path parameters

- deviceName: string - Name of the device

### Query parameters

- deviceState: string - (required) Device state value

### Error Responses

- 404 - Device name is missing
- 409 - Uncontrolled device specified

## DELETE /deviceStates/{deviceName}

Destroy a device-state controlled by ARI.

### Path parameters

- deviceName: string - Name of the device

### Error Responses

- 404 - Device name is missing
- 409 - Uncontrolled device specified