> ## 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.

# List dashboards

> Lists dashboards visible to the token.

`axiom.listDashboards` lists dashboards visible to the token. Each resource includes stable UID, version, ownership metadata, and the complete document.

```ts automations/axiom-list-dashboards.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { axiom } from "automate.ax/axiom"

export default automation("List dashboards", () => {
  onHttpRequest({ scope: "automation" })
  axiom.listDashboards({ limit: 20, offset: 0 })
})
```

## Inputs

`limit` is an optional positive page size. `offset` is an optional non-negative page offset. Automate.ax supplies no pagination defaults, so Axiom applies its service defaults when either value is omitted.

## Output

Returns one array page of dashboard resources. Each item includes `id`, stable `uid`, exact decimal `version` string, the complete document, and creation and update metadata. No visible dashboards in the page returns `[]`.

## Permission and failures

The API token needs the organization-level `dashboards|read` capability. Axiom limits results to dashboards the token can access and returns authentication or authorization failures as action errors.