Skip to main content
POST
/
v1
/
tags
Create a new tag
curl --request POST \
  --url http://0.0.0.0:3000/v1/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Sala de estar",
  "tag_id": "TAG-ABC123",
  "icon": "mdi:tag",
  "color": "#2196F3"
}
'
{
  "id": 1,
  "name": "Sala de estar",
  "tag_id": "TAG-ABC123",
  "icon": "mdi:tag",
  "color": "#2196F3",
  "user_id": "user_abc123",
  "org_id": null,
  "created_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

Nome da tag

​
tag_id
string
required

Identificador único da tag (ex: lido do QR code)

​
icon
string

Ícone Material

Example:

"mdi:tag"

​
color
string

Cor hex

Example:

"#2196F3"

Response

Tag created

​
id
integer
​
name
string
​
tag_id
string
​
icon
string | null
​
color
string | null
​
user_id
string
​
org_id
string | null
​
created_at
string<date-time>