> ## 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">
  ## Übersicht
</div>

Die Windsurf API ermöglicht Enterprise-Kunden den programmgesteuerten Zugriff auf detaillierte Nutzungs-Analytics und 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 Folgendes gesendet werden:

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

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

Die Windsurf API verwendet Service Keys (Service-Schlüssel) für die Authentifizierung. Service Keys müssen im Request-Body jeder API-Anfrage enthalten sein.

<div id="creating-a-service-key">
  ### Erstellen eines Service-Schlüssels
</div>

1. Öffnen Sie Ihre [Team-Einstellungen](https://windsurf.com/team/settings)
2. Wechseln Sie zum Abschnitt „Service-Schlüssel“
3. Erstellen Sie einen neuen Service-Schlüssel mit passenden 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. Siehe die Dokumentation der einzelnen Endpunkte für die jeweils erforderliche Berechtigung:

| Endpunkt                                                                                                        | Erforderliche Berechtigung |
| --------------------------------------------------------------------------------------------------------------- | -------------------------- |
| [Custom Analytics](/de/plugins/accounts/api-reference/custom-analytics) (`/Analytics`)                          | Analytics Read             |
| [User Page Analytics](/de/plugins/accounts/api-reference/user-page-analytics) (`/UserPageAnalytics`)            | Teams Nur-Lesen            |
| [Cascade Analytics](/de/plugins/accounts/api-reference/cascade-analytics) (`/CascadeAnalytics`)                 | Teams Nur-Lesen            |
| [Set Usage Configuration](/de/plugins/accounts/api-reference/usage-config) (`/UsageConfig`)                     | Billing Write              |
| [Get Usage Configuration](/de/plugins/accounts/api-reference/get-usage-config) (`/GetUsageConfig`)              | Billing Read               |
| [Get Team Credit Balance](/de/plugins/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 Rumpf jeder API-Anfrage ein:

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

<Warning>Bewahren Sie Ihre Service Keys sicher auf und geben Sie sie niemals in clientseitigem Code oder in öffentlichen Repositories preis</Warning>

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

API-Anfragen unterliegen einem Rate Limit, um die Stabilität des Dienstes sicherzustellen. Wenn Sie das Rate Limit überschreiten, erhalten Sie eine Antwort mit dem Statuscode `429 Too Many Requests`.

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

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