---
title: "Create a board"
method: POST
path: "/v1/dashboards"
tags: ["Boards"]
---

# Create a board

`POST /v1/dashboards`

## Request

- Base URL: `https://api.stackdata.io`
- URL: `https://api.stackdata.io/v1/dashboards`
- Auth: one of:
  - none
  - API key in header `X-API-Key`

## Request body

- object
  - `title` string: Board title (defaults to "Untitled", trimmed to 120 chars).

## Response `200`

The created board.

- Board
  - `id` string
  - `title` string
  - `updated_at` string
  - `visibility` 'public' | 'private'
  - `public` boolean
  - `forced_public` boolean
  - `is_owner` boolean
  - `author` string: Anonymised author handle (user-<hash>).
  - `items` BoardItem[]
    - `item_id` integer
    - `position` integer
    - `prompt` string
    - `params` object

---

[API](https://skmtc.dev/stackdata/apis/stackdata-api.md) · [All operations](https://skmtc.dev/stackdata/apis/stackdata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stackdata/apis/stackdata-api/revisions/91358ae3f6e8?raw)