---
title: "Create a dashboard saved view."
method: POST
path: "/dashboard/views"
tags: ["dashboard"]
---

# Create a dashboard saved view.

`POST /dashboard/views`

## Request

- Base URL: `https://api.coldrig.dev`
- URL: `https://api.coldrig.dev/dashboard/views`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `cs_dashboard_session`

## Request body

- DashboardViewCreateInput
  - `name` string, required
  - `layout` DashboardLayout, required
    - `schemaVersion` 1, required
    - `widgets` object[], required
      - `id` string, required
      - `type` 'kpi_row' | 'mailbox_health' | 'campaign_performance' | 'activity_feed' | 'inbox_preview' | 'agent_log' | 'agent_note' | 'quota_usage', required
      - `gridPos` object, required
        - `x` integer, required
        - `y` integer, required
        - `w` integer, required
        - `h` integer, required
      - `visible` boolean, required
      - `props` object, required
  - `note` string

## Response `201`

View created.

- DashboardViewDetail
  - `id` string, required
  - `name` string, required
  - `isDefault` boolean, required
  - `rev` integer, required
  - `editedBy` 'dashboard' | 'mcp' | 'api' | 'system', required
  - `editedByNote` string, nullable, required
  - `updatedAt` string, required
  - `layout` DashboardLayout, required
    - `schemaVersion` 1, required
    - `widgets` object[], required
      - `id` string, required
      - `type` 'kpi_row' | 'mailbox_health' | 'campaign_performance' | 'activity_feed' | 'inbox_preview' | 'agent_log' | 'agent_note' | 'quota_usage', required
      - `gridPos` object, required
        - `x` integer, required
        - `y` integer, required
        - `w` integer, required
        - `h` integer, required
      - `visible` boolean, required
      - `props` object, required
  - `createdAt` string, required

## Other responses

- `401`: Missing, invalid, or inactive bearer token.
- `422`: Invalid/unknown widget type or props (syntactically valid JSON, semantically invalid).

---

[API](https://skmtc.dev/coldrig/apis/agent-cold-email-api.md) · [All operations](https://skmtc.dev/coldrig/apis/agent-cold-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coldrig/apis/agent-cold-email-api/revisions/242a462d82c4?raw)