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"]}