Erros

Cada erro indica a sua causa. A mesma falha tem o mesmo código em todos os acessos.

Por HTTP o corpo é { "code", "message" }. Por MCP o erro traz um código JSON-RPC e data.kind com o mesmo código. A CLI imprime error: <mensagem> e termina com 1.

CódigoHTTPMCPQuandoO que fazer
unauthenticated401-32001Não foi enviado um início de sessão ou token válido, ou expirou.Inicie sessão de novo com sddvault login, ou crie um novo token.
forbidden403-32003A sua função ou o acesso do token não permite a ação, por exemplo um editor a escrever a constituição.Peça a um proprietário do projeto, ou use uma identidade ou um token com o acesso certo.
policy403-32003Uma política da organização ou um limite do plano recusou o pedido. O código é um dos motivos abaixo.Leia a mensagem: indica a política ou o limite e como o levantar.
not_found404-32002O projeto, a spec, o documento, a tarefa ou a revisão não existe, ou não o pode ver; por HTTP também um caminho que não é uma rota da API.Verifique o endereço (organização/projeto) e o número.
conflict409-32602O documento mudou depois da revisão em que baseou a sua escrita.Leia a revisão atual (o erro inclui-a), una as alterações e escreva de novo.
claimed409-32602Outro agente ou outra pessoa tem a reserva da tarefa.Escolha outra tarefa, ou aguarde que a reserva seja libertada ou expire.
validation422-32602A entrada é inválida, está mal formada ou foi recusada, por exemplo uma mudança de estado inválida ou aprovar uma spec com marcadores abertos, ou um número de spec ou um id no caminho que não é um inteiro positivo.Leia a mensagem: indica o campo ou os valores permitidos.
inherited_principle422-32602Uma escrita da constituição altera um princípio herdado da organização.Deixe os princípios herdados como estão e acrescente os seus.
precondition409, 410, 413-32602O estado do destino não permite o pedido, já não existe ou o corpo é demasiado grande.Leia a mensagem e corrija o estado antes de tentar de novo.
rate_limited429-32029Demasiados pedidos em pouco tempo.Aguarde os segundos do cabeçalho Retry-After e tente de novo.
billing409, 422-32602O fornecedor de pagamentos não está configurado ou recusou uma mudança de plano.Reveja os dados de faturação, ou contacte o suporte.
identity_provider_refused422-32602O fornecedor de início de sessão recusou uma alteração.Reveja o detalhe na mensagem e tente de novo.
organization_creation410, 409, 503, 422-32602A criação de uma organização falhou. O código é um dos de baixo.Siga a mensagem e recomece se o pedido expirou.
unavailable503-32603Um serviço de que o SDD Vault depende está temporariamente indisponível.Tente de novo daqui a pouco.
internal500-32603Algo falhou do nosso lado.Tente de novo; se persistir, contacte o suporte.

Recusas por política e por plano

CódigoQuando
ip_not_allowedA lista de IPs permitidos da organização não inclui a sua rede.
guests_disabledA organização não admite convidados.
admin_only_project_creationSó os owners e admins da organização podem criar projetos.
plan_seat_limitO plano já não tem lugares para a função que se está a acrescentar.
plan_project_limitO plano atingiu o seu número de projetos.
plan_featureA funcionalidade não está incluída no plano.
plan_mcp_call_limitAs chamadas MCP mensais do plano esgotaram-se; retomam no primeiro dia do mês seguinte.

Códigos de criação de organização

CódigoQuando
organization_request_expiredO pedido de criação expirou; recomece.
organization_already_createdA organização já foi criada com este pedido.
organization_creation_pausedA criação de organizações está temporariamente suspensa.
bot_check_failedA verificação anti-robô falhou; tente de novo.