API reference

Operator - Data Controls

One tag: method, path, summary, auth, and scopes. Request and response fields ship in this page — expand a row to read the contract.

Browse docs

Endpoints

GET

/api/v1/operator/data_requests Web Session

List data export/deletion requests

Description

Returns recent data export, deletion, and retention purge audit records for the current workspace.

Auth

Web Session

Responses

200

List of data control requests

Returns: DataRequestList

POST

/api/v1/operator/data_exports Web Session

Create data export

Description

Creates and executes a workspace data export request with optional format and payload limits.

Auth

Web Session

Request Body

Field	Type	Required	Description
data_export	object	Yes	Data export attributes
data_export.format	string	No	Export format (json or csv)
data_export.limit	integer	No	Max records per dataset
data_export.include_audit_logs	boolean	No	Include audit events in exported payload

Responses

201

Export completed

Returns: DataRequest

400

Invalid export payload

POST

/api/v1/operator/deletion_requests Web Session

Create deletion request

Description

Creates and executes a deletion request across traces, eval runs, and optionally audit events.

Auth

Web Session

Request Body

Field	Type	Required	Description
deletion_request	object	Yes	Deletion request attributes
deletion_request.include_audit_logs	boolean	No	When true and dataset allows, includes audit event deletion
deletion_request.dataset	string (traces, eval_runs, audit_events, all)	Yes	Dataset to delete
deletion_request.older_than_days	integer	No	Delete records older than this many days

Responses

201

Deletion completed

Returns: DataRequest

400

Invalid deletion payload

POST

/api/v1/operator/data_retention/purge Web Session

Run manual retention purge

Description

Runs immediate retention purge using workspace data_controls retention windows and logs an audit event.

Auth

Web Session

Responses

200

Retention purge summary

Returns: RetentionPurgeResult