Vai al contenuto principale
PUT
/
notifications
/
{groupId}
Aggiorna un Gruppo di Notifica
curl --request PUT \
  --url https://api.altostrat.io/notifications/{groupId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Avvisi Team Reperibilità Primario",
  "schedule_id": "sch_7d1b8c0c-5121-4f27-849c-29b3a0e6201a",
  "mute": "schedule-active",
  "topics": [
    "top_9cffb446-18a5-445a-948c-e6f1d98930af",
    "top_9ba5d51f-3ada-44f2-9fb9-bf2404a29f50"
  ],
  "sites": [
    "site_a2b3c4d5-e6f7-g8h9-i0j1-k2l3m4n5o6p7",
    "site_b3c4d5e6-f7g8-h9i0-j1k2-l3m4n5o6p7q8"
  ],
  "notifiables": [
    {
      "id": "usr_5f0b6e1b-4f1e-4b4a-8b0a-0e6f0b6e1b4f",
      "channel": "whatsapp"
    }
  ]
}'
{
  "id": "ntfgrp_9b01a14c-1123-4279-88b1-3e42f9b846e1",
  "name": "Avvisi Team Reperibilità Primario",
  "schedule_id": "sch_7d1b8c0c-5121-4f27-849c-29b3a0e6201a",
  "mute": "schedule-active",
  "notifiables": [
    {
      "id": "usr_5f0b6e1b-4f1e-4b4a-8b0a-0e6f0b6e1b4f",
      "channel": "whatsapp"
    }
  ],
  "topics": [
    "top_9cffb446-18a5-445a-948c-e6f1d98930af",
    "top_9ba5d51f-3ada-44f2-9fb9-bf2404a29f50"
  ],
  "sites": [
    "site_a2b3c4d5-e6f7-g8h9-i0j1-k2l3m4n5o6p7",
    "site_b3c4d5e6-f7g8-h9i0-j1k2-l3m4n5o6p7q8"
  ],
  "created_at": "2025-10-29T12:24:17.000Z",
  "updated_at": "2025-10-29T12:28:00.000Z"
}

Authorizations

​
Authorization
string
header
required

Altostrat utilizza OAuth2 per l'autenticazione. I token possono essere ottenuti dall'API di Autenticazione di Altostrat.

Path Parameters

​
groupId
string<uuid>
required

L'identificatore univoco del gruppo di notifica.

Body

application/json

I dettagli aggiornati per il gruppo di notifica.

​
name
string
required

Un nome leggibile per il gruppo di notifica.

Maximum length: 100
Example:

"Avvisi Team Reperibilità Primario"

​
schedule_id
string<uuid>
required

L'UUID di un oggetto Schedule dall'API Chrono, che definisce quando questo gruppo è attivo.

Example:

"sch_7d1b8c0c-5121-4f27-849c-29b3a0e6201a"

​
mute
enum<string>
required

Controlla lo stato di silenziamento del gruppo. schedule-active silenzia quando la pianificazione è inattiva, schedule-inactive silenzia quando la pianificazione è attiva. never e always sono stati assoluti.

Opzioni disponibili:
schedule-active,
schedule-inactive,
never,
always
Example:

"schedule-active"

​
topics
string<uuid>[]
required

Un array di UUID di Argomenti a cui questo gruppo è iscritto.

Maximum length: 20
Example:
[
  "top_9cffb446-18a5-445a-948c-e6f1d98930af",
  "top_9ba5d51f-3ada-44f2-9fb9-bf2404a29f50"
]
​
sites
string<uuid>[]
required

Un array di UUID di Siti per i quali questo gruppo riceverà notifiche.

Maximum length: 800
Example:
[
  "site_a2b3c4d5-e6f7-g8h9-i0j1-k2l3m4n5o6p7",
  "site_b3c4d5e6-f7g8-h9i0-j1k2-l3m4n5o6p7q8"
]
​
notifiables
object[]
required

Un array di destinatari e i loro canali di notifica preferiti.

Maximum length: 200

Response

Gruppo di notifica aggiornato con successo.

​
id
string<uuid>

L'identificatore univoco per il gruppo di notifica.

Example:

"ntfgrp_9b01a14c-1123-4279-88b1-3e42f9b846e1"

​
name
string

Un nome leggibile per il gruppo di notifica.

Example:

"Avvisi Team Reperibilità Primario"

​
schedule_id
string<uuid>

L'UUID di un oggetto Schedule dall'API Chrono, che definisce quando questo gruppo è attivo.

Example:

"sch_7d1b8c0c-5121-4f27-849c-29b3a0e6201a"

​
mute
enum<string>

Controlla lo stato di silenziamento del gruppo. schedule-active silenzia quando la pianificazione è inattiva, schedule-inactive silenzia quando la pianificazione è attiva. never e always sono stati assoluti.

Opzioni disponibili:
schedule-active,
schedule-inactive,
never,
always
Example:

"schedule-active"

​
notifiables
object[]

Un array di destinatari e i loro canali di notifica designati.

​
topics
string<uuid>[]

Un array di UUID di Argomenti a cui questo gruppo è iscritto.

Example:
[
  "top_9cffb446-18a5-445a-948c-e6f1d98930af",
  "top_9ba5d51f-3ada-44f2-9fb9-bf2404a29f50"
]
​
sites
string<uuid>[]

Un array di UUID di Siti per i quali questo gruppo riceverà notifiche.

Example:
[
  "site_a2b3c4d5-e6f7-g8h9-i0j1-k2l3m4n5o6p7",
  "site_b3c4d5e6-f7g8-h9i0-j1k2-l3m4n5o6p7q8"
]
​
created_at
string<date-time>

La data e ora di creazione del gruppo di notifica.

Example:

"2025-10-29T12:24:17.000Z"

​
updated_at
string<date-time>

La data e ora dell'ultimo aggiornamento del gruppo di notifica.

Example:

"2025-10-29T12:28:00.000Z"