List all dashboards

GET/v2/dashboards

Lists dashboards visible to the caller, sorted by name and paginated with limit and offset. Labels are resolved unless exclude=labels.

Parameters

Property	Type	Location	Description
`limit`	`integer<int64>`	`query`
`offset`	`integer<int64>`	`query`
`exclude`	`string`	`query`	Exclude resolved label objects from each dashboard response. The labelIds field is still returned.
`labelIds`	`string[]`	`query`	Return dashboards assigned every specified label ID.

Request

curl -X GET 'https://api.axiom.co/v2/dashboards' \
  -H 'Authorization: Bearer API_TOKEN'

Try itRun this request against your Axiom organization

Credentials stay in this browser tab and are only sent to Axiom when you run the request.

API token Requiredlimit queryoffset queryexclude querylabelIds query

Response

200Dashboards visible to the caller.

application/json

400Invalid label filter

application/json

Property	Type	Description
`createdAt`	`string<date-time>`Required
`createdBy`	`string`Required
`dashboard`	`object`Required
`name`	`string`Required
`owner`	`string`Required	User ID of the dashboard owner. Use `X-AXIOM-EVERYONE` to make the dashboard accessible to all users in the organization.
`description`	`string`
`charts`	`unknown[]`Required
`layout`	`object[]`Required
`i`	`string`Required
`x`	`integer`Required
`y`	`integer`Required
`w`	`integer`Required
`h`	`integer`Required
`minW`	`integer`
`minH`	`number`
`maxW`	`integer`
`maxH`	`integer`
`static`	`boolean`
`sections`	`object[]`
`id`	`string<uuid>`Required
`title`	`string`Required
`defaultCollapsed`	`boolean`
`refreshTime`	`integer`Required
`schemaVersion`	`integer`Required
`against`	`string`	Relative time comparison offset. Compares the current time window against a previous period offset by this duration. Mutually exclusive with `againstTimestamp` — setting one clears the other. Use an empty string or omit to disable comparison.
`againstTimestamp`	`string`	Absolute or relative timestamp to compare against. Mutually exclusive with `against` — setting one clears the other. Accepts ISO 8601, `now-{duration}` (e.g. `now-1h`), or epoch milliseconds as a string.
`timeWindowStart`	`string`Required	Start of the dashboard time range. Use `qr-now-{duration}` for a quick range relative to now, where duration is a number followed by `s` (seconds), `m` (minutes), `h` (hours), `d` (days), or `w` (weeks). Examples: `qr-now-5m`, `qr-now-1h`, `qr-now-7d`. Alternatively, use a Unix epoch millisecond timestamp as a string (e.g. `1704067200000`).
`timeWindowEnd`	`string`Required	End of the dashboard time range. Use `qr-now` for a rolling window that tracks the current time (pair with a `qr-now-{duration}` start), or a Unix epoch millisecond timestamp as a string (e.g. `1704153600000`).
`uid`	`string`	Optional dashboard UID. Must contain only letters, numbers, underscores, or hyphens, with length 1-128 when provided.
`id`	`string`Required
`labelIds`	`string[]`Required
`labels`	`object[]`
`color`	`object`Required
`name`	`string`Required
`type`	`string`Required
`description`	`string`
`id`	`string`Required
`name`	`string`Required
`uid`	`string`Required
`updatedAt`	`string<date-time>`Required
`updatedBy`	`string`Required
`version`	`integer<int64>`Required