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

# Fehler

> Häufige Fehlerantworten der Public API und wie du sie debuggst.

Fehlerantworten verwenden einen JSON-Body mit einem `error`-Code-String, auf den du in Clients verzweigen kannst.

```json theme={null}
{
  "error": "forbidden"
}
```

## Authentifizierung und Autorisierung

| Status | `error`               | Was du prüfen solltest                                                               |
| ------ | --------------------- | ------------------------------------------------------------------------------------ |
| 401    | `unauthorized`        | Ist der Header vorhanden? Nutzt du `x-api-key`?                                      |
| 401    | `invalidApiKey`       | Key korrekt kopiert? Nicht widerrufen oder abgelaufen?                               |
| 403    | `forbidden`           | Passen Key-Berechtigungen und Organisation zur Anfrage?                              |
| 403    | `featureNotAvailable` | Enthält der Tarif diese Funktion (zum Beispiel Rocket-League-Tags oder API-Zugriff)? |
| 429    | `rateLimited`         | Zu viele Requests mit diesem Key — kurz warten und erneut versuchen                  |

## Validierung und nicht gefunden

| Status | Häufige `error`-Werte                                                                                                                                                                                                                                 |
| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 400    | `invalidRequest`, `invalidStatus`, `alreadyConverted`, `playerCreateFailed`, `convertFailed`, `invalidPlayer`, `invalidTeam`, `invalidTeamRole`, `invalidFileType`, `fileTooLarge`, `unsupportedContentType`, `duplicateGame`, `invalidDiscordUserId` |
| 404    | `teamNotFound`, `playerNotFound`, `documentNotFound`, `notFound`                                                                                                                                                                                      |
| 409    | `discordUserIdTaken`, `alreadyApplied`                                                                                                                                                                                                                |
| 413    | `payloadTooLarge`                                                                                                                                                                                                                                     |
| 500    | `internalServerError`, `uploadUrlFailed`, `downloadUrlFailed`                                                                                                                                                                                         |

Die genauen Codes hängen vom Endpunkt ab. Die operationsspezifischen Antworten findest du in der API-Referenz.

## Debugging-Tipps

1. Prüfe, ob die Basis-URL `https://api.squadvault.xyz/v1` ist.
2. Prüfe, ob die Organisations-ID im Pfad, Query oder Body zur Organisation des Keys passt. Tryout-Get/Update/Convert verlangen immer `organizationId` (`?organizationId=` bei GET, JSON-Body bei PATCH/POST).
3. Prüfe, ob der Key die unter [Berechtigungen](/de/api/permissions) genannte Berechtigung hat.
4. Prüfe bei Uploads, ob `contentType` erlaubt ist und `fileKey` mit `documents/{organizationId}/` beginnt.