Modificare un inoltro

Cambia i destinatari di un inoltro o lo sospende.

• Metodo: PATCH
• Indirizzo: https://console.icbs.it/api/v1/email/{dominio}/forwards/{id}
• Permesso: Email — scrittura

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
dominio	indirizzo	sì	Il nome a dominio, per esempio esempio.it.
id	indirizzo	sì	L'identificativo dell'inoltro, come nell'elenco.
destinations	corpo	no	Il nuovo elenco di destinatari: sostituisce quello attuale.
active	corpo	no	false sospende l'inoltro senza eliminarlo.
allowSendAs	corpo	no	Se il destinatario può inviare posta usando l'indirizzo di partenza.

Ogni campo che ometti resta com'è. Serve almeno un campo.

L'indirizzo di partenza non si cambia

source non è modificabile. Per spostare un inoltro su un altro indirizzo, creane uno nuovo ed elimina il vecchio.

I destinatari si sostituiscono, non si aggiungono

L'elenco che invii prende il posto di quello attuale. Per aggiungere un destinatario, indica tutti quelli che vuoi mantenere più il nuovo.

Esempio di richiesta

curl -X PATCH -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destinations":["amministrazione@altro-dominio.it","contabilita@altro-dominio.it"]}' \
  https://console.icbs.it/api/v1/email/esempio.it/forwards/88

Esempio di risposta

{
  "id": 88,
  "source": "ordini@esempio.it",
  "destinations": ["amministrazione@altro-dominio.it", "contabilita@altro-dominio.it"],
  "active": true,
  "allowSendAs": false
}

Possibili errori

Codice	Causa
400	Nessun campo da aggiornare, o destinatari non validi.
401	Chiave assente, non valida, scaduta o revocata.