Modificare le operazioni pianificate

Sostituisce l'intero elenco delle operazioni pianificate del sito.

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

Parametri

L'elenco inviato rimpiazza quello esistente. Per aggiungere o cambiare una sola voce, leggi l'elenco con Operazioni pianificate, modificalo e rimandalo per intero. Massimo 50 voci.

Parametro	Posizione	Obbligatorio	Descrizione
hostname	indirizzo	sì	Il nome del sito, per esempio esempio.it.
data	corpo	sì	Elenco di voci. Ogni voce ha minute, hour, day, month, weekday, command e, facoltativi, id (da omettere per una voce nuova) ed enabled.

Un elenco vuoto ({"data":[]}) rimuove tutte le operazioni pianificate.

Esempio di richiesta

curl -X PUT \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data":[{"minute":"0","hour":"3","day":"*","month":"*","weekday":"*","command":"php htdocs/cleanup.php"}]}' \
  https://console.icbs.it/api/v1/hosting/esempio.it/cron

Esempio di risposta

{
  "job": {
    "id": "wj_8f3k2m",
    "hostname": "esempio.it",
    "type": "web.cron",
    "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
400	Dati non validi.
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso Hosting — configurazione siti.
404	Il sito non esiste o la chiave non vi ha accesso.
409	Un'altra operazione è ancora in corso sul sito: riprova tra qualche minuto.
429	Superato il limite di richieste.