Przejdź do treści
Intum

Statusy

Aktualizacja: • 2 min czytania

Przejdź do sekcji

  1. Czym są statusy?
  2. Kategorie statusów
  3. Dostępność w modułach
  4. Statusy a zespoły
  5. Zamknięcie statusu
  6. Tworzenie statusu
  7. Kolejność wyświetlania
  8. Usuwanie statusu
  9. Liczniki
  10. Ważne informacje

Endpointy

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

Autoryzacja: Authorization: Bearer TOKEN (uprawnienie: organize)

Pola statusu

Pole Typ Wymagane Opis
name string tak Nazwa statusu (unikalna)
description string nie Opis statusu
kind string nie Typ: tasks (domyślnie)
category string nie Kategoria: todo, in_progress, ready, done
color string nie Kolor hex (domyślnie #3730A3)
closed boolean nie Czy status zamykający
active boolean nie Czy aktywny
priority number nie Priorytet wyświetlania
all_modules boolean nie Dostępny we wszystkich modułach
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
use_in_contacts boolean nie Dostępny w kontaktach
use_in_deals boolean nie Dostępny w dealach
team_ids array nie ID zespołów, w których status jest dostępny

Tworzenie statusu

POST /organize/statuses.json
Authorization: Bearer TOKEN

{
  "status": {
    "name": "Do weryfikacji",
    "category": "ready",
    "color": "#8B5CF6",
    "use_in_tasks": true,
    "all_modules": false,
    "team_ids": [1, 2]
  }
}

Aktualizacja statusu

PATCH /organize/statuses/:id.json

{
  "status": {
    "closed": true,
    "category": "done"
  }
}

Zmiana kolejności

Metoda Ścieżka Opis
POST /organize/statuses/:id/up.json Przesuń w górę
POST /organize/statuses/:id/down.json Przesuń w dół

Błędy (422)

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