Tagy

Štítky pre kategorizáciu kontaktov, dokumentov a nákladov.

Tagy sú voľná kategorizácia pre kontakty, dokumenty, náklady a obchodné záznamy. Tag pridáš cez tag_ids field na cieľovej entite. Pole usage_count v odpovedi udáva, koľko entít aktuálne tag používa.

Endpointy

POST/api/v1/tagstags:write

Vytvorí nový tag.

Request

curl -X POST "https://monivio.sk/api/v1/tags" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "VIP",
  "color": "#fbbf24"
}'

Response 201json

{
  "data": {
    "id": "tag_xkzql9bm7nt4vr8scdhfwgyj",
    "name": "VIP",
    "color": "#fbbf24",
    "usage_count": 0,
    "created_at": "2026-04-15T10:00:00.000Z"
  }
}

GET/api/v1/tagstags:read

Zoznam tagov, voliteľný full-text search cez query parameter.

Request

curl "https://monivio.sk/api/v1/tags?search=VIP" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response 200json

{
  "data": [
    {
      "id": "tag_xkzql9bm7nt4vr8scdhfwgyj",
      "name": "VIP",
      "color": "#fbbf24",
      "usage_count": 12,
      "created_at": "2026-04-15T10:00:00.000Z"
    }
  ]
}

GET/api/v1/tags/{id}tags:read

Detail jedného tagu.

Request

curl "https://monivio.sk/api/v1/tags/con_2hf8pq3rxn4mlkzyt9abwvve" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response 200json

{
  "data": {
    "id": "tag_xkzql9bm7nt4vr8scdhfwgyj",
    "name": "VIP",
    "color": "#fbbf24",
    "usage_count": 12,
    "created_at": "2026-04-15T10:00:00.000Z"
  }
}

PATCH/api/v1/tags/{id}tags:write

Update mena alebo farby. Aspoň jedno z polí (name, color) je povinné.

Request

curl -X PATCH "https://monivio.sk/api/v1/tags/con_2hf8pq3rxn4mlkzyt9abwvve" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
  "color": "#ef4444"
}'

Response 200json

{
  "data": {
    "id": "tag_xkzql9bm7nt4vr8scdhfwgyj",
    "name": "VIP",
    "color": "#ef4444",
    "usage_count": 12,
    "created_at": "2026-04-15T10:00:00.000Z"
  }
}

DELETE/api/v1/tags/{id}tags:write

Zmaže tag. Referencie z entít (kontakty, dokumenty, náklady) sa odstránia automaticky.

Request

curl -X DELETE "https://monivio.sk/api/v1/tags/con_2hf8pq3rxn4mlkzyt9abwvve" \
  -H "Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Objekt Tag

idreadonly

string

CUID2 ID s prefixom tag_.

Príklad: tag_xkzql9bm7nt4vr8scdhfwgyj

namerequired

string

Názov tagu (max 50 znakov).

Príklad: VIP

color

string (#hex)

Farba pre UI badge (formát #RRGGBB, 6-miestny hex). Voliteľné pri vytvorení – ak vynecháš, systém priradí default.

Príklad: #fbbf24

usage_countreadonly

number

Počet entít (kontakty, dokumenty, náklady, obchodné záznamy), ktoré aktuálne tag používajú. Aktualizuje sa automaticky.

Príklad: 12

created_atreadonly

string (ISO 8601)

Vytvorenie.