Modificare un gruppo

Aggiorna nome o descrizione di un gruppo esistente.

• Metodo: PATCH
• Indirizzo: https://console.icbs.it/api/v1/groups/{id}
• Permesso: Gruppi — creazione, modifica ed eliminazione

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
id	indirizzo	sì	Identificativo del gruppo, da l'elenco dei gruppi.
name	corpo	no	Nuovo nome.
comment	corpo	no	Nuova descrizione.

Esempio di richiesta

curl -X PATCH \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Clienti storici"}' \
  https://console.icbs.it/api/v1/groups/12

Esempio di risposta

{
  "updated": {
    "id": 12,
    "name": "Clienti storici",
    "type": "domain"
  }
}

Possibili errori

Codice	Causa
400	Dati non validi.
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso di scrittura sui gruppi, oppure chi l'ha creata non ha più i permessi di modifica.
404	Il gruppo non esiste o non appartiene al tuo account.
429	Superato il limite di richieste.