> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localmind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTP-Fehlercodes verstehen: 422, 403, 404

> Was die häufigsten API-Fehlercodes bedeuten und wie Sie sie beheben — inklusive des stillen 404 bei falschem Key-Scope.

Die Localmind-API meldet Probleme mit Ihrer Anfrage über drei typische Statuscodes. Diese Seite ordnet jeden Code seinem Symptom zu und zeigt den schnellsten Weg zur Lösung. Das vollständige Fehlermodell der API finden Sie unter [Konventionen und Fehler](/api-reference/Konventionen-und-Fehler).

## 422 — Ungültige Anfrage (Validierung)

Ein Pflichtfeld fehlt oder hat ein falsches Format (z. B. eine fehlende `space_id` im Request-Body, auch beim Verschachteln von Ordnern). Die API antwortet fail-closed mit `422` und einem `detail`-Feld, das das fehlende Feld nennt — nie mit einem `500`, es werden keine Daten preisgegeben.

```json Beispiel-Response (422) theme={null}
{
  "detail": [
    {
      "loc": ["body", "space_id"],
      "msg": "Field required",
      "type": "missing"
    }
  ]
}
```

Das Feld `loc` zeigt den Pfad zum Problem, `type` den maschinenlesbaren Fehlertyp: Hier fehlt `space_id` im Request-Body.

**Lösung:** Senden Sie alle Pflichtfelder gemäß der Endpoint-Referenz vollständig und im richtigen Format.

## 403 — Keine Berechtigung

Ihre Rolle erlaubt die Aktion nicht (z. B. eine Betrachter-/Viewer-Rolle versucht zu schreiben), die Ressource liegt außerhalb Ihrer Organisation, oder der `Authorization`-Header fehlt bei einem geschützten Download.

**Lösung:** Prüfen Sie Ihre Rolle und den Scope Ihres API-Keys, und stellen Sie sicher, dass der `Authorization`-Header bei jeder Anfrage gesetzt ist. Wie Rollen die erlaubten Aktionen eines API-Keys eingrenzen, erklärt [Authentifizierung und Rollen](/api-reference/Authentifizierung-und-Rollen).

## 404 — Nicht gefunden (auch: falscher Key-Scope)

Die ID existiert nicht — **oder** Ihr API-Key hat keinen Zugriff auf die Ressource. Aus Sicherheitsgründen liefert die API dann bewusst `404` statt `403` („stilles 404"): Ein Agent oder Dokument außerhalb des Key-Scopes erscheint schlicht als nicht vorhanden.

<Info>
  Dieses Verhalten ist beabsichtigt: Die API verrät nicht, ob eine Ressource existiert, auf die Ihr Schlüssel keinen Zugriff hat. Ein `404` bedeutet deshalb nicht zwingend, dass die ID falsch ist.
</Info>

Such-Endpunkte verhalten sich anders: Sie liefern bei fehlendem Zugriff `200` mit leerem Ergebnis.

**Lösung:** Prüfen Sie unter **Benutzereinstellungen → API-Schlüssel**, ob der Scope Ihres Schlüssels den betreffenden Space einschließt — entweder „alle Spaces" oder der passende Eintrag unter „ausgewählte Spaces". Details zum Anlegen und Verwalten Ihrer Schlüssel: [Persönliche API-Schlüssel](/navigation/Persönliche-API-Schlüssel).

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="API-Key funktioniert nicht" icon="key" href="/troubleshooting/API-Key-Funktioniert-Nicht">
    Schritt-für-Schritt-Diagnose, wenn Anfragen mit 401, 403 oder stillem 404 fehlschlagen.
  </Card>

  <Card title="Konventionen und Fehler" icon="braces" href="/api-reference/Konventionen-und-Fehler">
    Das vollständige Fehlermodell der Localmind-API: Statuscodes, Pagination, Filter-DSL.
  </Card>

  <Card title="Authentifizierung und Rollen" icon="shield-check" href="/api-reference/Authentifizierung-und-Rollen">
    Wie API-Keys, Scopes und Rollen-Narrowing zusammenspielen.
  </Card>
</CardGroup>