Eliminare un gruppo

Rimuove un gruppo. L'operazione non è annullabile.

• Metodo: DELETE
• 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.
type	query	no	Tipo di gruppo. Se omesso vale il tipo predefinito.

Nessun corpo della richiesta.

Esempio di richiesta

curl -X DELETE \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  https://console.icbs.it/api/v1/groups/12

Esempio di risposta

{
  "deleted": {
    "id": 12,
    "name": "Clienti"
  }
}

Cosa succede ai domini del gruppo

I domini che appartenevano al gruppo restano invariati: perdono soltanto il raggruppamento e risultano senza gruppo assegnato.

Possibili errori

Codice	Causa
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.