Eliminare un sottodominio

Rimuove un sottodominio con hosting: il sito, la sua cartella sul server e il record DNS.

• Metodo: DELETE
• Indirizzo: https://console.icbs.it/api/v1/hosting/{hostname}/subdomains/{label}
• Permesso: Hosting — configurazione siti

Attenzione: i file del sottodominio vengono cancellati. È l'unica chiamata di questa sezione che elimina dati: assicurati di avere un backup se ti servono.

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
hostname	indirizzo	sì	Il dominio principale, per esempio esempio.it.
label	indirizzo	sì	La parte prima del dominio: blog per blog.esempio.it.

Esempio di richiesta

curl -X DELETE \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  https://console.icbs.it/api/v1/hosting/esempio.it/subdomains/blog

Esempio di risposta

{
  "hostname": "blog.esempio.it",
  "job": {
    "id": "wj_9d2p7q",
    "hostname": "blog.esempio.it",
    "type": "web.subdomain_delete",
    "status": "pending",
    "error": null,
    "createdAt": "2026-10-01T10:00:00.000Z",
    "updatedAt": "2026-10-01T10:00:00.000Z"
  }
}

La risposta contiene un job: la modifica viene applicata entro pochi minuti. Per sapere quando è conclusa, interroga lo stato dell'operazione.

Possibili errori

Codice	Causa
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso Hosting — configurazione siti.
404	Il sottodominio non esiste o la chiave non vi ha accesso.