---
title: "POST /v2/sensor-alert-preferences/"
method: POST
path: "/v2/sensor-alert-preferences/"
tags: ["Sensor Alert Preferences"]
---

# POST /v2/sensor-alert-preferences/

`POST /v2/sensor-alert-preferences/`

GET  - List the current user's sensor alert preferences.
    POST - Create or update a sensor alert preference (upsert by alert_type).

## Request body

- SensorAlertPreference
  - `alert_type` 'offline_sensor' | 'waffle_fallen', required
  - `frequency` 'once' | 'daily' | 'weekly'
  - `spaces` SpaceIDOnly[]
  - `is_enabled` boolean
  - `last_alerted_at` string, date-time, nullable — When the last digest email was sent (used for daily/weekly throttling).
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Response `201`

Created

- OptionalSensorAlertPreferenceSerializer
  - `alert_type` 'offline_sensor' | 'waffle_fallen'
  - `frequency` 'once' | 'daily' | 'weekly'
  - `spaces` SpaceIDOnly[]
  - `is_enabled` boolean
  - `last_alerted_at` string, date-time, nullable — When the last digest email was sent (used for daily/weekly throttling).
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

[API](https://skmtc.dev/density/apis/your-project-api.md) · [All operations](https://skmtc.dev/density/apis/your-project-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/density/your-project-api/revisions/eab10fe035e6/schema)