Zum Hauptinhalt springen
POST
/
api
/
public
/
export
/
users
Export user usage data
curl --request POST \
  --url https://api.langdock.com/api/public/export/users \
  --header 'Authorization: <authorization>' \
  --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": "assistants-usage/workspace-id/assistants-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.

Headers

Authorization
string
required

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
required

Start date and timezone for the export

to
object
required

End date and timezone for the export

Response

Export successful

Successful response from usage export endpoints

success
boolean
required

Indicates if the export was successful

Example:

true

data
object
required

Export data information

I