Skip to main content
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"
    }
  }
}
Using a dedicated deployment?Replace api.langdock.com with <your-deployment>/api/public in all requests.
For details on prerequisites and rate limits, please refer to the main Usage Export API documentation.
Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.
This endpoint exports project usage data including activity metrics, involved users per project, and resource consumption statistics.
For workspaces with user-level data disabled, the project owner email is excluded from exports to maintain privacy compliance.

​
Data Included

The project export returns one row per project.
ColumnDescription
period_startStart date of the report
period_endEnd date of the report
org_idID of the workspace
project_idID of the project
project_nameName of the project
project_owner_idID of the project owner
project_owner_emailEmail of the project owner; included only when user-level data is enabled
messagesNumber of messages in project chats
group_by is not supported for project exports.

Authorizations

​
Authorization
string
header
required

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