Запрос

PUT /task/[task_id]

Передаваемые параметры

  • task_id - ID задачи

Тело запроса

{
 "title": "task_title",
  "text": "task_text",
  "owner_id": owner_id,
  "project_id": project_id,
  "date_start": timestamp,
  "date_end": date_end,
  "remind_type": 2,
  "remind_method": ["sms", "email", "popup"],
  "lead_id": lead_id,
  "observers": [observer_id, observer_id],
  "labels": [label_id, label_id],
  "visibility": visibility,
  "status": status
}

Описание полей

  • task_title - Название задачи - обязательное текстовое поле;
  • task_text - Информация о задаче - необязательное текстовое поле;
  • owner_id - Ответственный - обязательное поле. Id сотрудника, к которому нужно привязать задачу;
  • project_id - Проект - обязательное поле. Id проекта, в котором нужно создать задачу.
  • date_start - Дата начала задачи. Формат unix timestamp
  • date_end - Дата завершения задачи. Формат unix timestamp
  • remind_type - Время напоминания - необязательное поле.

    Может передаваться один из вариантов (числовое значение):

    без напоминания - 0 ,вовремя - 1 ,за час - 2 ,за неделю - 3 Если ничего не передано, сохранится вариант “без напоминания”

  • remind_method - Способ напоминания - необязательное поле. Но если “Время напоминания” не равно “без напоминания”, то способ напоминания должен быть обязательным.

    Может передаваться один или несколько из вариантов (массив строк):

    sms ,email ,call - звонок ,popup - всплывающее окно

  • lead_id - ID связанного лида - необязательное поле. ID лида, к которому нужно привязать задачу (как если бы она была создана из карточки лида)

  • observers - Кто может видеть задачу - необязательное поле. Cписок id сотрудников. Если ничего не передано, то задача должна быть видна всем сотрудникам.
  • labels - Метки - необязательное поле. Список id меток.
  • visibility - Кто может видеть задачу: 0 - только я, 1 - все, 2 - только указанные в observers сотрудники.
  • status - Статус задачи: 0 - начата, 1 - выполнена.

Пример запроса

curl -H 'Content-Type: application/json' \
    -H 'token: someToken' \
    -X PUT \
    -d '{ "contact_id": 9, "title": "Новое название", "text": "новое описание", "owner_id": 19010, "project_id": 649, "date_start": 1688896800, "date_end": 16999948798, "remind_type": 5, "remind_method": ["sms", "email", "popup"], "lead_id": 393989, "observers": [9, 19010, 19011], "labels": [158, 159], "visibility": 2, "status":1 } ' \
    https://direct.lptracker.ru/task/1234

Пример ответа при успешном выполнении:

{
    "status": "success",
    "result": {
        "id": 3893,
        "title": "Новое название",
        "text": "новое описание",
        "owner_id": 19010,
        "project_id": 649,
        "date_start": 1688896800,
        "date_end": 16999948798,
        "remind_type": 1,
        "remind_method": "sms,email,popup",
        "lead_id": 393989,
        "visibility": 2,
        "status": 1,
        "observers": [
            {
                "id": 9,
                "phone": "79161676999",
                "name": "Иванов Иван",
                "last_project_id": 649
            },
            {
                "id": 19010,
                "email": "polyanskiy@mail.ru",
                "phone": "79161234567",
                "name": "Петр Петров",
                "job": "Менеджер",
                "avatar": "/img/icon/contacts-person.png"
            },
            {
                "id": 19011,
                "email": "polyanskiy@mail.ru",
                "phone": "79161234567",
                "name": "Мария Васильева",
                "job": "Менеджер",
                "avatar": "/img/icon/contacts-person.png"
            }
        ],
        "labels": [
            {
                "id": 158,
                "name": "Тестирование",
                "color": "F7F0C5"
            },
            {
                "id": 159,
                "name": "Работает",
                "color": "F7F0C5"
            }
        ]
    }
}

Описание модели задачи