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

# API-Referenz

> Enterprise-API zum Abfragen von Windsurf-Nutzungsdaten und zum Verwalten von Konfigurationen mit Service-Key-Authentifizierung.

<div id="overview">
  ## Überblick
</div>

Die Windsurf-API ermöglicht Enterprise-Kunden den programmgesteuerten Zugriff auf detaillierte Nutzungs-Analytics sowie die Verwaltung von Nutzungskonfigurationen für ihre Teams.

<Note>Die API ist nur für Enterprise-Pläne verfügbar</Note>

<div id="base-url">
  ## Basis-URL
</div>

Alle API-Anfragen sollten an folgende Adresse gesendet werden:

```
https://server.codeium.com/api/v1/
```

<div id="authentication">
  ## Authentifizierung
</div>

Die Windsurf-API verwendet Service Keys zur Authentifizierung. Service Keys müssen im Request-Body aller API-Aufrufe enthalten sein.

<div id="creating-a-service-key">
  ### Einen Service-Schlüssel erstellen
</div>

1. Öffnen Sie Ihre [Team-Einstellungen](https://windsurf.com/team/settings)
2. Wechseln Sie zum Bereich „Service-Schlüssel“
3. Erstellen Sie einen neuen Service-Schlüssel mit geeigneten Berechtigungen
4. Kopieren Sie den generierten Service-Schlüssel zur Verwendung in API-Anfragen

<div id="required-permissions">
  ### Erforderliche Berechtigungen
</div>

Verschiedene API-Endpunkte erfordern unterschiedliche Berechtigungen. Weitere Informationen zu den jeweils benötigten Berechtigungen finden Sie in der Dokumentation der einzelnen Endpunkte:

| Endpunkt                                                                                                         | Erforderliche Berechtigung |
| ---------------------------------------------------------------------------------------------------------------- | -------------------------- |
| [Custom Analytics](/de/windsurf/accounts/api-reference/custom-analytics) (`/Analytics`)                          | Analytics Read             |
| [User Page Analytics](/de/windsurf/accounts/api-reference/user-page-analytics) (`/UserPageAnalytics`)            | Teams Nur-Lesen            |
| [Cascade Analytics](/de/windsurf/accounts/api-reference/cascade-analytics) (`/CascadeAnalytics`)                 | Teams Nur-Lesen            |
| [Set Usage Configuration](/de/windsurf/accounts/api-reference/usage-config) (`/UsageConfig`)                     | Billing Write              |
| [Get Usage Configuration](/de/windsurf/accounts/api-reference/get-usage-config) (`/GetUsageConfig`)              | Billing Read               |
| [Get Team Credit Balance](/de/windsurf/accounts/api-reference/get-team-credit-balance) (`/GetTeamCreditBalance`) | Billing Read               |

<div id="using-service-keys">
  ### Verwendung von Service-Schlüsseln
</div>

Fügen Sie Ihren Service Key in den Anfragetext (Request Body) aller API-Aufrufe ein:

```json theme={null}
{
  "service_key": "your_service_key_here",
  // ... weitere Parameter
}
```

<Warning>Bewahren Sie Ihre Service-Schlüssel sicher auf und veröffentlichen Sie sie niemals in clientseitigem Code oder öffentlichen Repositories</Warning>

<div id="rate-limits">
  ## Rate Limits
</div>

API-Anfragen unterliegen Rate Limits, um die Stabilität des Dienstes sicherzustellen. Wenn du ein Rate Limit überschreitest, erhältst du eine Antwort mit `429 Too Many Requests`.

<div id="support">
  ## Support
</div>

Bei Fragen und Support zum API wenden Sie sich bitte an den [Windsurf Support](https://windsurf.com/support).