---
title: "List dashboards for a project"
method: GET
path: "/api/dashboards/list"
tags: ["Dashboards"]
---

# List dashboards for a project

`GET /api/dashboards/list`

## Request

- Base URL: `https://pluto-api.trainy.ai`
- URL: `https://pluto-api.trainy.ai/api/dashboards/list`
- Auth: HTTP bearer

Returns dashboard views for a project with per-section summaries but WITHOUT the full widget config. Use /details/{viewId} to fetch a complete config.

## Query parameters

- `projectName` string, required: Name of the project

## Response `200`

Dashboards listed successfully

- ListDashboardsResponse
  - `dashboards` DashboardSummary[], required
    - `id` string, required: Dashboard view ID
    - `name` string, required: Dashboard name
    - `isDefault` boolean, required: Whether this is the project's default dashboard
    - `currentVersion` integer, required: Latest immutable dashboard version
    - `configValid` boolean, required: Whether the stored config matches the current schema
    - `sectionCount` number, required: Number of top-level sections
    - `widgetCount` number, required: Total widgets across all sections
    - `sections` DashboardSectionSummary[], required: Per-section summary
      - `id` string, required
      - `name` string, required
      - `widgetCount` number, required
      - `dynamicPattern` string, nullable, required
      - `childCount` number, required
    - `createdAt` string, required: ISO-8601 creation timestamp
    - `updatedAt` string, required: ISO-8601 last-update timestamp
    - `createdById` string, required: ID of the user who created the dashboard
    - `url` string, required: Deep link to the dashboard in the web UI

## Other responses

- `401`: Unauthorized
- `404`: Project not found

---

[API](https://skmtc.dev/trainy/apis/mlop-api.md) - [All operations](https://skmtc.dev/trainy/apis/mlop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trainy/apis/mlop-api/revisions/5d2c0b0baecb?raw)