Errores

Cada error indica su causa. El mismo fallo tiene el mismo código en todos los accesos.

Por HTTP el cuerpo es { "code", "message" }. Por MCP el error lleva un código JSON-RPC y data.kind con el mismo código. La CLI imprime error: <mensaje> y termina con 1.

CódigoHTTPMCPCuándoQué hacer
unauthenticated401-32001No se envió un inicio de sesión o token válido, o caducó.Inicia sesión de nuevo con sddvault login, o crea un token nuevo.
forbidden403-32003Tu rol o el acceso del token no permite la acción, por ejemplo un editor que escribe la constitución.Pide ayuda a un propietario del proyecto, o usa una identidad o un token con el acceso adecuado.
policy403-32003Una política de la organización o un límite del plan rechazó la petición. El código es uno de los motivos de más abajo.Lee el mensaje: indica la política o el límite y cómo levantarlo.
not_found404-32002El proyecto, la spec, el documento, la tarea o la revisión no existe, o no puedes verlo; por HTTP también una ruta que no es de la API.Comprueba la dirección (organización/proyecto) y el número.
conflict409-32602El documento cambió después de la revisión en la que basaste tu escritura.Lee la revisión actual (el error la incluye), fusiona y vuelve a escribir.
claimed409-32602Otro agente u otra persona tiene la reserva de la tarea.Elige otra tarea, o espera a que la reserva se libere o caduque.
validation422-32602La entrada no es válida, está mal formada o se rechaza, por ejemplo un cambio de estado inválido o aprobar una spec con marcadores abiertos, o un número de spec o un id en la ruta que no es un entero positivo.Lee el mensaje: indica el campo o los valores permitidos.
inherited_principle422-32602Una escritura de la constitución cambia un principio heredado de la organización.Deja los principios heredados como están y añade los tuyos.
precondition409, 410, 413-32602El estado del destino no permite la petición, ya no existe o el cuerpo es demasiado grande.Lee el mensaje y corrige el estado antes de reintentar.
rate_limited429-32029Demasiadas peticiones en poco tiempo.Espera los segundos de la cabecera Retry-After y reintenta.
billing409, 422-32602El proveedor de pagos no está configurado o rechazó un cambio de plan.Revisa los datos de facturación o contacta con soporte.
identity_provider_refused422-32602El proveedor de inicio de sesión rechazó un cambio.Revisa el detalle del mensaje y reintenta.
organization_creation410, 409, 503, 422-32602Falló la creación de una organización. El código es uno de los de más abajo.Sigue el mensaje y empieza de nuevo si la solicitud caducó.
unavailable503-32603Un servicio del que depende SDD Vault no está disponible temporalmente.Reintenta en un momento.
internal500-32603Algo falló por nuestra parte.Reintenta; si persiste, contacta con soporte.

Rechazos por política y por plan

CódigoCuándo
ip_not_allowedLa lista de IP permitidas de la organización no incluye tu red.
guests_disabledLa organización no admite invitados.
admin_only_project_creationSolo los owners y admins de la organización pueden crear proyectos.
plan_seat_limitEl plan no tiene más asientos para el rol que se añade.
plan_project_limitEl plan ha alcanzado su número de proyectos.
plan_featureLa función no está incluida en el plan.
plan_mcp_call_limitSe han agotado las llamadas MCP mensuales del plan; se reanudan el primer día del mes siguiente.

Códigos de creación de organización

CódigoCuándo
organization_request_expiredLa solicitud de creación caducó; empieza de nuevo.
organization_already_createdLa organización ya se creó con esta solicitud.
organization_creation_pausedLa creación de organizaciones está en pausa temporalmente.
bot_check_failedFalló la comprobación anti-bots; inténtalo de nuevo.