---
title: "Create a shareable dashboard"
method: POST
path: "/api/dashboards"
tags: ["community"]
---

# Create a shareable dashboard

`POST /api/dashboards`

## Request

- Base URL: `https://cityalert.live`
- URL: `https://cityalert.live/api/dashboards`
- Auth: none declared

Returns {id, token}; the token is the write credential — share the URL, keep the token private.

## Request body

- object
  - `name` string
  - `config` object, required

## Response `200`

Created dashboard

- object
  - `id` string
  - `token` string

## Other responses

- `400`: Invalid config

---

[API](https://skmtc.dev/cityalert/apis/cityalert-live-api.md) · [All operations](https://skmtc.dev/cityalert/apis/cityalert-live-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cityalert/apis/cityalert-live-api/revisions/75ee240bd387?raw)