Zum Hauptinhalt springen
POST
/
export
/
users
Export user usage data
curl --request POST \
  --url https://api.langdock.com/export/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": {
    "date": "2024-01-01T00:00:00.000Z",
    "timezone": "UTC"
  },
  "to": {
    "date": "2024-01-31T23:59:59.999Z",
    "timezone": "UTC"
  }
}
'
{
  "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": "assistants",
    "recordCount": 1250,
    "dateRange": {
      "from": "2024-01-01T00:00:00.000Z",
      "to": "2024-01-31T23:59:59.999Z"
    }
  }
}
Dieser Endpunkt exportiert Nutzeraktivitätsdaten einschließlich Nachrichtenzahlen, Nutzungsmuster und Feature-Nutzung. Die verfügbaren Daten hängen von deinen Workspace-Datenschutzeinstellungen ab.

Datenschutzerwägungen

Die Nutzer-Exportdaten unterliegen den Datenschutzeinstellungen des Workspaces. Nutzeridentifizierende Daten können aufgrund der Datenschutzeinstellungen ausgeschlossen werden. Infolgedessen können einige Daten je nach Workspace-Konfiguration anonymisiert sein.

Enthaltene Daten

Der Nutzer-Export kann enthalten:
  • Nachrichtenzahl pro Nutzer
  • Aktivitätsmuster
  • Nutzungshäufigkeit
  • Feature-Nutzung
  • Zeitbasierte Nutzungsanalysen
Hinweis: Nutzerspezifische Daten können aufgrund von Workspace-Datenschutzeinstellungen ausgeschlossen sein.
Weitere Informationen: Details zu Voraussetzungen, Rate Limits und Export-Größenlimits findest du in der Haupt-Usage Export API Dokumentation.
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Header

Authorization
string
erforderlich

API key as Bearer token with USAGE_EXPORT_API scope. Format "Bearer YOUR_API_KEY"

Body

application/json

Request body for usage export endpoints

from
object
erforderlich

Start date and timezone for the export

to
object
erforderlich

End date and timezone for the export

Antwort

Export successful

Successful response from usage export endpoints

success
boolean
erforderlich

Indicates if the export was successful

Beispiel:

true

data
object
erforderlich

Export data information