Przejdź do treści
Intum
Aktualizacja: 2 min czytania

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