Fehlercodes

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

Jeder AiHummer-API-Fehler trägt eine **stabiler Maschinencode** in der Form `AIH-<DOMAIN>-<NNNN>`. Die Drahtform ist: ```json { "error": { "code": "AIH-AUTH-0001", "message": "invalid login or password", "message_key": "err.auth.invalid_credentials", "details": { } } } ``` `code` ist stabil (wird nie wiederverwendet oder neu nummeriert); `message` ist eine menschliche englische Zeichenkette; `message_key` ist der i18n-Schlüssel, den Kunden zur Lokalisierung verwenden; `details` ist optional strukturierter Kontext. > Abrechnungs-/Planberechtigungsfehler (die 402 „Upgrade erforderlich“-Anzeige) sind **nicht** hier aufgeführt — siehe [Lizenzierung & Abrechnung](/de/v1.0/commercial/licensing). ## GEWÖHNLICH Schnittstellenübergreifende Fehler, die von jedem Dienst geteilt werden (Anforderungsform, Methode, Authentifizierung, interne Fehler). Ein domänenspezifischer Code wird bevorzugt, wenn einer passt. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-COMMON-0001` | 405 | Methode nicht erlaubt | `err.common.method_not_allowed` | Die HTTP-Methode ist für diese Route nicht erlaubt. | | `AIH-COMMON-0002` | 400 | Ungültiger Anforderungskörper | `err.common.invalid_body` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-COMMON-0003` | 400 | Ein erforderliches Feld fehlt | `err.common.missing_field` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-COMMON-0004` | 500 | Interner Fehler | `err.common.internal` | Ein unerwarteter interner Fehler. | | `AIH-COMMON-0005` | 404 | Nicht gefunden | `err.common.not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-COMMON-0006` | 403 | Verboten | `err.common.forbidden` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | | `AIH-COMMON-0007` | 501 | Funktion nicht aktiviert | `err.common.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-COMMON-0008` | 401 | Unbefugt | `err.common.unauthorized` | Fehlende oder ungültige Anmeldedaten. | | `AIH-COMMON-0009` | 400 | Validierung fehlgeschlagen | `err.common.validation` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-COMMON-0010` | 409 | Konflikt | `err.common.conflict` | Konflikte mit dem aktuellen Zustand. | | `AIH-COMMON-0011` | 429 | Ratenlimit überschritten | `err.common.rate_limited` | Zu viele Anfragen / über dem konfigurierten Budget. | | `AIH-COMMON-0012` | 502 | Fehler stromaufwärts | `err.common.upstream` | Ein Aufruf beim Upstream/Anbieter ist fehlgeschlagen. | ## AUTH Admin lokale Authentifizierung: Anmeldung, Sitzungen, Passwortänderung, Benutzerverwaltung, 2FA. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-AUTH-0001` | 401 | Ungültiger Login oder Passwort | `err.auth.invalid_credentials` | Fehlende oder ungültige Anmeldedaten. | | `AIH-AUTH-0002` | 429 | Zu viele Versuche, versuchen Sie es später erneut | `err.auth.too_many_attempts` | Zu viele Anfragen / über dem konfigurierten Budget. | | `AIH-AUTH-0003` | 401 | Nicht authentifiziert | `err.auth.not_authenticated` | Fehlende oder ungültige Anmeldedaten. | | `AIH-AUTH-0004` | 501 | Lokale Authentifizierung nicht aktiviert | `err.auth.local_disabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-AUTH-0005` | 403 | Aktuelles Passwort ist falsch | `err.auth.wrong_current_password` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | | `AIH-AUTH-0006` | 409 | Sie können Ihr eigenes Konto nicht löschen | `err.auth.cannot_delete_self` | Konflikte mit dem aktuellen Zustand. | | `AIH-AUTH-0007` | 500 | Konnte keine Sitzung erstellen | `err.auth.session_failed` | Ein unerwarteter interner Fehler. | | `AIH-AUTH-0008` | 501 | Zwei-Faktor-Authentifizierung nicht aktiviert | `err.auth.twofa_disabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-AUTH-0009` | 401 | Herausforderung abgelaufen — bitte erneut anmelden | `err.auth.twofa_challenge_expired` | Fehlende oder ungültige Anmeldedaten. | | `AIH-AUTH-0010` | 401 | Ungültiger Code | `err.auth.twofa_invalid_code` | Fehlende oder ungültige Anmeldedaten. | | `AIH-AUTH-0011` | 401 | Ungültiger Wiederherstellungscode | `err.auth.twofa_invalid_recovery` | Fehlende oder ungültige Anmeldedaten. | | `AIH-AUTH-0012` | 401 | Die Zwei-Faktor-Überprüfung ist fehlgeschlagen | `err.auth.twofa_verify_failed` | Fehlende oder ungültige Anmeldedaten. | | `AIH-AUTH-0013` | 400 | Kein passender zweiter Faktor registriert | `err.auth.twofa_not_enrolled` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-AUTH-0014` | 400 | Ungültiges oder abgelaufenes Zurücksetzungs-Token | `err.auth.reset_token_invalid` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | ## AGENT KI-Mitarbeiter (Agent) CRUD, Versionen, Klonen und das pro-Agent System-Prompt-Profil. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-AGENT-0001` | 501 | Agenten nicht aktiviert | `err.agent.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-AGENT-0002` | 404 | Agent nicht gefunden | `err.agent.not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-AGENT-0003` | 403 | Nicht dein Agent | `err.agent.forbidden` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | | `AIH-AGENT-0004` | 501 | Agentenprofile nicht aktiviert | `err.agent.profile_not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-AGENT-0005` | 404 | Gemeinsamer Abschnitt nicht gefunden | `err.agent.section_not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-AGENT-0006` | 403 | Nicht Ihr freigegebener Bereich | `err.agent.section_forbidden` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | | `AIH-AGENT-0007` | 400 | Unbekannter Abschnittstyp | `err.agent.unknown_section_kind` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-AGENT-0008` | 403 | Werkzeug für diesen Agenten nicht erlaubt | `err.agent.tool_not_permitted` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | | `AIH-AGENT-0009` | 403 | Subagent-Tiefenlimit erreicht | `err.agent.subagent_depth_exceeded` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | | `AIH-AGENT-0010` | 403 | Handoff hier nicht verfügbar | `err.agent.handoff_unavailable` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | | `AIH-AGENT-0011` | 500 | Aufruf des Werkzeugs fehlgeschlagen | `err.agent.tool_failed` | Ein unerwarteter interner Fehler. | | `AIH-AGENT-0012` | 400 | Die Übergabe erfordert 'Agent' und 'Aufgabe' | `err.agent.handoff_invalid_args` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-AGENT-0013` | 404 | Kein Agent mit diesem Namen | `err.agent.handoff_target_not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-AGENT-0014` | 400 | Keine Aufgaben bereitgestellt | `err.agent.subagent_no_tasks` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | ## API-SCHLÜSSEL API-Schlüssel für den programmgesteuerten Gateway-Zugriff: das Schlüsselsystem ist nicht konfiguriert. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-APIKEY-0001` | 501 | API-Schlüssel nicht konfiguriert | `err.apikey.not_configured` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## GENEHMIGUNG Mensch-in-der-Schleife Genehmigungswarteschlange: die Genehmigungsfunktion ist ausgeschaltet. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-APPROVAL-0001` | 501 | Genehmigungen nicht aktiviert | `err.approval.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## ARTEFAKT Konversationsartefakte (Dokumente + ausführbarer Code): Code-Ausführung aus, fehlendes Artefakt/Version, falscher Typ oder schlechtes Runner-Ergebnis. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-ARTIFACT-0001` | 501 | Codeausführung nicht aktiviert | `err.artifact.exec_disabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-ARTIFACT-0002` | 404 | Artefakt nicht gefunden | `err.artifact.not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-ARTIFACT-0003` | 404 | Artefaktversion nicht gefunden | `err.artifact.version_not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-ARTIFACT-0004` | 400 | Artefakt ist kein Code | `err.artifact.not_code` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-ARTIFACT-0005` | 500 | Schlechter Läuferausgabe | `err.artifact.bad_runner_output` | Ein unerwarteter interner Fehler. | | `AIH-ARTIFACT-0006` | 400 | Kind muss Dokument oder Code sein | `err.artifact.invalid_kind` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | ## SICHERUNG Datenbanksicherung von der Admin-Oberfläche. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-BACKUP-0001` | 501 | Datenbank-URL nicht für Backup konfiguriert | `err.backup.not_configured` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-BACKUP-0002` | 500 | Backup fehlgeschlagen | `err.backup.failed` | Ein unerwarteter interner Fehler. | ## Bündel Stapelanforderungsverarbeitung. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-BATCH-0001` | 501 | Stapel nicht aktiviert | `err.batch.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-BATCH-0002` | 404 | Charge nicht gefunden | `err.batch.not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | ## BUDGET Nutzungsmessung und Budgetierung des Modellverbrauchs. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-BUDGET-0001` | 501 | Verbrauchsmessung nicht aktiviert | `err.budget.usage_not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-BUDGET-0002` | 501 | Budgets nicht aktiviert | `err.budget.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## Bring Your Own Key Bring-your-own-key: vom Mieter bereitgestellte Modelle-Anbieter-Schlüssel. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-BYOK-0001` | 501 | BYOK nicht konfiguriert | `err.byok.not_configured` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## ÄNDERN Änderungsaufzeichnungen und der Änderungsfreigabe-Workflow. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-CHANGE-0001` | 404 | Änderung nicht gefunden | `err.change.not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-CHANGE-0002` | 403 | Selbstgenehmigung nicht erlaubt: ein anderer Genehmiger ist erforderlich | `err.change.self_approval_forbidden` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | ## CHAT OpenAI-kompatibler Chat-Completion-Endpunkt. Die Wire-Form bleibt OpenAI-kompatibel und fügt gleichzeitig einen stabilen Code hinzu. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-CHAT-0001` | 501 | OpenAI-kompatibler Endpunkt deaktiviert | `err.chat.disabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-CHAT-0002` | 401 | Ungültiger API-Schlüssel | `err.chat.invalid_key` | Fehlende oder ungültige Anmeldedaten. | | `AIH-CHAT-0003` | 400 | Ungültige Chat-Anfrage | `err.chat.invalid_request` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-CHAT-0004` | 429 | Rate- oder Budgetgrenze überschritten | `err.chat.rate_limited` | Zu viele Anfragen / über dem konfigurierten Budget. | | `AIH-CHAT-0005` | 502 | Chat-Versuch fehlgeschlagen | `err.chat.turn_failed` | Ein Aufruf beim Upstream/Anbieter ist fehlgeschlagen. | | `AIH-CHAT-0006` | 500 | Chat-Vervollständigung fehlgeschlagen | `err.chat.internal` | Ein unerwarteter interner Fehler. | ## VERBINDUNG Integration von OAuth-Verbindungen: Tickets, Autorisierungsschritte und Token-Austausch verbinden. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-CONNECTION-0001` | 400 | Ungültiges oder abgelaufenes Verbindungsticket | `err.connection.ticket_invalid` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-CONNECTION-0002` | 400 | Plugin gibt keinen OAuth-Flow an | `err.connection.no_oauth_flow` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-CONNECTION-0003` | 400 | OAuth-Client für dieses Plugin nicht konfiguriert | `err.connection.oauth_client_not_configured` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-CONNECTION-0004` | 400 | Autorisierung verweigert | `err.connection.auth_denied` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-CONNECTION-0005` | 400 | Fehlender Code oder Status | `err.connection.missing_code_or_state` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-CONNECTION-0006` | 400 | Ungültiger oder abgelaufener Zustand | `err.connection.state_invalid` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-CONNECTION-0007` | 400 | Plugin-OAuth-Konfiguration nicht verfügbar | `err.connection.oauth_config_unavailable` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-CONNECTION-0008` | 502 | Token-Austausch fehlgeschlagen | `err.connection.token_exchange_failed` | Ein Aufruf beim Upstream/Anbieter ist fehlgeschlagen. | | `AIH-CONNECTION-0009` | 500 | Konnte das Token nicht speichern | `err.connection.store_token_failed` | Ein unerwarteter interner Fehler. | ## Berechtigungsnachweis Operationen des Benutzeranmeldeinformationsspeichers pro Benutzer. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-CREDENTIAL-0001` | 501 | Anmeldeinformationen-Safe nicht aktiviert | `err.credential.vault_not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-CREDENTIAL-0002` | 400 | Anmeldeinformationen-Vorgang fehlgeschlagen | `err.credential.vault_error` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | ## GERÄT Die Gerätebrücke zur App auf dem Gerät. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-DEVICE-0001` | 503 | Gerätedienst nicht verfügbar | `err.device.service_unavailable` | Ein abhängiger Dienst ist vorübergehend nicht verfügbar. | ## EREIGNISSE Der Server-Ereignisstrom (SSE) für die Admin-Benutzeroberfläche und Clients. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-EVENTS-0001` | 500 | Streaming nicht unterstützt | `err.events.streaming_unsupported` | Ein unerwarteter interner Fehler. | ## TATSACHE Langzeitgedächtnis-Fakten über Benutzer. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-FACT-0001` | 404 | Fakt nicht gefunden | `err.fact.not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-FACT-0002` | 403 | Keine Benutzerinformation | `err.fact.not_user_fact` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | ## Graph Agentendiagramme: deklarative Multi-Agenten-Orchestrierung. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-GRAPH-0001` | 501 | Agent-Diagramme nicht aktiviert | `err.graph.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-GRAPH-0002` | 404 | Graph nicht gefunden | `err.graph.not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-GRAPH-0003` | 403 | Nicht dein Diagramm | `err.graph.forbidden` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | | `AIH-GRAPH-0004` | 501 | Graph-Ausführung in dieser Bereitstellung nicht verfügbar | `err.graph.exec_unavailable` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## Leitplanke Inhalts-/Verhaltensleitplankenregeln für Agenten. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-GUARDRAIL-0001` | 501 | Leitplanken nicht konfiguriert | `err.guardrail.not_configured` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## EINGEHEND Generische eingehende Webhook-/Ingest-Endpunkte: Kanal→Gateway-Nachrichtenaufnahme. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-INBOUND-0001` | 401 | Unbefugt | `err.inbound.unauthorized` | Fehlende oder ungültige Anmeldedaten. | | `AIH-INBOUND-0002` | 400 | Ungültige eingehende Nutzlast | `err.inbound.invalid_payload` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-INBOUND-0003` | 500 | Eingehende Sendung fehlgeschlagen | `err.inbound.dispatch_failed` | Ein unerwarteter interner Fehler. | ## IPALLOW IP-Zugriffslisten für Admin-Zugriff. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-IPALLOW-0001` | 501 | IP-Whitelist nicht konfiguriert | `err.ipallow.not_configured` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## KB Wissensdatenbank-Connectoren: RAG-Funktion deaktiviert, gespeicherte Connector-Konfiguration beschädigt oder ein schlecht hochgeladenes Archiv. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-KB-0001` | 501 | Wissensdatenbank nicht aktiviert | `err.kb.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-KB-0002` | 500 | Gespeicherte Konfiguration beschädigt | `err.kb.config_corrupt` | Ein unerwarteter interner Fehler. | | `AIH-KB-0003` | 400 | Ungültiges Wissensarchiv | `err.kb.invalid_archive` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | ## LIZENZ Instanzlizenzierung: Anwendung der unterzeichneten Lizenz. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-LICENSE-0001` | 501 | Lizenzierung nicht aktiviert | `err.license.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-LICENSE-0002` | 400 | Ungültige Lizenz | `err.license.invalid` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | ## LLM In-Produkt „Connect Codex (ChatGPT-Abonnement)“ Geräteautorisierungsfluss. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-LLM-0001` | 501 | Codex Connect ist nicht verfügbar: Der Geheimtresor (AIHUMMER_MASTER_KEY) ist nicht konfiguriert | `err.llm.codex_connect_disabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-LLM-0002` | 502 | Konnte den Codex-Geräteautorisierungsfluss nicht starten | `err.llm.codex_connect_start_failed` | Ein Aufruf beim Upstream/Anbieter ist fehlgeschlagen. | | `AIH-LLM-0003` | 500 | Die gespeicherte Codex-Verbindung konnte nicht gelöscht werden | `err.llm.codex_disconnect_failed` | Ein unerwarteter interner Fehler. | ## MARKTPLATZ Installationspfad des Plugin-Marktplatzes: Der Slug wird vor der asynchronen Bereitstellung gegen den Katalog validiert. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-MARKETPLACE-0001` | 404 | Unbekanntes Modul: nicht im Katalog | `err.marketplace.unknown_module` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | ## MEDIEN Media-Blob-Fetch-/Streaming-Endpunkte: Medienzugriff mit signiertem Token. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-MEDIA-0001` | 404 | Medium nicht gefunden | `err.media.not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-MEDIA-0002` | 403 | Ungültiges oder abgelaufenes Medientoken | `err.media.token_invalid` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | | `AIH-MEDIA-0003` | 503 | Videoverstehen nicht konfiguriert | `err.media.video_not_configured` | Ein abhängiger Dienst ist vorübergehend nicht verfügbar. | ## ERINNERUNG Langzeitgedächtnis (Einstein) Admin-Oberfläche: Das Speicher-Backend ist nicht angeschlossen. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-MEMORY-0001` | 501 | Speicher nicht konfiguriert | `err.memory.not_configured` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## MODELLZUGRIFF Regeln zum Modellzugang (welche Modelle für welche Benutzer/Agenten verfügbar sind). | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-MODELACCESS-0001` | 501 | Modellzugriff nicht konfiguriert | `err.modelaccess.not_configured` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## MODUL Plugin-/Modul-Marktplatz-Kontrolloberfläche: Funktion aus, fehlende Quelle/Installation, Eigentum oder ein fehlerhafter Side-Load-Upload. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-MODULE-0001` | 501 | Marktplatz nicht aktiviert | `err.module.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-MODULE-0002` | 404 | Quelle nicht gefunden | `err.module.source_not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-MODULE-0003` | 404 | Installation nicht gefunden | `err.module.installation_not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-MODULE-0004` | 403 | Nicht deine Installation | `err.module.installation_forbidden` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | | `AIH-MODULE-0005` | 501 | Plugin-Upload deaktiviert (kein Blob-Speicher) | `err.module.upload_disabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-MODULE-0006` | 400 | Ungültiges Plugin-Upload-Bundle | `err.module.invalid_bundle` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | ## KOPPELN Geräte-Paarung (QR-Einlösung), Geräte-Sitzungsvalidierung, Bindungsstatus. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-PAIRING-0001` | 400 | Koppelcode erforderlich | `err.pairing.code_required` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-PAIRING-0002` | 401 | Ungültiger oder abgelaufener Kopplungscode | `err.pairing.invalid_code` | Fehlende oder ungültige Anmeldedaten. | | `AIH-PAIRING-0003` | 401 | Schlechtes eingehendes Geheimnis | `err.pairing.bad_inbound_secret` | Fehlende oder ungültige Anmeldedaten. | | `AIH-PAIRING-0004` | 400 | Ein erforderliches Feld fehlt | `err.pairing.field_required` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | | `AIH-PAIRING-0005` | 401 | Ungültige oder abgelaufene Sitzung | `err.pairing.session_invalid` | Fehlende oder ungültige Anmeldedaten. | | `AIH-PAIRING-0006` | 400 | Token erforderlich | `err.pairing.token_required` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | ## SPIELPLATZ Der Prompt/Modell-Spielplatz. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-PLAYGROUND-0001` | 501 | Spielplatz nicht aktiviert | `err.playground.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## EINGABE Die Prompt-/Vorlagenbibliothek. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-PROMPT-0001` | 501 | Prompt-Bibliothek nicht konfiguriert | `err.prompt.not_configured` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-PROMPT-0002` | 404 | Vorlage nicht gefunden | `err.prompt.template_not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | ## DRÜCKEN Mobile Push-Benachrichtigungen über das Vendor-Push-Relay (die Instanz enthält keine Vendor-Anmeldedaten). | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-PUSH-0001` | 503 | Push-Relais nicht verfügbar (Push-Dienst des Anbieters nicht verfügbar / Instanz nicht registriert) | `err.push.relay_unavailable` | Ein abhängiger Dienst ist vorübergehend nicht verfügbar. | | `AIH-PUSH-0002` | 502 | Push-Relay-Zustellung fehlgeschlagen | `err.push.relay_failed` | Ein Aufruf beim Upstream/Anbieter ist fehlgeschlagen. | ## REGEN Antwortregeneration (regenerieren). | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-REGEN-0001` | 501 | Neuerstellen nicht aktiviert | `err.regen.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## SAML SAML Single Sign-on. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-SAML-0001` | 501 | SAML nicht verfügbar | `err.saml.not_available` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-SAML-0002` | 400 | Assertion fehlt Subjekt | `err.saml.assertion_invalid` | Fehlerhafte, unvollständige oder ungültige Anforderungseingabe. | ## PLAN Geplante/verzögerte Nachrichtenversendungen. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-SCHEDULE-0001` | 404 | Zeitplan nicht gefunden | `err.schedule.not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | ## SCIM SCIM-Benutzerbereitstellung. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-SCIM-0001` | 501 | SCIM nicht aktiviert | `err.scim.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## GEHEIM Geheimtresor pro Mandant: Der Hauptschlüssel fehlt oder das benannte Geheimnis existiert nicht. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-SECRET-0001` | 501 | Geheimnisse nicht konfiguriert | `err.secret.not_configured` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-SECRET-0002` | 404 | Geheimnis nicht gefunden | `err.secret.not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | ## GEFÜHL Gesprächsanalytik: Stimmung und Qualität. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-SENTIMENT-0001` | 501 | Gesprächsanalyse nicht aktiviert | `err.sentiment.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-SENTIMENT-0002` | 404 | Noch nicht analysiert | `err.sentiment.not_analyzed` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-SENTIMENT-0003` | 422 | Konnte die Unterhaltung nicht analysieren | `err.sentiment.unprocessable` | Die Anfrage ist gültig, aber der Inhalt konnte nicht verarbeitet werden. | ## SITZUNG Unterhaltungs-/Sitzungs- + Nachrichtenverwaltungsoberfläche: Funktion ausgeschaltet, oder die Unterhaltung/Nachricht gehört nicht dem Anrufer. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-SESSION-0001` | 501 | Unterhaltungen nicht aktiviert | `err.session.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-SESSION-0002` | 403 | Nicht dein Gespräch | `err.session.conversation_forbidden` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | | `AIH-SESSION-0003` | 403 | Nicht deine Nachricht | `err.session.message_forbidden` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | ## Fähigkeit Agentenfähigkeiten: Bibliothek und Eigentum. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-SKILL-0001` | 501 | Fähigkeiten nicht aktiviert | `err.skill.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-SKILL-0002` | 404 | Fähigkeit nicht gefunden | `err.skill.not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-SKILL-0003` | 403 | Nicht deine Fähigkeit | `err.skill.forbidden` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | ## FÄHIGKEIT Der Fähigkeitsoptimierer: Vorschläge zur Fähigkeitsverbesserung. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-SKILLOPT-0001` | 501 | Fähigkeiten-Optimierer nicht aktiviert | `err.skillopt.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-SKILLOPT-0002` | 404 | Vorschlag nicht gefunden | `err.skillopt.proposal_not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | | `AIH-SKILLOPT-0003` | 403 | Nicht dein Vorschlag | `err.skillopt.proposal_forbidden` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | ## SYSTEM Host-System-Operationen: Protokolle und Selbstaktualisierung. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-SYSTEM-0001` | 501 | Protokolle auf diesem Host nicht verfügbar | `err.system.logs_unavailable` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-SYSTEM-0002` | 501 | Selbstaktualisierung nicht konfiguriert; ausführen `sudo aihummer update` auf dem Gastgeber | `err.system.update_not_configured` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | ## BENUTZER Verwaltung von Arbeitsbereichsbenutzern und -rollen. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-USER-0001` | 409 | Du kannst deine eigenen Rollen nicht ändern | `err.user.cannot_change_own_roles` | Konflikte mit dem aktuellen Zustand. | | `AIH-USER-0002` | 409 | Kann den letzten Besitzer nicht entfernen | `err.user.cannot_remove_last_owner` | Konflikte mit dem aktuellen Zustand. | ## STIMME Sprachumschalt-Endpunkt (/v1/voice/turn): die SIP-Brücke → Gateway-Audio-Umschaltoberfläche. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-VOICE-0001` | 502 | Konnte die Unterhaltung nicht auflösen | `err.voice.resolve_failed` | Ein Aufruf beim Upstream/Anbieter ist fehlgeschlagen. | | `AIH-VOICE-0002` | 502 | Sprachumschaltung fehlgeschlagen | `err.voice.turn_failed` | Ein Aufruf beim Upstream/Anbieter ist fehlgeschlagen. | ## WEBCONN Backend für Admin Sessions: Browsersitzung und SSE-Chat. Fehlerereignisse im SSE-Stream gehören nicht zu diesem Fehlerformat. | Code | HTTP | Bedeutung | i18n-Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-WEBCONN-0001` | 403 | Die Unterhaltung gehört nicht zu Ihrer Sitzung | `err.webconn.forbidden` | Die Ressource gehört zu einem anderen Mandanten, Eigentümer oder einer anderen Sitzung. | | `AIH-WEBCONN-0002` | 500 | Streaming wird nicht unterstützt | `err.webconn.streaming_unsupported` | Ein unerwarteter Fehler ist aufgetreten. | ## WEBHOOK Ausgehende Webhooks für Instanzereignisse. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-WEBHOOK-0001` | 501 | Webhooks nicht aktiviert | `err.webhook.not_enabled` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-WEBHOOK-0002` | 404 | Webhook nicht gefunden | `err.webhook.not_found` | Das referenzierte Objekt existiert nicht oder ist nicht im Gültigkeitsbereich. | ## ARBEITSBEREICH Arbeitsbereichseigentum/-umfang: Der handelnde Mieter hat auf einem Arbeitsbereich gehandelt, den er nicht besitzt. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-WORKSPACE-0001` | 403 | Nicht dein Arbeitsbereich | `err.workspace.forbidden` | Die Ressource gehört einem anderen Mandanten/Eigentümer/Sitzung. | ## ZAPIER Der eingehende Trigger des Zapier-Connectors. | Code | HTTP | Bedeutung | i18n Schlüssel | Typische Ursache | | --- | --- | --- | --- | --- | | `AIH-ZAPIER-0001` | 501 | Eingehender Auslöser nicht konfiguriert | `err.zapier.not_configured` | Die Funktion/Integration ist ausgeschaltet oder nicht konfiguriert. | | `AIH-ZAPIER-0002` | 401 | Ungültige Auslöser-Signatur oder Token | `err.zapier.invalid_signature` | Fehlende oder ungültige Anmeldedaten. |