# info.description
API for setting and retrieving location aliases for devices

### Direction Choices

The `deviceIs` field can be passed as either the integer (`1`–`8`) or the corresponding text label (case-insensitive). The valid mappings are:

| **Integer Value** | **Text Label**            | **Implied Arrow**           |
|--------------------|---------------------------|-----------------------------|
| `1`               | "Above"                | Down arrow                 |
| `2`               | "to the Right and Above"| Down-to-the-left arrow     |
| `3`               | "to the Right of"       | Left arrow                 |
| `4`               | "to the Right and Below"| Up-to-the-left arrow       |
| `5`               | "Below"                | Up arrow                   |
| `6`               | "to the Left and Below" | Up-to-the-right arrow      |
| `7`               | "to the Left of"        | Right arrow                |
| `8`               | "to the Left and Above" | Down-to-the-right arrow    |

### Examples

- `deviceIs: 1` is equivalent to "Above".
- `deviceIs: "to the Left and Below"` is equivalent to integer `6`.
### Notes on Uniqueness

From the model’s `unique_together` constraints:

- **(`deviceid`, `deviceIs`) must be unique:**
  - You cannot create two aliases on the same device with the exact same relative direction (`deviceIs`).
- **(`name`) must be unique:**
  - Each alias name must be unique.

If you attempt to create a second alias that violates these constraints, the server typically responds with a `409 Conflict` or `400 Bad Request` containing a message about which constraint was violated.

# paths./location-aliases/.get.description
Retrieve a list of all location aliases associated with devices.

# paths./location-aliases/.post.description
Create a new location alias associated with a device.

# paths./location-aliases/{id}/.get.description
Fetch details of a specific location alias by its ID.

# paths./location-aliases/{id}/.get.parameters[].description
A unique integer value identifying this location alias.

# paths./location-aliases/{id}/.delete.description
Delete a specific location alias by its ID.

# paths./location-aliases/{id}/.delete.parameters[].description
A unique integer value identifying this location alias.