Skip to main content
POST
Create dashboard

Authorizations

Authorization
string
header
required

Bearer token authentication via Auth0. Users authenticate through Auth0 Universal Login. Include the access token in the Authorization header: Authorization: Bearer <token>

Headers

X-Active-Brand
string<uuid>

Path Parameters

workspaceId
string
required

The workspace ID

Pattern: ^ws_[a-z0-9]+$

Query Parameters

brand_id
string<uuid>

Body

application/json

Brand context comes from the X-Active-Brand header (or ?brand_id= query); never from the request body.

slug
string
required
Pattern: ^[a-z][a-z0-9-]{1,62}$
name
string
required
Required string length: 1 - 120
description
string | null
Maximum string length: 2000
layout
object

Response

Dashboard created

dashboard
object
required
Last modified on April 25, 2026