> ## 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.
# Nutzer-Nutzung exportieren
> API-Endpunkt zum Exportieren von Nutzeraktivität, Nachrichten und Nutzungsmetriken.
Dieser Endpunkt exportiert Nutzeraktivitätsdaten. Welche identifizierenden Daten enthalten sind, hängt von den Datenschutzeinstellungen deines Workspaces ab.
**Dedicated Deployment?**
Ersetze `api.langdock.com` durch `/api/public` in allen Anfragen.
Details zu Voraussetzungen und Rate Limits findest du in der [Hauptdokumentation zur Usage Export API](/de/developer/usage-export-api/intro-to-usage-export-api).
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).
## Datenschutzhinweis
Wenn Daten auf Nutzerebene im Workspace deaktiviert sind, werden identifizierende Spalten wie Name und E-Mail aus dem Export ausgeschlossen.
## Enthaltene Daten
Standardmäßig gibt der Nutzer-Export eine Zeile pro Nutzer zurück.
| Spalte | Beschreibung |
| ------------------------------ | --------------------------------------------------- |
| `period_start` | Startdatum des Berichts |
| `period_end` | Enddatum des Berichts |
| `org_id` | ID des Workspaces |
| `user_id` | ID des Nutzers |
| `name` | Name des Nutzers |
| `email` | E-Mail des Nutzers |
| `role` | Rolle des Nutzers |
| `joined_at` | Datum des Workspace-Beitritts |
| `department` | Abteilung |
| `company_name` | Firmenname |
| `license_type` | Aktuelle Lizenzstufe |
| `payg_limit_current` | Aktuelles Extra-Usage-Limit |
| `payg_consumption_in_period` | Extra-Usage-Verbrauch im Zeitraum |
| `payg_utilization_pct_current` | `payg_consumption_in_period / payg_limit_current` |
| `messages_total` | Gesamtzahl der Nachrichten |
| `messages_total_rank` | Rang nach Gesamtnachrichten |
| `messages_chat` | Nachrichten in normalen Chats |
| `messages_chat_rank` | Rang nach Chat-Nachrichten |
| `messages_assistants` | Nachrichten an Agenten |
| `messages_assistants_rank` | Rang nach Agenten-Nachrichten |
| `assistants_messaged` | Anzahl unterschiedlicher Agenten |
| `assistants_to_messages` | JSON-Zuordnung von Agent-ID zu Nachrichtenanzahl |
| `messages_projects` | Nachrichten in Projekten |
| `messages_projects_rank` | Rang nach Projekt-Nachrichten |
| `projects_messaged` | Anzahl unterschiedlicher Projekte |
| `projects_to_messages` | JSON-Zuordnung von Projekt-ID zu Nachrichtenanzahl |
| `model_to_messages_total` | JSON-Zuordnung von Modellname zu Nachrichtenanzahl |
| `action_messages` | Durch Aktionen erzeugte Nachrichten |
| `action_messaged` | Anzahl unterschiedlicher ausgelöster Aktionen |
| `action_to_messages` | JSON-Zuordnung von Aktionsname zu Nachrichtenanzahl |
### Zusätzliche Spalten für BYOK-Workspaces
| Spalte | Beschreibung |
| ----------------------- | ------------------------------------------- |
| `total_input_tokens` | Gesamte Input-Tokens |
| `total_output_tokens` | Gesamte Output-Tokens |
| `cached_prompt_tokens` | Cache-Read-Input-Tokens |
| `cache_creation_tokens` | Cache-Write-Input-Tokens |
| `no_cache_tokens` | Input-Tokens, die nicht aus dem Cache kamen |
| `total_cost_usd` | Geschätzte Provider-Kosten in USD |
## Gruppierter Export
Mit `group_by=model` erhältst du eine Zeile pro Nutzer und Modell.
## OpenAPI
````yaml POST /export/users
openapi: 3.0.0
info:
title: Langdock API
version: 3.0.0
servers:
- url: https://api.langdock.com
description: Production
security:
- bearerAuth: []
paths:
/export/users:
post:
tags:
- Usage Export
summary: Export user usage data
description: >-
Export detailed usage data for all users in the workspace (subject to
privacy settings)
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UsageExportModelGroupByRequest'
responses:
'200':
description: Export successful
content:
application/json:
schema:
$ref: '#/components/schemas/UsageExportResponse'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/UsageExportError'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/UsageExportError'
'404':
description: No data found
content:
application/json:
schema:
$ref: '#/components/schemas/UsageExportError'
components:
schemas:
UsageExportModelGroupByRequest:
allOf:
- $ref: '#/components/schemas/UsageExportRequest'
- type: object
properties:
group_by:
type: string
description: Optional aggregation dimension.
enum:
- model
UsageExportResponse:
type: object
description: Successful response from usage export endpoints
properties:
success:
type: boolean
description: Indicates if the export was successful
example: true
data:
type: object
description: Export data information
properties:
filePath:
type: string
description: Path to the generated export file
example: >-
agents-usage/workspace-id/agents-usage-2024-01-01-2024-01-31-abc12345.csv
downloadUrl:
type: string
format: uri
description: Signed URL to download the export file
example: https://storage.example.com/signed-url
dataType:
type: string
description: Type of data exported
enum:
- assistants
- agents
- api_keys
- users
- projects
- models
example: assistants
recordCount:
type: integer
description: Number of records in the export
example: 1250
dateRange:
type: object
description: Actual date range of the exported data
properties:
from:
type: string
format: date-time
description: Start date of the export
example: '2024-01-01T00:00:00.000Z'
to:
type: string
format: date-time
description: End date of the export
example: '2024-01-31T23:59:59.999Z'
required:
- from
- to
required:
- filePath
- downloadUrl
- dataType
- recordCount
- dateRange
required:
- success
- data
UsageExportError:
type: object
description: Error response from usage export endpoints
properties:
error:
type: string
description: Error type
example: No data found
message:
type: string
description: Detailed error message
example: No usage data found for the selected period
required:
- error
- message
UsageExportRequest:
type: object
description: Request body for usage export endpoints
properties:
from:
type: object
description: Start date and timezone for the export
properties:
date:
type: string
format: date-time
description: Start date in ISO 8601 format
example: '2024-01-01T00:00:00.000Z'
timezone:
type: string
description: Timezone for the date range
example: UTC
required:
- date
- timezone
to:
type: object
description: End date and timezone for the export
properties:
date:
type: string
format: date-time
description: End date in ISO 8601 format
example: '2024-01-31T23:59:59.999Z'
timezone:
type: string
description: Timezone for the date range
example: UTC
required:
- date
- timezone
required:
- from
- to
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: API Key
description: API key as Bearer token. Format "Bearer YOUR_API_KEY"
````