Обновление наряда

Для обновления наряда отправьте PATCH-запрос на https://api.planadoapp.com/v2/jobs/:job_id. Здесь :job_id это uuid или external_id.

$ curl -H "Authorization: Bearer api-key" \
       -X PATCH \
       --data "{\"description\": \"Updated description\"}" \
       https://api.planadoapp.com/v2/jobs/8070f98d-b3f6-4cc8-b7c4-54b6709cd98b | jq
{
  "job_uuid": "8070f98d-b3f6-4cc8-b7c4-54b6709cd98b"
}

Схема запроса

Все поля необязательны.

Поле Тип JSON-тип Обязательно Может быть null Описание

description

Строка

Строка

Нет

Да

Текстовое описание наряда. Ограничено 15000 символов

scheduled_at

Дата и время

Строка

Нет

Да

Запланированная дата начала наряда

scheduled_duration

Длительность

Объект

Нет

Да

Запланированная длительность

assignee

Исполнитель

Объект

Нет

Да

Исполнитель — пользователь или бригада

possible_resolutions

[Резолюция]

Массив

Нет

Нет

Список возможных резолюций. Если передан, должен включать как минимум одну успешную и одну неуспешную резолюцию

address

Адрес

Объект

Нет

Нет

Адрес

contacts

[Контакт]

Массив

Нет

Нет

Список контактов

client

Клиент

Объект

Нет

Да

Клиент

site

Объект

Объект

Нет

Да

Объект

territory

Участок

Объект

Нет

Да

Участок

skills

[Навык]

Массив

Нет

Нет

Навыки, необходимые для выполнения наряда

custom_fields

[Доп. поле]

Массив

Нет

Нет

Значения дополнительных полей наряда

report_fields

[Доп. поле]

Массив

Нет

Нет

Значения полей отчета наряда

Некоторые поля, например, possible_resolutions и assignee, нельзя обновлять у начатого наряда.

Обновление и добавление полей

Примеры изменения полей.