Sensors API
Submit sensor readings for beats and scenes.
POST /sensors/readings
| Field | Type | Required |
|---|---|---|
sensor_id | string | Yes |
beat_id | UUID | Yes |
scene_id | UUID | Yes |
type | string | Yes |
metric | string | Yes |
value | any | Yes |
confidence | number | No (default: 1.0) |
type: delivery, engagement, response, behavior, sentiment, conversion
// 201
{
"reading": {
"id": "uuid",
"sensorId": "twilio-delivery",
"type": "delivery",
"metric": "delivered",
"value": true,
"confidence": 1.0,
"createdAt": "2025-01-15T08:01:00Z"
}
}POST /sensors/readings/batch
Body: { "readings": [{ ...same fields as above }] }
// 201
{
"readings": []
}