---
sidebar:
  label: roboto.domain.dashboards
  order: 4
title: roboto.domain.dashboards
---
Saved metrics dashboards for visualizing an organization's data on the Roboto platform.

A dashboard is a named JSON document describing the sections, cards, and time parameters the web UI renders, stored on the platform so it can be reopened and shared. The platform stores that document verbatim and never interprets it: the definition is self-describing, carrying its own schema version for whichever client understands the schema. Ownership (`owner_principal_id`) is the sole source of truth for visibility: a dashboard owned by the org principal is shared with every member of the owning organization, while one owned by a user principal is personal (visible only to that user). Create and update requests express the choice via the `accessibility` knob, which the server folds into ownership. Dashboard names must be unambiguous for each viewer within their organization.

## Submodules

- [roboto.domain.dashboards.operations](/docs/reference/python-sdk/roboto/domain/dashboards/operations)
- [roboto.domain.dashboards.record](/docs/reference/python-sdk/roboto/domain/dashboards/record)

## Package Contents

- [CreateDashboardRequest](/reference/python-sdk/roboto/domain/dashboards/operations#roboto.domain.dashboards.operations.CreateDashboardRequest) (class): Request body for `POST /v1/metrics/dashboards/create`.

- [DashboardAccessibility](/reference/python-sdk/roboto/domain/dashboards/record#roboto.domain.dashboards.record.DashboardAccessibility) (class): Controls who can view a dashboard.

- [DashboardRecord](/reference/python-sdk/roboto/domain/dashboards/record#roboto.domain.dashboards.record.DashboardRecord) (class): A wire-transmissible representation of a dashboard

- [UpdateDashboardRequest](/reference/python-sdk/roboto/domain/dashboards/operations#roboto.domain.dashboards.operations.UpdateDashboardRequest) (class): Request body for `PUT /v1/metrics/dashboards/id/<dashboard_id>`.