Cambia le impostazioni di una casella esistente, password compresa.
PATCHhttps://console.icbs.it/api/v1/email/{dominio}/accounts/{id}| Parametro | Posizione | Obbligatorio | Descrizione |
|---|---|---|---|
dominio | indirizzo | sì | Il nome a dominio, per esempio esempio.it. |
id | indirizzo | sì | L'identificativo della casella, come nell'elenco. |
name | corpo | no | Il nome visualizzato. |
password | corpo | no | La nuova password, almeno 8 caratteri. |
quotaBytes | corpo | no | Spazio assegnato. |
active | corpo | no | false sospende la casella senza cancellarla. |
protocols | corpo | no | Quali protocolli abilitare. Indica solo quelli che vuoi cambiare. |
copyTo | corpo | no | Copia dei messaggi in arrivo. null toglie la copia. |
note | corpo | no | Nota interna. null la svuota. |
Ogni campo che ometti resta com'è. Serve almeno un campo.
address non è modificabile: sarebbe un'altra casella, con un'altra posta. Per cambiarlo crea la nuova casella ed elimina la vecchia quando hai spostato i messaggi.
curl -X PATCH -H "Authorization: Bearer $ICBS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"quotaBytes":10737418240,"protocols":{"pop3":false}}' \
https://console.icbs.it/api/v1/email/esempio.it/accounts/318
{
"id": 318,
"address": "info@esempio.it",
"name": "Informazioni",
"active": true,
"quotaBytes": 10737418240,
"usedBytes": 1288490188,
"protocols": { "imap": true, "pop3": false, "smtp": true }
}
Con active: false la casella smette di ricevere e inviare, ma la posta resta al suo posto e si può riattivare quando vuoi. È la scelta giusta quando non sei sicuro che la casella non serva più.
| Codice | Causa |
|---|---|
400 | Nessun campo da aggiornare, oppure valori non validi. |
401 | Chiave assente, non valida, scaduta o revocata. |
403 | Alla chiave manca il permesso Email — scrittura. |
404 | La casella o il dominio non esistono o non sono accessibili. |
409 | Il dominio è protetto da modifiche o non è attivo. |
429 | Superato il limite di richieste. |