Skip to main content
POST
/
v1
/
lovelace
Create a new dashboard
curl --request POST \
  --url http://0.0.0.0:3000/v1/lovelace \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "principal",
  "type": "lovelace",
  "title": "Principal",
  "icon": "mdi:home"
}
'
{
  "id": 1,
  "name": "default",
  "type": "lovelace",
  "title": "Início",
  "icon": "mdi:home",
  "url": null,
  "config": {
    "views": []
  },
  "created_at": "2026-03-17T10:00:00Z",
  "updated_at": "2026-03-17T10:00:00Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Organization-Id
string

ID da organização para contexto (opcional). Quando presente, filtra recursos da org.

Body

application/json
​
name
string
required

Slug único do dashboard

​
type
enum<string>
required

Tipo do dashboard

Available options:
lovelace,
webpage
​
title
string | null

Título exibido

​
icon
string | null

Ícone Material

​
url
string | null

URL (apenas para tipo webpage)

Response

Dashboard created

​
id
integer
​
name
string
​
type
enum<string>
Available options:
lovelace,
webpage
​
title
string | null
​
icon
string | null
​
url
string | null
​
config
object
​
created_at
string<date-time>
​
updated_at
string<date-time>