> ## Documentation Index
> Fetch the complete documentation index at: https://code.dcycle.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboards API

> Create and manage dashboards with customizable widgets for emissions data visualization

# Dashboards API

The Dashboards API enables you to create, manage, and configure interactive dashboards for visualizing emissions data. Dashboards are linked to projects and contain responsive grid layouts with configurable widgets.

<Note>
  **New API (v2)**: These endpoints use the latest dashboard architecture backed by PostgreSQL. Use `/v2/dashboard` for new integrations.
</Note>

## Key Features

* **Project-Linked Dashboards**: Each dashboard belongs to a project and inherits its organization context
* **Responsive Layouts**: Grid layouts adapt across breakpoints (`lg`, `md`, `sm`, `xs`, `xxs`)
* **Configurable Widgets**: Add widgets for emissions, waste, water, logistics, and custom KPI visualizations
* **Organization Hierarchy**: Child organizations can view parent dashboards (read-only)

## Authentication

All endpoints require authentication using an API key included in the `x-api-key` header.

## Available Endpoints

<CardGroup cols={2}>
  <Card title="List Dashboards" icon="table-columns" href="/api-reference/dashboards/list">
    List all dashboards for your organization
  </Card>

  <Card title="Get Dashboard" icon="chart-mixed" href="/api-reference/dashboards/get">
    Retrieve a dashboard with widgets and layouts
  </Card>

  <Card title="Create Dashboard" icon="plus" href="/api-reference/dashboards/create">
    Create a new dashboard for a project
  </Card>

  <Card title="Update Dashboard" icon="pencil" href="/api-reference/dashboards/update">
    Modify dashboard widgets and layouts
  </Card>

  <Card title="Delete Dashboard" icon="trash" href="/api-reference/dashboards/delete">
    Remove a dashboard
  </Card>
</CardGroup>

## Related Documentation

<CardGroup cols={2}>
  <Card title="Projects API" icon="folder" href="/api-reference/projects/overview">
    Manage projects linked to dashboards
  </Card>

  <Card title="Emissions API" icon="chart-line" href="/api-reference/emissions/overview">
    View aggregated emissions summaries
  </Card>

  <Card title="MCP Tools" icon="robot" href="/mcp/dashboards">
    Access dashboards from AI assistants via MCP
  </Card>
</CardGroup>