Códigos de error

{ "error": { "code": "AIH-AUTH-0001",
             "message": "invalid login or password",
             "message_key": "err.auth.invalid_credentials",
             "details": { } } }

Cada error de la API de AiHummer lleva un **código de máquina estable** en la forma `AIH-<DOMAIN>-<NNNN>`. La forma del alambre es: ```json { "error": { "code": "AIH-AUTH-0001", "message": "invalid login or password", "message_key": "err.auth.invalid_credentials", "details": { } } } ``` `code` es estable (nunca reutilizado ni renumerado); `message` es una cadena humana en inglés; `message_key` es la clave i18n que los clientes usan para localizar; `details` es un contexto estructurado opcional. > Los errores de facturación / derechos del plan (la superficie 402 "actualización requerida") son **no** enumerado aquí — ver [Licencias y facturación](/es/v1.0/commercial/licensing). ## COMÚN Errores transversales compartidos por todos los servicios (forma de la solicitud, método, autenticación, fallos internos). Se prefiere un código específico del dominio cuando se ajusta uno. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-COMMON-0001` | 405 | Método no permitido | `err.common.method_not_allowed` | El método HTTP no está permitido para esta ruta. | | `AIH-COMMON-0002` | 400 | Cuerpo de solicitud no válido | `err.common.invalid_body` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-COMMON-0003` | 400 | Falta un campo obligatorio | `err.common.missing_field` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-COMMON-0004` | 500 | Error interno | `err.common.internal` | Un fallo interno inesperado. | | `AIH-COMMON-0005` | 404 | No encontrado | `err.common.not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-COMMON-0006` | 403 | prohibida | `err.common.forbidden` | El recurso pertenece a otro inquilino/propietario/sesión. | | `AIH-COMMON-0007` | 501 | Función no habilitada | `err.common.not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-COMMON-0008` | 401 | No autorizado | `err.common.unauthorized` | Credenciales faltantes o inválidas. | | `AIH-COMMON-0009` | 400 | Validación fallida | `err.common.validation` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-COMMON-0010` | 409 | Conflicto | `err.common.conflict` | Conflictos con el estado actual. | | `AIH-COMMON-0011` | 429 | Límite de velocidad excedido | `err.common.rate_limited` | Demasiadas solicitudes / sobre el presupuesto configurado. | | `AIH-COMMON-0012` | 502 | Error ascendente | `err.common.upstream` | Una llamada al proveedor/ascendente falló. | ## AUT Admin autenticación local: inicio de sesión, sesiones, cambio de contraseña, gestión de usuarios, 2FA. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-AUTH-0001` | 401 | Inicio de sesión o contraseña no válidos | `err.auth.invalid_credentials` | Credenciales faltantes o inválidas. | | `AIH-AUTH-0002` | 429 | Demasiados intentos, inténtalo de nuevo más tarde | `err.auth.too_many_attempts` | Demasiadas solicitudes / sobre el presupuesto configurado. | | `AIH-AUTH-0003` | 401 | No autenticado | `err.auth.not_authenticated` | Credenciales faltantes o inválidas. | | `AIH-AUTH-0004` | 501 | Autenticación local no habilitada | `err.auth.local_disabled` | La función/integración está desactivada o no configurada. | | `AIH-AUTH-0005` | 403 | La contraseña actual es incorrecta | `err.auth.wrong_current_password` | El recurso pertenece a otro inquilino/propietario/sesión. | | `AIH-AUTH-0006` | 409 | No puedes eliminar tu propia cuenta | `err.auth.cannot_delete_self` | Conflictos con el estado actual. | | `AIH-AUTH-0007` | 500 | No se pudo crear la sesión | `err.auth.session_failed` | Un fallo interno inesperado. | | `AIH-AUTH-0008` | 501 | Autenticación de dos factores no habilitada | `err.auth.twofa_disabled` | La función/integración está desactivada o no configurada. | | `AIH-AUTH-0009` | 401 | El desafío ha expirado — inicia sesión de nuevo | `err.auth.twofa_challenge_expired` | Credenciales faltantes o inválidas. | | `AIH-AUTH-0010` | 401 | Código inválido | `err.auth.twofa_invalid_code` | Credenciales faltantes o inválidas. | | `AIH-AUTH-0011` | 401 | Código de recuperación no válido | `err.auth.twofa_invalid_recovery` | Credenciales faltantes o inválidas. | | `AIH-AUTH-0012` | 401 | La verificación de segundo factor falló | `err.auth.twofa_verify_failed` | Credenciales faltantes o inválidas. | | `AIH-AUTH-0013` | 400 | No hay un segundo factor registrado que coincida | `err.auth.twofa_not_enrolled` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-AUTH-0014` | 400 | Token de restablecimiento inválido o expirado | `err.auth.reset_token_invalid` | Entrada de solicitud malformada, incompleta o inválida. | ## AGENTE CRUD de empleado IA (agente), versiones, clon y el perfil de sistema por agente. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-AGENT-0001` | 501 | Agentes no habilitados | `err.agent.not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-AGENT-0002` | 404 | Agente no encontrado | `err.agent.not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-AGENT-0003` | 403 | No tu agente | `err.agent.forbidden` | El recurso pertenece a otro inquilino/propietario/sesión. | | `AIH-AGENT-0004` | 501 | Perfiles de agentes no habilitados | `err.agent.profile_not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-AGENT-0005` | 404 | Sección compartida no encontrada | `err.agent.section_not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-AGENT-0006` | 403 | No es tu sección compartida | `err.agent.section_forbidden` | El recurso pertenece a otro inquilino/propietario/sesión. | | `AIH-AGENT-0007` | 400 | Tipo de sección desconocido | `err.agent.unknown_section_kind` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-AGENT-0008` | 403 | Herramienta no permitida para este agente | `err.agent.tool_not_permitted` | El recurso pertenece a otro inquilino/propietario/sesión. | | `AIH-AGENT-0009` | 403 | Límite de profundidad del subagente alcanzado | `err.agent.subagent_depth_exceeded` | El recurso pertenece a otro inquilino/propietario/sesión. | | `AIH-AGENT-0010` | 403 | Transferencia no disponible aquí | `err.agent.handoff_unavailable` | El recurso pertenece a otro inquilino/propietario/sesión. | | `AIH-AGENT-0011` | 500 | Llamada a la herramienta fallida | `err.agent.tool_failed` | Un fallo interno inesperado. | | `AIH-AGENT-0012` | 400 | La transferencia requiere 'agente' y 'tarea' | `err.agent.handoff_invalid_args` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-AGENT-0013` | 404 | No hay ningún agente con ese nombre | `err.agent.handoff_target_not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-AGENT-0014` | 400 | No se proporcionaron tareas | `err.agent.subagent_no_tasks` | Entrada de solicitud malformada, incompleta o inválida. | ## CLAVEAPI Claves API para el acceso programático a la pasarela: el subsistema de claves no está configurado. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-APIKEY-0001` | 501 | Claves de API no configuradas | `err.apikey.not_configured` | La función/integración está desactivada o no configurada. | ## APROBACIÓN Cola de aprobación con intervención humana: la función de aprobación está desactivada. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-APPROVAL-0001` | 501 | Aprobaciones no habilitadas | `err.approval.not_enabled` | La función/integración está desactivada o no configurada. | ## ARTEFACTO Artefactos de conversación (documentos + código ejecutable): ejecución de código desactivada, artefacto/versión faltante, tipo incorrecto o salida del ejecutor incorrecta. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-ARTIFACT-0001` | 501 | Ejecución de código no habilitada | `err.artifact.exec_disabled` | La función/integración está desactivada o no configurada. | | `AIH-ARTIFACT-0002` | 404 | Artefacto no encontrado | `err.artifact.not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-ARTIFACT-0003` | 404 | Versión del artefacto no encontrada | `err.artifact.version_not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-ARTIFACT-0004` | 400 | El artefacto no es código | `err.artifact.not_code` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-ARTIFACT-0005` | 500 | Salida de corredor deficiente | `err.artifact.bad_runner_output` | Un fallo interno inesperado. | | `AIH-ARTIFACT-0006` | 400 | El tipo debe ser documento o código | `err.artifact.invalid_kind` | Entrada de solicitud malformada, incompleta o inválida. | ## COPIA DE SEGURIDAD Copia de seguridad de la base de datos desde la superficie de administración. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-BACKUP-0001` | 501 | URL de la base de datos no configurada para la copia de seguridad | `err.backup.not_configured` | La función/integración está desactivada o no configurada. | | `AIH-BACKUP-0002` | 500 | Copia de seguridad fallida | `err.backup.failed` | Un fallo interno inesperado. | ## LOTE Procesamiento de solicitudes por lote. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-BATCH-0001` | 501 | Lotes no habilitados | `err.batch.not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-BATCH-0002` | 404 | Lote no encontrado | `err.batch.not_found` | El objeto referenciado no existe o está fuera de alcance. | ## PRESUPUESTO Medición de uso y presupuestos de gasto por modelo. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-BUDGET-0001` | 501 | Medición de uso no habilitada | `err.budget.usage_not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-BUDGET-0002` | 501 | Presupuestos no habilitados | `err.budget.not_enabled` | La función/integración está desactivada o no configurada. | ## Trae tu propia clave Traiga su propia clave: claves del proveedor de modelos proporcionadas por el inquilino. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-BYOK-0001` | 501 | BYOK no configurado | `err.byok.not_configured` | La función/integración está desactivada o no configurada. | ## CAMBIAR Registros de cambios y el flujo de trabajo de aprobación de cambios. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-CHANGE-0001` | 404 | Cambio no encontrado | `err.change.not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-CHANGE-0002` | 403 | Aprobación propia no permitida: se requiere un aprobador diferente | `err.change.self_approval_forbidden` | El recurso pertenece a otro inquilino/propietario/sesión. | ## CHAT Punto de conexión de chat-completions compatible con OpenAI. La forma del cable se mantiene compatible con OpenAI mientras se agrega un código estable. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-CHAT-0001` | 501 | Punto de enlace compatible con OpenAI deshabilitado | `err.chat.disabled` | La función/integración está desactivada o no configurada. | | `AIH-CHAT-0002` | 401 | Clave de API no válida | `err.chat.invalid_key` | Credenciales faltantes o inválidas. | | `AIH-CHAT-0003` | 400 | Solicitud de chat no válida | `err.chat.invalid_request` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-CHAT-0004` | 429 | Límite de tarifa o presupuesto excedido | `err.chat.rate_limited` | Demasiadas solicitudes / sobre el presupuesto configurado. | | `AIH-CHAT-0005` | 502 | Fallo en el turno del chat | `err.chat.turn_failed` | Una llamada al proveedor/ascendente falló. | | `AIH-CHAT-0006` | 500 | La finalización del chat falló | `err.chat.internal` | Un fallo interno inesperado. | ## CONEXIÓN Integración de conexiones OAuth: conectar tickets, pasos de autorización e intercambio de tokens. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-CONNECTION-0001` | 400 | Boleto de conexión inválido o vencido | `err.connection.ticket_invalid` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-CONNECTION-0002` | 400 | El complemento no declara un flujo de OAuth | `err.connection.no_oauth_flow` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-CONNECTION-0003` | 400 | Cliente OAuth no configurado para este complemento | `err.connection.oauth_client_not_configured` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-CONNECTION-0004` | 400 | Autorización denegada | `err.connection.auth_denied` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-CONNECTION-0005` | 400 | Código o estado faltante | `err.connection.missing_code_or_state` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-CONNECTION-0006` | 400 | Estado inválido o expirado | `err.connection.state_invalid` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-CONNECTION-0007` | 400 | Configuración de OAuth del complemento no disponible | `err.connection.oauth_config_unavailable` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-CONNECTION-0008` | 502 | Intercambio de token fallido | `err.connection.token_exchange_failed` | Una llamada al proveedor/ascendente falló. | | `AIH-CONNECTION-0009` | 500 | No se pudo almacenar el token | `err.connection.store_token_failed` | Un fallo interno inesperado. | ## CREDENCIAL Operaciones del almacén de credenciales por usuario. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-CREDENTIAL-0001` | 501 | Bóveda de credenciales no habilitada | `err.credential.vault_not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-CREDENTIAL-0002` | 400 | La operación de credenciales falló | `err.credential.vault_error` | Entrada de solicitud malformada, incompleta o inválida. | ## DISPOSITIVO El dispositivo se conecta a la aplicación complementaria en el dispositivo. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-DEVICE-0001` | 503 | Servicio del dispositivo no disponible | `err.device.service_unavailable` | Un servicio dependiente no está disponible temporalmente. | ## EVENTOS El flujo de eventos del servidor (SSE) para la interfaz de administración y los clientes. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-EVENTS-0001` | 500 | Transmisión no compatible | `err.events.streaming_unsupported` | Un fallo interno inesperado. | ## HECHO Hechos de memoria a largo plazo sobre los usuarios. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-FACT-0001` | 404 | Hecho no encontrado | `err.fact.not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-FACT-0002` | 403 | No es un hecho del usuario | `err.fact.not_user_fact` | El recurso pertenece a otro inquilino/propietario/sesión. | ## gráfica Gráficos de agentes: orquestación declarativa de múltiples agentes. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-GRAPH-0001` | 501 | Gráficos de agente no habilitados | `err.graph.not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-GRAPH-0002` | 404 | Gráfico no encontrado | `err.graph.not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-GRAPH-0003` | 403 | No es tu gráfico | `err.graph.forbidden` | El recurso pertenece a otro inquilino/propietario/sesión. | | `AIH-GRAPH-0004` | 501 | Ejecución de gráficos no disponible en esta implementación | `err.graph.exec_unavailable` | La función/integración está desactivada o no configurada. | ## Barrera de seguridad Reglas de límites de contenido/conducta para agentes. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-GUARDRAIL-0001` | 501 | Barandillas no configuradas | `err.guardrail.not_configured` | La función/integración está desactivada o no configurada. | ## ENTRANTE Puntos finales genéricos de webhook/ingestión entrante: ingestión de mensajes de canal→puerta de enlace. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-INBOUND-0001` | 401 | No autorizado | `err.inbound.unauthorized` | Credenciales faltantes o inválidas. | | `AIH-INBOUND-0002` | 400 | Carga útil entrante no válida | `err.inbound.invalid_payload` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-INBOUND-0003` | 500 | El envío entrante falló | `err.inbound.dispatch_failed` | Un fallo interno inesperado. | ## IPALLOW Listas de IP permitidas con acceso de administrador. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-IPALLOW-0001` | 501 | Lista de permitidos de IP no configurada | `err.ipallow.not_configured` | La función/integración está desactivada o no configurada. | ## KB Conectores de base de conocimientos: función RAG desactivada, configuración del conector almacenada corrupta o un archivo subido incorrecto. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-KB-0001` | 501 | Base de conocimientos no habilitada | `err.kb.not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-KB-0002` | 500 | Configuración almacenada corrupta | `err.kb.config_corrupt` | Un fallo interno inesperado. | | `AIH-KB-0003` | 400 | Archivo de conocimientos no válido | `err.kb.invalid_archive` | Entrada de solicitud malformada, incompleta o inválida. | ## LICENCIA Licenciamiento de instancia: aplicando la licencia firmada. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-LICENSE-0001` | 501 | Licencia no habilitada | `err.license.not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-LICENSE-0002` | 400 | Licencia inválida | `err.license.invalid` | Entrada de solicitud malformada, incompleta o inválida. | ## LLM Flujo de autorización de dispositivo 'Connect Codex (suscripción a ChatGPT)' dentro del producto. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-LLM-0001` | 501 | Codex connect no está disponible: la bóveda de secretos (AIHUMMER_MASTER_KEY) no está configurada | `err.llm.codex_connect_disabled` | La función/integración está desactivada o no configurada. | | `AIH-LLM-0002` | 502 | No se pudo iniciar el flujo de autorización del dispositivo Codex | `err.llm.codex_connect_start_failed` | Una llamada al proveedor/ascendente falló. | | `AIH-LLM-0003` | 500 | No se pudo borrar la conexión de Codex almacenada | `err.llm.codex_disconnect_failed` | Un fallo interno inesperado. | ## MERCADO Ruta de instalación del mercado de complementos: el identificador se valida contra el catálogo antes del despliegue asincrónico. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-MARKETPLACE-0001` | 404 | Módulo desconocido: no está en el catálogo | `err.marketplace.unknown_module` | El objeto referenciado no existe o está fuera de alcance. | ## MEDIOS Puntos de acceso para obtener/transmitir blobs de medios: acceso a medios con token firmado. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-MEDIA-0001` | 404 | Medios no encontrados | `err.media.not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-MEDIA-0002` | 403 | Token de medios no válido o vencido | `err.media.token_invalid` | El recurso pertenece a otro inquilino/propietario/sesión. | | `AIH-MEDIA-0003` | 503 | Comprensión de video no configurada | `err.media.video_not_configured` | Un servicio dependiente no está disponible temporalmente. | ## MEMORIA Memoria a largo plazo (Einstein) superficie de administración: el backend de memoria no está conectado. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-MEMORY-0001` | 501 | Memoria no configurada | `err.memory.not_configured` | La función/integración está desactivada o no configurada. | ## ACCESOMODELO Reglas de acceso a modelos (qué modelos están disponibles para qué usuarios/agentes). | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-MODELACCESS-0001` | 501 | Acceso al modelo no configurado | `err.modelaccess.not_configured` | La función/integración está desactivada o no configurada. | ## MÓDULO Superficie de control del mercado de plugins/módulos: función desactivada, fuente/instalación faltante, propiedad, o una carga lateral malformada. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-MODULE-0001` | 501 | Mercado no habilitado | `err.module.not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-MODULE-0002` | 404 | Fuente no encontrada | `err.module.source_not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-MODULE-0003` | 404 | Instalación no encontrada | `err.module.installation_not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-MODULE-0004` | 403 | No es tu instalación | `err.module.installation_forbidden` | El recurso pertenece a otro inquilino/propietario/sesión. | | `AIH-MODULE-0005` | 501 | Carga de complemento deshabilitada (sin almacenamiento de blobs) | `err.module.upload_disabled` | La función/integración está desactivada o no configurada. | | `AIH-MODULE-0006` | 400 | Paquete de carga de complemento no válido | `err.module.invalid_bundle` | Entrada de solicitud malformada, incompleta o inválida. | ## EMPAREJAMIENTO Emparejamiento de dispositivo (rescate de QR), validación de sesión del dispositivo, estado de vinculación. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-PAIRING-0001` | 400 | Código de emparejamiento requerido | `err.pairing.code_required` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-PAIRING-0002` | 401 | Código de emparejamiento inválido o caducado | `err.pairing.invalid_code` | Credenciales faltantes o inválidas. | | `AIH-PAIRING-0003` | 401 | Secreto interno malo | `err.pairing.bad_inbound_secret` | Credenciales faltantes o inválidas. | | `AIH-PAIRING-0004` | 400 | Falta un campo obligatorio | `err.pairing.field_required` | Entrada de solicitud malformada, incompleta o inválida. | | `AIH-PAIRING-0005` | 401 | Sesión inválida o caducada | `err.pairing.session_invalid` | Credenciales faltantes o inválidas. | | `AIH-PAIRING-0006` | 400 | Token requerido | `err.pairing.token_required` | Entrada de solicitud malformada, incompleta o inválida. | ## PARQUE INFANTIL El espacio de prueba de indicaciones/modelo. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-PLAYGROUND-0001` | 501 | Patio de recreo no habilitado | `err.playground.not_enabled` | La función/integración está desactivada o no configurada. | ## INDICACIÓN La biblioteca de prompts/plantillas. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-PROMPT-0001` | 501 | Biblioteca de prompts no configurada | `err.prompt.not_configured` | La función/integración está desactivada o no configurada. | | `AIH-PROMPT-0002` | 404 | Plantilla no encontrada | `err.prompt.template_not_found` | El objeto referenciado no existe o está fuera de alcance. | ## EMPUJAR Notificaciones push móviles a través del relé de push del proveedor (la instancia no posee credenciales del proveedor). | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-PUSH-0001` | 503 | Relevo de notificación push no disponible (servicio de notificación push del proveedor no disponible / instancia no registrada) | `err.push.relay_unavailable` | Un servicio dependiente no está disponible temporalmente. | | `AIH-PUSH-0002` | 502 | Fallo en la entrega del relé de empuje | `err.push.relay_failed` | Una llamada al proveedor/ascendente falló. | ## REGEN Regeneración de respuesta (regenerar). | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-REGEN-0001` | 501 | Regenerar no habilitado | `err.regen.not_enabled` | La función/integración está desactivada o no configurada. | ## SAML Inicio de sesión único SAML. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-SAML-0001` | 501 | SAML no disponible | `err.saml.not_available` | La función/integración está desactivada o no configurada. | | `AIH-SAML-0002` | 400 | Aserción sin sujeto | `err.saml.assertion_invalid` | Entrada de solicitud malformada, incompleta o inválida. | ## HORARIO Envíos de mensajes programados/diferidos. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-SCHEDULE-0001` | 404 | Horario no encontrado | `err.schedule.not_found` | El objeto referenciado no existe o está fuera de alcance. | ## SCIM Aprovisionamiento de usuarios SCIM. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-SCIM-0001` | 501 | SCIM no habilitado | `err.scim.not_enabled` | La función/integración está desactivada o no configurada. | ## secreta Bóveda secreta por inquilino: la clave maestra está ausente, o el secreto nombrado no existe. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-SECRET-0001` | 501 | Secretos no configurados | `err.secret.not_configured` | La función/integración está desactivada o no configurada. | | `AIH-SECRET-0002` | 404 | Secreto no encontrado | `err.secret.not_found` | El objeto referenciado no existe o está fuera de alcance. | ## SENTIMIENTO Analítica de conversaciones: sentimiento y calidad. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-SENTIMENT-0001` | 501 | Análisis de conversación no habilitado | `err.sentiment.not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-SENTIMENT-0002` | 404 | Aún no analizado | `err.sentiment.not_analyzed` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-SENTIMENT-0003` | 422 | No se pudo analizar la conversación | `err.sentiment.unprocessable` | La solicitud es válida pero el contenido no pudo ser procesado. | ## SESION Superficie de administración de conversación/sesión + mensaje: función desactivada, o la conversación/mensaje no pertenece al llamante. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-SESSION-0001` | 501 | Conversaciones no habilitadas | `err.session.not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-SESSION-0002` | 403 | No es tu conversación | `err.session.conversation_forbidden` | El recurso pertenece a otro inquilino/propietario/sesión. | | `AIH-SESSION-0003` | 403 | No es tu mensaje | `err.session.message_forbidden` | El recurso pertenece a otro inquilino/propietario/sesión. | ## Habilidad Habilidades del agente: biblioteca y propiedad. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-SKILL-0001` | 501 | Habilidades no habilitadas | `err.skill.not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-SKILL-0002` | 404 | Habilidad no encontrada | `err.skill.not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-SKILL-0003` | 403 | No es tu habilidad | `err.skill.forbidden` | El recurso pertenece a otro inquilino/propietario/sesión. | ## HABILIDAD El optimizador de habilidades: propuestas de mejora de habilidades. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-SKILLOPT-0001` | 501 | Optimizador de habilidades no habilitado | `err.skillopt.not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-SKILLOPT-0002` | 404 | Propuesta no encontrada | `err.skillopt.proposal_not_found` | El objeto referenciado no existe o está fuera de alcance. | | `AIH-SKILLOPT-0003` | 403 | No es tu propuesta | `err.skillopt.proposal_forbidden` | El recurso pertenece a otro inquilino/propietario/sesión. | ## SISTEMA Operaciones del sistema anfitrión: registros y autoactualización. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-SYSTEM-0001` | 501 | Registros no disponibles en este host | `err.system.logs_unavailable` | La función/integración está desactivada o no configurada. | | `AIH-SYSTEM-0002` | 501 | Autoactualización no configurada; ejecute `sudo aihummer update` en el anfitrión | `err.system.update_not_configured` | La función/integración está desactivada o no configurada. | ## usuaria Gestión de usuarios y roles del espacio de trabajo. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-USER-0001` | 409 | No puedes cambiar tus propios roles | `err.user.cannot_change_own_roles` | Conflictos con el estado actual. | | `AIH-USER-0002` | 409 | No se puede eliminar al último propietario | `err.user.cannot_remove_last_owner` | Conflictos con el estado actual. | ## VOZ Punto final de giro de voz (/v1/voice/turn): la superficie de giro de audio del puente SIP → puerta de enlace. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-VOICE-0001` | 502 | No se pudo resolver la conversación | `err.voice.resolve_failed` | Una llamada al proveedor/ascendente falló. | | `AIH-VOICE-0002` | 502 | Cambio de voz fallido | `err.voice.turn_failed` | Una llamada al proveedor/ascendente falló. | ## WEBCONN Backend de Admin Sessions: sesión del navegador y chat mediante SSE. Los eventos de error del flujo SSE no forman parte de este formato de error. | Código | HTTP | Significado | Clave i18n | Causa habitual | | --- | --- | --- | --- | --- | | `AIH-WEBCONN-0001` | 403 | La conversación no pertenece a tu sesión | `err.webconn.forbidden` | El recurso pertenece a otro inquilino, propietario o sesión. | | `AIH-WEBCONN-0002` | 500 | La transmisión no es compatible | `err.webconn.streaming_unsupported` | Se produjo un fallo inesperado. | ## WEBHOOK Webhooks salientes para eventos de instancia. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-WEBHOOK-0001` | 501 | Webhooks no habilitados | `err.webhook.not_enabled` | La función/integración está desactivada o no configurada. | | `AIH-WEBHOOK-0002` | 404 | Webhook no encontrado | `err.webhook.not_found` | El objeto referenciado no existe o está fuera de alcance. | ## ESPACIO DE TRABAJO Propiedad/alcance del espacio de trabajo: el inquilino actuante actuó sobre un espacio de trabajo que no posee. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-WORKSPACE-0001` | 403 | No es tu espacio de trabajo | `err.workspace.forbidden` | El recurso pertenece a otro inquilino/propietario/sesión. | ## ZAPIER El disparador de entrada del conector de Zapier. | Código | HTTP | Significado | clave i18n | Causa típica | | --- | --- | --- | --- | --- | | `AIH-ZAPIER-0001` | 501 | Disparador de entrada no configurado | `err.zapier.not_configured` | La función/integración está desactivada o no configurada. | | `AIH-ZAPIER-0002` | 401 | Firma de activación o token no válidos | `err.zapier.invalid_signature` | Credenciales faltantes o inválidas. |