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

# Usage Export API Übersicht

> Nutze die Usage Export API, um Workspace-Nutzungsdaten als CSV oder JSON zu exportieren.

Mit der Usage Export API können Workspace-Administratoren Nutzungsdaten für Nutzer, Agenten, API-Schlüssel, Projekte, Modelle und Workflows exportieren. Nutze sie, wenn du Berichte automatisieren oder Daten in ein externes Analytics-System übertragen möchtest.

<Note>
  Du kannst diese Exporte auch direkt in der Langdock-Oberfläche erstellen. Mehr dazu findest du unter [Nutzungsexporte](/de/admin/compliance-and-governance/usage-exports).
</Note>

## Voraussetzungen

Um die Usage Export API zu nutzen, benötigst du:

* **Workspace-Admin-Berechtigung**: Nur Workspace-Administratoren können API-Schlüssel mit Nutzungsexport-Berechtigung erstellen.
* **API-Schlüssel mit `USAGE_EXPORT_API` Scope**: Spezielle Berechtigung für den Zugriff auf Nutzungsexporte.

<Warning>
  **Wichtiger Sicherheitshinweis**: Nutzer mit Zugriff auf einen API-Schlüssel mit `USAGE_EXPORT_API` Scope können Workspace-Nutzungsdaten für alle Bereiche exportieren, auch wenn sie diese Daten normalerweise nicht in der Oberfläche sehen können. Gewähre diese Berechtigung nur vertrauenswürdigen Personen.
</Warning>

## Programmatischer Export

### Verfügbare Endpunkte

```
POST /export/users
POST /export/agents
POST /export/api-keys
POST /export/projects
POST /export/models
POST /export/workflows
```

<Info>
  Der veraltete dataType `assistants` liefert dieselben Daten wie `agents`. `POST /export/assistants` bleibt als Alias verfügbar.
</Info>

Jeder Endpunkt unterstützt außerdem explizite Ausgabeformate:

```
POST /export/{dataType}/csv
POST /export/{dataType}/json
```

### Authentifizierung

Alle Anfragen benötigen Bearer-Token-Authentifizierung:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

### Anfrageformat

Die API nutzt die Uhrzeit aus dem `date`-Wert und interpretiert sie in der angegebenen `timezone`. Wenn du ein `Z` am Ende des `date`-Werts angibst, entfernt Langdock dieses automatisch, damit die Zeitzone nicht doppelt angewendet wird.

```json theme={null}
{
  "from": {
    "date": "2024-01-01T00:00:00.000",
    "timezone": "Europe/Berlin"
  },
  "to": {
    "date": "2024-01-31T23:59:59.999",
    "timezone": "UTC"
  },
  "group_by": "model"
}
```

`group_by` ist optional. Unterstützte Werte hängen vom Exporttyp ab:

| Export | Unterstützte `group_by`-Werte |
| - | - |
| Nutzer | `model` |
| Agenten / Assistants | `model` |
| API-Schlüssel | `model` |
| Modelle | `source`; `deployment` nur für BYOK-Workspaces |
| Projekte | Nicht unterstützt |
| Workflows | Nicht unterstützt |

### Antwortformat

#### CSV-Antwort

CSV-Endpunkte geben einen Dateipfad und eine Download-URL zurück:

```json theme={null}
{
  "success": true,
  "data": {
    "filePath": "agents-usage/workspace-id/agents-usage-2024-01-01-2024-01-31-abc12345.csv",
    "downloadUrl": "https://storage.example.com/signed-url",
    "dataType": "agents",
    "recordCount": 1250,
    "dateRange": {
      "from": "2024-01-01T00:00:00.000+01:00",
      "to": "2024-01-31T23:59:59.999"
    }
  }
}
```

#### JSON-Antwort

JSON-Endpunkte geben die Zeilen direkt zurück:

```json theme={null}
{
  "success": true,
  "data": [
    {
      "period_start": "2024-01-01",
      "period_end": "2024-01-31",
      "org_id": "workspace-id"
    }
  ],
  "metadata": {
    "dataType": "users",
    "recordCount": 1,
    "dateRange": {
      "from": "2024-01-01T00:00:00.000Z",
      "to": "2024-01-31T23:59:59.999Z"
    }
  }
}
```

#### Fehlerantwort

```json theme={null}
{
  "message": "No usage data found for the selected period",
  "code": "NOT_FOUND"
}
```

### Beispielanfrage

```bash theme={null}
curl -X POST "https://api.langdock.com/export/users" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {
      "date": "2024-01-01T00:00:00.000",
      "timezone": "UTC"
    },
    "to": {
      "date": "2024-01-31T23:59:59.999",
      "timezone": "UTC"
    }
  }'
```

## Export-Limits

Jede Anfrage an die Usage Export API kann bis zu 1.000.000 Nutzungszeilen verarbeiten. Dieses Limit gilt für die Standard-, CSV- und JSON-Endpunkte.

Anfragen über diesem Limit geben `400 Bad Request` mit dem Code `USAGE_EXPORT_TOO_LARGE` zurück. Die Fehlermeldung nennt das Zeilenlimit, und `details` enthält es als `limit`. Wähle einen kürzeren Zeitraum und füge die Ergebnisse anschließend zusammen.

## Rate Limits

Die Usage Export API unterliegt einem Limit für Anfragen, das je Workspace und API-Key begrenzt wird. Das Token-Limit der Completion-Endpunkte gilt hier nicht.

* **Anfragen pro Minute**: 500 Anfragen/Min

## Details zu Endpunkten

* [Nutzer-Nutzung exportieren](/de/developer/usage-export-api/export-users)
* [Agenten-Nutzung exportieren](/de/developer/usage-export-api/export-agents)
* [API-Schlüssel-Nutzung exportieren](/de/developer/usage-export-api/export-api-keys)
* [Projekt-Nutzung exportieren](/de/developer/usage-export-api/export-projects)
* [Modell-Nutzung exportieren](/de/developer/usage-export-api/export-models)
* [Workflow-Nutzung exportieren](/de/developer/usage-export-api/export-workflows)

## Sicherheit und Datenschutz

Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen. Verwende API-Schlüssel serverseitig und speichere sie sicher. Mehr dazu findest du unter [Best Practices für API-Schlüssel](/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.