AI observability
datasets

Create an asynchronous JSONL export pinned to an immutable dataset revision.

post/api/projects/{project_id}/datasets/{id}/exports/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/datasets/{id}/exports/
  • Auth: HTTP bearer

Path parameters

idstring uuid required

A UUID string identifying this dataset.

project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Request body

revisioninteger

Dataset revision to export. Defaults to the latest revision when the export is created.

Response

idinteger required

Export ID used to check status and download the file.

status'pending' | 'complete' | 'failed' required
dataset_revisioninteger required

Immutable dataset revision included in the export.

filenamestring required

Generated JSONL filename.

created_atstring date-time required

When the export was requested.

expires_afterstring date-time required

When the generated file expires.

exceptionstring nullable required

Reason the export failed, or null while it is pending or complete.

Changes

No recorded changes to this operation across all 1 revision of this API.