Get dataset - Automate.ax

axiom.getDataset retrieves one dataset by name or ID. The result includes its kind, owner, timestamps, retention configuration, and edge metadata.

automations/axiom-get-dataset.automation.ts

import { automation, onHttpRequest } from "automate.ax"
import { axiom } from "automate.ax/axiom"

export default automation("Get dataset", () => {
  onHttpRequest({ scope: "automation" })
  axiom.getDataset({ datasetName: "production" })
})

Input

datasetName is required and accepts a dataset name or ID.

Output

Returns the dataset resource, including id, name, kind, description, owner, timestamps, and optional retention, sharing, map-field, write-access, and edge-deployment metadata.

Permission and failures

Axiom requires a valid API token but no specific token capability for this endpoint. The token must still have access to the requested dataset. Axiom returns an error when the dataset is missing or inaccessible.