datasets

Trim dataset by duration

Queues a job that deletes data older than maxDuration from an events, logs, or metrics dataset, and returns the job ID. Deletion runs asynchronously.

post/datasets/{dataset_id}/trim

Request

Base URL
https://api.axiom.co/v2
Auth
OAuth 2
Authorization codehttps://accounts.google.com/o/oauth2/v2/auth
Token URLhttps://www.googleapis.com/oauth2/v4/token
Scopestrim|update
TypeScript
https://skmtc.dev/axiom/apis/axiom-public-api/docs/datasets/:dataset_id/trim/post.ts
A function with typed inputs. Its response is checked against the schema.

dataset_idstring required

maxDurationstring required

{
  "maxDuration": "1h"
}

Job created

jobIDstring required

Oct 14, 2026v28920e1697284 Revision changes
- breaking
  removed the success response with the status
- info
  added the success response with the status