> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperwisor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Devices

> List devices, send commands, and store sensor data via the Manufacturer API.

All requests require the [auth headers](/api/authentication) and are relative to
the [base URL](/api/overview#base-url).

## List devices

```http theme={null}
GET /devices
```

## A device's commands

```http theme={null}
GET /devices/{deviceId}/commands
```

Returns the commands available for that device.

## Send a command

```http theme={null}
POST /commands/send
```

```json theme={null}
{
  "device_id": "your-device-id",
  "command_payload": { }
}
```

The `command_payload` is delivered to the device, where its firmware command
handler acts on it.

## Sensor data

Store readings:

```http theme={null}
POST /sensor-data
```

```json theme={null}
{
  "device_id": "your-device-id",
  "sensor_data": { "temperature": 27.4, "humidity": 61 }
}
```

Read readings back:

```http theme={null}
GET /sensor-data
```

<Card title="Database" icon="database" href="/api/database">
  Schemas, tables, and runtime data.
</Card>