latestOpenAPI 3.1.02026-08-223391355.6 KB

aa8d44585147

projects

Export workspace messages (Preview)

Plan: Enterprise

Allows workspace admins and owners to start a one-off export of user-authored messages from projects visible to them. Project and user filters may be combined; when both are supplied, only messages matching both are exported. The warehouse-backed snapshot can lag by up to 26 hours, defaults to the preceding 90 days, and is delivered as a ZIP containing JSONL. Poll the returned export ID; completed files expire after seven days. Filter options and delivery metadata may change before graduation.

This operation is in public preview (beta) and served under /v1beta. Request and response shapes may change before it graduates to the stable /v1 surface.

post/v1beta/workspaces/{workspace_id}/message-exports

Path parameters

workspace_idstring required

Workspace ID

Request body

end_datestring

Exclusive RFC3339 end time. Defaults to the request time.

project_idstring

Export only messages from this project. The project must be visible to the caller. May be combined with user_id; both filters must match.

start_datestring

Inclusive RFC3339 start time. Defaults to 90 days before end_date.

user_idstring

Export only messages sent by this user. May be combined with project_id; both filters must match.

Response

Accepted

export_idstring required

Export ID used to poll status.

status'running' required

Initial export status (running).