Errori

Ogni errore indica la sua causa. Lo stesso errore ha lo stesso codice su ogni accesso.

Via HTTP il corpo è { "code", "message" }. Via MCP l’errore porta un codice JSON-RPC e data.kind con lo stesso codice. La CLI stampa error: <messaggio> e termina con 1.

CodiceHTTPMCPQuandoCosa fare
unauthenticated401-32001Non è stato inviato un accesso o un token valido, oppure è scaduto.Accedi di nuovo con sddvault login, o crea un nuovo token.
forbidden403-32003Il tuo ruolo o l’accesso del token non consente l’azione, ad esempio un editor che scrive la costituzione.Chiedi a un proprietario del progetto, o usa un’identità o un token con l’accesso giusto.
policy403-32003Una politica dell’organizzazione o un limite del piano ha rifiutato la richiesta. Il codice è uno dei motivi qui sotto.Leggi il messaggio: indica la politica o il limite e come rimuoverlo.
not_found404-32002Il progetto, la spec, il documento, l’attività o la revisione non esiste, o non puoi vederlo; via HTTP anche un percorso che non è una rotta dell’API.Controlla l’indirizzo (organizzazione/progetto) e il numero.
conflict409-32602Il documento è cambiato dopo la revisione su cui si basava la tua scrittura.Leggi la revisione corrente (l’errore la include), unisci e scrivi di nuovo.
claimed409-32602Un altro agente o un’altra persona detiene la prenotazione dell’attività.Scegli un’altra attività, o attendi che la prenotazione venga rilasciata o scada.
validation422-32602L’input non è valido, è malformato o viene rifiutato, ad esempio un cambio di stato non valido o l’approvazione di una spec con marcatori aperti, o un numero di spec o un id nel percorso che non è un intero positivo.Leggi il messaggio: indica il campo o i valori consentiti.
inherited_principle422-32602Una scrittura della costituzione modifica un principio ereditato dall’organizzazione.Lascia i principi ereditati così come sono e aggiungi i tuoi.
precondition409, 410, 413-32602Lo stato della destinazione non consente la richiesta, non esiste più o il corpo è troppo grande.Leggi il messaggio e correggi lo stato prima di riprovare.
rate_limited429-32029Troppe richieste in poco tempo.Attendi i secondi indicati nell’intestazione Retry-After, poi riprova.
billing409, 422-32602Il provider di pagamento non è configurato o ha rifiutato un cambio di piano.Controlla i dati di fatturazione, o contatta il supporto.
identity_provider_refused422-32602Il provider di accesso ha rifiutato una modifica.Controlla i dettagli nel messaggio e riprova.
organization_creation410, 409, 503, 422-32602La creazione di un’organizzazione non è riuscita. Il codice è uno di quelli qui sotto.Segui il messaggio e ricomincia se la richiesta è scaduta.
unavailable503-32603Un servizio da cui dipende SDD Vault è temporaneamente non disponibile.Riprova tra un momento.
internal500-32603Qualcosa è andato storto da parte nostra.Riprova; se persiste, contatta il supporto.

Rifiuti per politica e per piano

CodiceQuando
ip_not_allowedL’elenco di IP consentiti dell’organizzazione non include la tua rete.
guests_disabledL’organizzazione non ammette ospiti.
admin_only_project_creationSolo gli owner e gli admin dell’organizzazione possono creare progetti.
plan_seat_limitIl piano non ha più posti per il ruolo che si sta aggiungendo.
plan_project_limitIl piano ha raggiunto il suo numero di progetti.
plan_featureLa funzione non è inclusa nel piano.
plan_mcp_call_limitLe chiamate MCP mensili del piano sono esaurite; riprendono il primo giorno del mese successivo.

Codici di creazione dell’organizzazione

CodiceQuando
organization_request_expiredLa richiesta di creazione è scaduta; ricomincia.
organization_already_createdL’organizzazione è già stata creata con questa richiesta.
organization_creation_pausedLa creazione di organizzazioni è temporaneamente sospesa.
bot_check_failedIl controllo anti-bot non è riuscito; riprova.