Skip to main content
axiom.trimDataset deletes events older than the relative maxDuration. Axiom evaluates the duration at execution time and returns no response body.
automations/axiom-trim-dataset.automation.ts
This operation changes or deletes provider data. Confirm the target before deployment.

Inputs

datasetName selects the dataset by name or ID. maxDuration is a required, non-empty relative duration such as "720h"; Axiom removes events older than that duration when it processes the request. There are no defaults.

Output

Returns null after Axiom accepts the trim request. A successful response means Axiom queued the deletion, not that every matching event has already disappeared; completion can take several hours.

Permission and failures

The API token needs the dataset-level trim|update capability for datasetName. Axiom rejects missing or inaccessible datasets and invalid duration expressions. This destructive mutation is not retried automatically after an ambiguous provider response.