Skip to main content
POST
Export agent usage data
This endpoint exports agent usage data including message counts per agent, active user counts, and usage trends over time.

Before You Start

  • Prerequisites and rate limits: See the Usage Export API overview.
  • Browser requests: Langdock intentionally blocks browser-origin requests to protect your API key. Use API keys server-side and store them securely. See API Key Best Practices.

Base URL

Dedicated deploymentsReplace api.langdock.com with <your-deployment-url>/api/public in all requests.
The legacy path /export/assistants remains available and returns the same data.

Data Included

By default, the agent export returns one row per agent for the selected period.

Additional Columns for BYOK Workspaces

Because BYOK workspaces supply their own model keys, Langdock can provide token consumption data directly. This is not possible when obtaining your models directly through Langdock.

Grouped Export

Use group_by=model to return one row per agent and model. Agent-level KPI fields are omitted in grouped mode.

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

group_by
enum<string>

Optional aggregation dimension.

Available options:
model

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