> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Get dataset

> Retrieves one dataset by name or ID.

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

```ts automations/axiom-get-dataset.automation.ts theme={null}
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.