POST
/
datasets
/
{dataset_name}
/
trim
cURL
curl --request POST \
  --url https://api.axiom.co/v1/datasets/{dataset_name}/trim \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "maxDuration": "1h"
}'
{
  "numDeleted": 123
}
When the endpoint returns the status code 200, it means that the deletion request is queued. The deletion itself might take several hours to complete.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
dataset_name
string
required

Unique name of the dataset.

Body

application/json
​
maxDuration
string
required
Example:

"1h"

Response

TrimResult

​
numDeleted
integer
required

numDeleted has been deprecated on 2022-09-14. There is currently no way to tell how much was trimmed via the trim result. If you need to check how much was deleted you can either query the removed time range, or poll the dataset info endpoint.