Trim dataset

POST/v1/datasets/{dataset_name}/trim

Queues a job that deletes data older than maxDuration from a dataset and returns the job ID. Deletion runs asynchronously and can take several hours to complete.

Parameters

Property	Type	Location	Description
`dataset_name`	`string`Required	`path`	Unique name of the dataset.

Body

application/json

Property	Type	Description
`maxDuration`	`string`Required

Request

curl -X POST 'https://api.axiom.co/v1/datasets/DATASET_NAME/trim' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"maxDuration":"1h"}'

Try itRun this request against your Axiom organization

Credentials stay in this browser tab and are only sent to Axiom when you run the request.

API token Requireddataset_name pathRequiredRequest body application/json

Response

200Job created.

application/json

403Forbidden

application/json

Property	Type	Description
`jobID`	`string`	ID of the trim job