Modifier un seuil

PATCH /alerts/{id}

Scope alerts:write
Clé API x-api-key
URL de base https://api.hub.akuasense.com/v1

Seuls les champs envoyés changent.

Paramètres de chemin

id string uuid obligatoire

En-têtes

Idempotency-Key string

Rejoue la même réponse 2xx (24 h)

Corps de la requête

threshold number

Seuil, en % d’humidité volumique.
hysteresis number

Marge de résolution, en points de %.
reminderTime string

Heure locale du rappel quotidien (HH:MM:SS).
isActive boolean

false désactive l’alerte, true la réactive.

Réponse

200

Alerte modifiée

id string uuid toujours présent
companyId integer toujours présent
moduleId integer peut être null toujours présent

Module surveillé.
parcelId integer peut être null toujours présent

Parcelle. ⚠️ Seules les mesures d’un module sont évaluées : une alerte sans moduleId ne se déclenche jamais.
annotationId string uuid peut être null toujours présent

Ligne « point de flétrissement » dont l’alerte est née (source: annotation). Déplacer la ligne déplace le seuil ; la supprimer désactive l’alerte.
threshold string toujours présent

Seuil, en % d’humidité volumique.
hysteresis string toujours présent

Marge de résolution, en points de % : l’alerte se résout à threshold + hysteresis.
reminderTime string toujours présent

Heure LOCALE du rappel quotidien (HH:MM:SS), dans le fuseau de la société (timezone de GET /company).
source string toujours présent

manual : créée directement (POST /alerts). annotation : née d’une ligne « point de flétrissement ».

Valeurs : manualannotation
isActive boolean toujours présent

false : désactivée, plus évaluée.
createdBy string toujours présent

Créateur : userId d’un membre.
createdAt string date-time toujours présent
updatedAt string date-time toujours présent

Erreurs

400
Corps invalide
401
Non authentifié
403
Scope/rôle insuffisant ou hors société

PATCH /alerts/{id}

curl -X PATCH https://api.hub.akuasense.com/v1/alerts/6f1d0b9e-2c4a-4e8b-9d3f-7a5c1e2b8d40 \
  -H "x-api-key: VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "threshold": 10
  }'

const response = await fetch(
  'https://api.hub.akuasense.com/v1/alerts/6f1d0b9e-2c4a-4e8b-9d3f-7a5c1e2b8d40',
  {
    method: 'PATCH',
    headers: {
      'x-api-key': 'VOTRE_CLE_API',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      "threshold": 10
    }),
  },
);
const data = await response.json();

import requests

response = requests.patch(
    "https://api.hub.akuasense.com/v1/alerts/6f1d0b9e-2c4a-4e8b-9d3f-7a5c1e2b8d40",
    headers={"x-api-key": "VOTRE_CLE_API"},
    json={
        "threshold": 10,
    },
)
data = response.json()

Réponse

{
  "id": "6f1d0b9e-2c4a-4e8b-9d3f-7a5c1e2b8d40",
  "companyId": 8,
  "moduleId": 145,
  "parcelId": null,
  "annotationId": null,
  "threshold": "10",
  "hysteresis": "5",
  "reminderTime": "07:30:00",
  "source": "manual",
  "isActive": true,
  "createdBy": "cmf8x2k4q0002js08h4m2c8kv",
  "createdAt": "2026-09-11T09:02:14.318Z",
  "updatedAt": "2026-09-11T09:05:41.027Z"
}

application/json

{
  "type": "string",
  "title": "string",
  "status": 400,
  "detail": "string",
  "code": "string"
}

application/problem+json · exemple généré depuis le schéma

{
  "type": "string",
  "title": "string",
  "status": 401,
  "detail": "string",
  "code": "string"
}

application/problem+json · exemple généré depuis le schéma

{
  "type": "string",
  "title": "string",
  "status": 403,
  "detail": "string",
  "code": "string"
}

application/problem+json · exemple généré depuis le schéma