> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emailx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Errori

> Leggi insieme stato HTTP, codice di errore e ID della richiesta.

```json theme={null}
{
  "error": {
    "code": "insufficient_scope",
    "message": "This endpoint requires contacts:read.",
    "request_id": "req_example"
  }
}
```

| Stato | Significato | Azione |
| - | - | - |
| 400 | Input, parametri o cursore non validi | Correggi la richiesta |
| 401 | Chiave non valida, scaduta, revocata o di un altro ambiente | Verifica host e credenziale |
| 403 | Scope mancante, ruolo viewer o scrittura non consentita | Controlla ruolo e accesso attuali |
| 404 | Risorsa mancante o inaccessibile | Verifica workspace e canale |
| 409 | Duplicato, stato campagna, conflitto replay o esito incerto | Leggi codice e risorsa salvata |
| 413 / 415 | Corpo troppo grande / formato non supportato | Riduci il JSON / usa application/json |
| 429 | Budget delle richieste esaurito | Attendi Retry-After |
| 500 / 503 | Errore temporaneo, storage non disponibile o funzione disabilitata | Verifica le modifiche e leggi il codice |

## Privacy e dati incompleti

Un `404` non distingue un record inesistente da quello di un altro cliente. Non enumerare gli ID. `503 feature_unavailable` sugli esiti indica una funzione disabilitata, non l'assenza di esiti positivi.

## Contesto per l'assistenza

Conserva ID richiesta, timestamp, ambiente, metodo, percorso e codice errore. Rimuovi autorizzazione e corpi privati dei messaggi. Condividi il contesto con il tuo referente Emailx. Prima di riprovare una modifica, leggi [idempotenza e recupero](https://docs.emailx.ai/it/api-reference/idempotency.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.