Skip to main content
POST
Crear una nueva alerta

Authorizations

Authorization
string
header
required

Token de sesión Better Auth o API token (atk_...) en el header Authorization: Bearer <token>. Los JWT legacy ya no son válidos.

Body

application/json

Payload de creación/edición de alerta según tipo (discriminado por alertTriggerId). La validación exige los campos del tipo correspondiente.

alertTriggerId
string
required

ID del disparador de alerta (determina el tipo y los campos requeridos)

name
string
required

Nombre de la alerta

assets
string[]
required

IDs de activos asociados

users
string[]
required

IDs de usuarios. Si typeNotification.app o typeNotification.browser son true, es obligatorio y debe tener al menos un elemento.

speedLimit
number
required

Límite de velocidad en km/h. Obligatorio para tipo exceso de velocidad. Crea calculator en Flespi automáticamente.

emails
string<email>[]

Emails para notificaciones. Si typeNotification.email es true, es obligatorio y debe tener al menos un elemento.

phones
string[]

Teléfonos para notificaciones (whatsapp). Si typeNotification.whatsapp es true, es obligatorio y debe tener al menos un elemento.

typeNotification
object

Canales de notificación. Si un canal está en true, el array asociado no puede estar vacío:

  • email true requiere al menos un email en emails
  • whatsapp true requiere al menos un teléfono en phones
  • app o browser true requieren al menos un usuario en users
state
boolean

Estado de la alerta (true activa, false inactiva)

description
string

Descripción opcional

minDuration
number

Duración mínima en segundos. Por defecto 30 para exceso de velocidad.

Response

Alerta creada exitosamente

status
string
Example:

"success"

data
object

Alerta completa (respuesta del servidor). Incluye todos los campos posibles según el tipo.