Erreurs

Chaque erreur nomme sa cause. Le même échec porte le même code partout.

En HTTP, le corps est { "code", "message" }. En MCP, l’erreur porte un code JSON-RPC et data.kind avec le même code. La CLI affiche error: <message> et se termine avec 1.

CodeHTTPMCPQuandQue faire
unauthenticated401-32001Aucune connexion ni aucun jeton valide n’a été envoyé, ou il a expiré.Reconnectez-vous avec sddvault login, ou créez un nouveau jeton.
forbidden403-32003Votre rôle ou l’accès du jeton n’autorise pas l’action, par exemple un éditeur qui écrit la constitution.Demandez à un propriétaire du projet, ou utilisez une identité ou un jeton avec le bon accès.
policy403-32003Une politique de l’organisation ou une limite de l’offre a refusé la requête. Le code est l’un des motifs ci-dessous.Lisez le message : il nomme la politique ou la limite et comment la lever.
not_found404-32002Le projet, la spec, le document, la tâche ou la révision n’existe pas, ou vous ne pouvez pas le voir ; en HTTP aussi un chemin qui n’est pas une route de l’API.Vérifiez l’adresse (organisation/projet) et le numéro.
conflict409-32602Le document a changé après la révision sur laquelle reposait votre écriture.Lisez la révision courante (l’erreur la contient), fusionnez et écrivez de nouveau.
claimed409-32602Un autre agent ou une autre personne détient la réservation de la tâche.Choisissez une autre tâche, ou attendez que la réservation soit libérée ou expire.
validation422-32602L’entrée est invalide, mal formée ou refusée, par exemple un changement de statut invalide ou l’approbation d’une spec avec des marqueurs ouverts, ou un numéro de spec ou un identifiant dans le chemin qui n’est pas un entier positif.Lisez le message : il nomme le champ ou les valeurs autorisées.
inherited_principle422-32602Une écriture de la constitution modifie un principe hérité de l’organisation.Laissez les principes hérités tels quels et ajoutez les vôtres.
precondition409, 410, 413-32602L’état de la cible n’autorise pas la requête, elle n’existe plus, ou le corps est trop volumineux.Lisez le message et corrigez l’état avant de réessayer.
rate_limited429-32029Trop de requêtes en peu de temps.Attendez le nombre de secondes de l’en-tête Retry-After, puis réessayez.
billing409, 422-32602Le prestataire de paiement n’est pas configuré ou a refusé un changement d’offre.Vérifiez les informations de facturation, ou contactez le support.
identity_provider_refused422-32602Le fournisseur de connexion a refusé un changement.Consultez le détail du message et réessayez.
organization_creation410, 409, 503, 422-32602La création d’une organisation a échoué. Le code est l’un de ceux ci-dessous.Suivez le message et recommencez si la demande a expiré.
unavailable503-32603Un service dont dépend SDD Vault est temporairement indisponible.Réessayez dans un instant.
internal500-32603Quelque chose a échoué de notre côté.Réessayez ; si cela persiste, contactez le support.

Refus de politique et d’offre

CodeQuand
ip_not_allowedLa liste d’adresses IP autorisées de l’organisation n’inclut pas votre réseau.
guests_disabledL’organisation n’accepte pas les invités.
admin_only_project_creationSeuls les owners et admins de l’organisation peuvent créer des projets.
plan_seat_limitL’offre n’a plus de siège pour le rôle ajouté.
plan_project_limitL’offre a atteint son nombre de projets.
plan_featureLa fonctionnalité n’est pas incluse dans l’offre.
plan_mcp_call_limitLes appels MCP mensuels de l’offre sont épuisés ; ils reprennent le premier jour du mois suivant.

Codes de création d’organisation

CodeQuand
organization_request_expiredLa demande de création a expiré ; recommencez.
organization_already_createdL’organisation a déjà été créée à partir de cette demande.
organization_creation_pausedLa création d’organisations est temporairement suspendue.
bot_check_failedLa vérification anti-robot a échoué ; réessayez.