Skip to main content
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

Authenticate using an API token or personal access token (PAT). Include the token as a Bearer token: Authorization: Bearer <token>. For more information, see Tokens.

Path Parameters

​
dataset_name
string
required

Unique name of the dataset.

Body

application/json
​
maxDuration
string
required
Example:

"1h"

Response

TrimResult

​
numDeleted
integer<int64>
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.