Register data export requests

Configure which analytics data entities your organization receives as recurring CSV exports via SFTP. This is typically a one-time setup — once registered, the system automatically exports data on the configured schedule without further action.

How it works

  1. Choose which entities to export (e.g. user, content, user logins) and how often (daily, weekly, or monthly).
  2. First export delivers the complete historical data (full load) for each registered entity.
  3. Subsequent exports deliver only incremental (delta) data — records from the previous period — keeping file sizes manageable.
  4. Exported CSV files are delivered to a secure, SFTP-accessible location partitioned by date: /exports/<tenant-id>/<year>/<month>/<day>/<entity>/<entity>.csv

Replace semantics

Each call replaces your entire export configuration. The entities you include in the request become your active set; any previously registered entities not present in the new request are deactivated. To add a single entity without affecting others, first retrieve your current configuration via GET /export, then submit the full updated list.

Quick example

{
  "exportOption": "export selected",
  "entityList": ["user", "content", "user logins", "interaction"],
  "frequency": "daily"
}

Field reference

FieldDescription
exportOptionexport all — register every supported entity (entityList is ignored); export selected (default) — register only the entities listed in entityList; disable export — deactivate all exports for the tenant.
entityListOne or more entity names (array or comma-separated string). Required when exportOption is export selected. Uses human-readable display names — e.g. user logins instead of user_login_events, must reads instead of content_must_read_marked. See the schema for the full list.
frequencydaily (default) — exported every day; weekly — exported every Monday; monthly — exported on the 1st of each month.
Body Params

Configure which data entities are included in your scheduled analytics exports.

string
enum
Defaults to export selected

Controls which entities are registered for export. export all — register every supported entity (entityList is ignored); export selected — register only the entities specified in entityList; disable export — deactivate all data exports for the tenant.

Allowed:
entityList
string
enum
Defaults to daily

Export schedule frequency. daily — exported every day; weekly — exported every Monday; monthly — exported on the 1st of each month.

Allowed:
Responses

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json