Accounts11

Alert channels6

Alert notifications1

Analytics12

Badges2

Check alerts2

Check groups11

Check results4

Check sessions7

Check status2

Checks16

Client certificates4

Dashboards5

Deployment Triggers2

Environment variables5

Error Groups4

Heartbeats5

Incident Updates3

Incidents4

Location1

Maintenance windows12

Monitors7

Private locations8

Reporting1

Rocky AI3

Runtimes2

Snippets5

Static IPs6

Status Page Incidents10

Status Page Services5

Status Pages8

Test Session Error Groups4

Test sessions7

Triggers6

Dashboards

Update a dashboard

Updates a dashboard. Will return a 409 when attempting to create a dashboard with a custom URL or custom domain that is already taken.

put/v1/dashboards/{dashboardId}

Path parameters

dashboardIdstring required

Headers

x-checkly-accountstring uuid

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Request body

customUrlstring nullable

A subdomain name under "checklyhq.com". Needs to be unique across all users.

customDomainstring nullable

A custom user domain, e.g. "status.example.com". See the docs on updating your DNS and SSL usage.

headerstring

A piece of text displayed at the top of your dashboard.

descriptionstring nullable

A piece of text displayed below the header or title of your dashboard.

width'FULL' | '960PX'

Determines whether to use the full screen or focus in the center.

refreshRatenumber

How often to refresh the dashboard in seconds.

paginateboolean

Determines of pagination is on or off.

paginationRatenumber

How often to trigger pagination in seconds.

sortByStatusboolean

Sort checks by status with failing checks first.

checksPerPagenumber nullable

Number of checks displayed per page.

useTagsAndOperatorboolean nullable

When to use AND operator for tags lookup.

hideTagsboolean

Show or hide the tags on the dashboard.

enableIncidentsboolean

Enable or disable incidents on the dashboard.

expandChecksboolean

Expand or collapse checks on the dashboard.

tagsstring[]

A list of one or more tags that filter which checks to display on the dashboard.

showHeaderboolean

Show or hide header and description on the dashboard.

showCheckRunLinksboolean

Show or hide check run links on the dashboard.

showGroupNamesboolean

Show or hide group names on the dashboard.

customCSSstring nullable

Custom CSS to be applied to the dashboard.

isPrivateboolean

Determines if the dashboard is public or private.

showP95boolean

Show or hide the P95 stats on the dashboard.

showP99boolean

Show or hide the P99 stats on the dashboard.

Response

Successful