Zum Hauptinhalt springen
POST
/
export
/
projects
Export project usage data
curl --request POST \
  --url https://api.langdock.com/export/projects \
  --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 Nutzungsdaten für Projekte im gewählten Zeitraum.
Dedicated Deployment?Ersetze api.langdock.com durch <your-deployment>/api/public in allen Anfragen.
Details zu Voraussetzungen und Rate Limits findest du in der Hauptdokumentation zur 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.
Für Workspaces mit deaktivierten Daten auf Nutzerebene wird die E-Mail des Projekt-Owners aus Exporten ausgeschlossen, um die Datenschutz-Compliance zu gewährleisten.

Enthaltene Daten

Der Projekt-Export gibt eine Zeile pro Projekt zurück.
SpalteBeschreibung
period_startStartdatum des Berichts
period_endEnddatum des Berichts
org_idID des Workspaces
project_idID des Projekts
project_nameName des Projekts
project_owner_idID des Projekt-Owners
project_owner_emailE-Mail des Projekt-Owners; nur enthalten, wenn Daten auf Nutzerebene aktiviert sind
messagesAnzahl der Nachrichten in Projekt-Chats
group_by wird für Projekt-Exporte nicht unterstützt.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. 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