---
title: "Changes to Retrieve a dashboard"
method: GET
path: "/v1/dashboards/{dashboardId}"
---

# Changes to Retrieve a dashboard

`GET /v1/dashboards/{dashboardId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 8 revisions.

- **2026-10-31** `bc90d1bfa738`: 4 info
- **2026-10-07** `aba5d34c749b`: 1 info
- **2026-07-13** `a4fea1ad9b9a`: 6 breaking, 2 warning, 24 info

## Changes

- **2026-10-31** `bc90d1bfa738`: 4 info
  - added the optional property `errorCode` to the response with the `401` status
  - added the optional property `errorCode` to the response with the `403` status
  - added the optional property `errorCode` to the response with the `404` status
  - added the optional property `errorCode` to the response with the `429` status
- **2026-10-07** `aba5d34c749b`: 1 info
  - added the new optional `header` request parameter `x-checkly-account`
- **2026-07-13** `a4fea1ad9b9a`: 6 breaking, 2 warning, 24 info
  - the response property `customUrl` became nullable for the status `200`
  - the `favicon` response's property type changed from `string` to no type for status `200`
  - the `keys/items/created_at` response's property format changed from `date` to `date-time` for status `200`
  - the `keys/items/updated_at` response's property format changed from `date` to `date-time` for status `200`
  - the `link` response's property type changed from `string` to no type for status `200`
  - the `logo` response's property type changed from `string` to no type for status `200`
  - removed the optional property `attributes` from the response with the `401` status
  - removed the optional property `attributes` from the response with the `429` status
  - added the optional property `sortByStatus` to the response with the `200` status
  - added `subschema #1, subschema #2, subschema #3` to the `favicon` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2, subschema #3` to the `link` response property `anyOf` list for the response status `200`
  - added `subschema #1, subschema #2, subschema #3` to the `logo` response property `anyOf` list for the response status `200`
  - the response property `message` became required for the status `401`
  - the response property `message` became required for the status `403`
  - the response property `message` became required for the status `404`
  - the response property `message` became required for the status `429`
  - the `keys` response's property default value `` was added for the status `200`
  - the `tags` response's property default value `` was added for the status `200`
  - removed the `30.00` enum value from the `paginationRate` response property for the response status `200`
  - removed the `300.00` enum value from the `paginationRate` response property for the response status `200`
  - removed the `300.00` enum value from the `refreshRate` response property for the response status `200`
  - removed the `401.00` enum value from the `statusCode` response property for the response status `401`
  - removed the `403.00` enum value from the `statusCode` response property for the response status `403`
  - removed the `404.00` enum value from the `statusCode` response property for the response status `404`
  - removed the `429.00` enum value from the `statusCode` response property for the response status `429`
  - removed the `60.00` enum value from the `paginationRate` response property for the response status `200`
  - removed the `60.00` enum value from the `refreshRate` response property for the response status `200`
  - removed the `600.00` enum value from the `refreshRate` response property for the response status `200`
  - removed the `Forbidden` enum value from the `error` response property for the response status `403`
  - removed the `Not Found` enum value from the `error` response property for the response status `404`
  - removed the `Too Many Requests` enum value from the `error` response property for the response status `429`
  - removed the `Unauthorized` enum value from the `error` response property for the response status `401`

---

[Operation](https://skmtc.dev/checklyhq/apis/checkly-public-api/docs/v1/dashboards/:dashboardId/get.md) - [API](https://skmtc.dev/checklyhq/apis/checkly-public-api.md) - [Page](https://skmtc.dev/checklyhq/apis/checkly-public-api/changes/v1/dashboards/:dashboardId/get)