---
title: "Publish a dashboard — an HTML page, or a live page with named reads (org admin, staff)"
method: POST
path: "/api/orgs/{orgId}/dashboards"
tags: ["dashboards"]
---

# Publish a dashboard — an HTML page, or a live page with named reads (org admin, staff)

`POST /api/orgs/{orgId}/dashboards`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/orgs/{orgId}/dashboards`
- Auth: none declared

## Path parameters

- `orgId` string, required

## Request body

- BiDashboardInput
  - `title` string, required
  - `description` string
  - `kind` 'board' | 'html' | 'live', required
  - `audience` union
    - object
      - `kind` 'private', required
    - object
      - `kind` 'people', required
      - `uids` string[], required
    - object
      - `kind` 'rooms', required
      - `groupIds` string[], required
    - object
      - `kind` 'org', required
  - `official` boolean
  - `cardIds` string[]
  - `html` string
  - `queries` object[]
    - `name` string, required
    - `tool` string
    - `args` object, required
    - `shape` 'rows' | 'row' | 'value' | 'json'
    - `merge` boolean
  - `cacheSec` integer
  - `note` string

## Response `201`

Published.

- object
  - `dashboard` BiDashboard, required
    - `title` string, required
    - `description` string
    - `kind` 'board' | 'html' | 'live', required
    - `audience` union
      - object
        - `kind` 'private', required
      - object
        - `kind` 'people', required
        - `uids` string[], required
      - object
        - `kind` 'rooms', required
        - `groupIds` string[], required
      - object
        - `kind` 'org', required
    - `official` boolean
    - `cardIds` string[]
    - `queries` object[]
      - `name` string, required
      - `tool` string
      - `args` object, required
      - `shape` 'rows' | 'row' | 'value' | 'json'
      - `merge` boolean
    - `cacheSec` integer
    - `id` string, required
    - `orgId` string, required
    - `status` 'active' | 'deleted', required
    - `owner` object, required
      - `id` string, required
      - `name` string
    - `createdBy` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `version` integer, required
    - `versions` object[]
      - `version` integer, required
      - `at` string, date-time, required
      - `by` string, required
      - `bytes` integer, required
      - `sha256` string, required
      - `queries` integer, required
      - `note` string
    - `stats` object
      - `views` integer
      - `viewers` string[]
      - `lastViewedAt` string, date-time
    - `deleted` object
      - `by` string, required
      - `at` string, date-time, required
    - `canEdit` boolean, required

## Other responses

- `400`: Invalid request.
- `403`: Not allowed, or dashboards are closed for this organization.
- `404`: Unknown dashboard (or one the reader may not see).

## Changes

- **2026-10-20** `5a47416c82ec`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wizbi/apis/wizbi-core-api/changes/api/orgs/:orgId/dashboards/post.md)

---

[API](https://skmtc.dev/wizbi/apis/wizbi-core-api.md) · [All operations](https://skmtc.dev/wizbi/apis/wizbi-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wizbi/apis/wizbi-core-api/revisions/5a47416c82ec?raw)