Przejdź do treści
Intum

Tagi

Aktualizacja: • 2 min czytania

Przejdź do sekcji

  1. Czym są tagi?
  2. Właściwości tagu
  3. Dostępność w modułach
  4. Tworzenie tagu
  5. Liczniki
  6. Łączenie tagów
  7. Ważne informacje

Endpointy

Metoda Ścieżka Opis
GET /organize/tags.json Lista tagów
GET /organize/tags/:id.json Pojedynczy tag
POST /organize/tags.json Utworzenie tagu
PATCH /organize/tags/:id.json Aktualizacja tagu
DELETE /organize/tags/:id.json Usunięcie tagu

Autoryzacja: Authorization: Bearer TOKEN (uprawnienie: organize)

Pola tagu

Pole Typ Wymagane Opis
name string tak Nazwa tagu (unikalna, lowercase)
description string nie Opis tagu
color string nie Kolor hex (domyślnie #d3d3d3)
all_modules boolean nie Dostępny we wszystkich modułach (domyślnie true)
use_in_tasks boolean nie Dostępny w zadaniach
use_in_emails boolean nie Dostępny w mailach
use_in_clients boolean nie Dostępny w klientach CRM
use_in_calls boolean nie Dostępny w rozmowach VoIP

Tworzenie tagu

POST /organize/tags.json
Authorization: Bearer TOKEN

{
  "tag": {
    "name": "pilne",
    "color": "#EF4444",
    "description": "Sprawy wymagające natychmiastowej reakcji"
  }
}

Aktualizacja tagu

PATCH /organize/tags/:id.json

{
  "tag": {
    "color": "#F59E0B",
    "use_in_tasks": true,
    "use_in_emails": true,
    "all_modules": false
  }
}

Dodatkowe endpointy

Metoda Ścieżka Opis
POST /organize/tags/find_or_create Znajdź lub utwórz tag po nazwie
GET /organize/tags/search_names.json?q=pilne Wyszukiwanie tagów po nazwie
POST /organize/tags/join_tags Scalenie wielu tagów w jeden

Błędy (422)

{"name": ["nie może być puste"]}