Меняет напоминание: перезаписываются только переданные поля.
Передать напоминание другому сотруднику — это тоже правка: добавьте его в performer_ids вместо прежнего.
Выполненное напоминание закрывают этим же методом: status: "done" ставит галочку и оставляет напоминание в списке, status: "undone" возвращает его в работу.
Доступно автору и ответственным. Участник чата, где висит напоминание, его видит, но менять не может. Привязку к чату изменить нельзя: чтобы перевесить напоминание в другой чат, удалите его и создайте заново с нужным chat_id.
Параметры пути
id
integer, (int32)
*Идентификатор напоминания
Пример:
22283Тело запроса
application/jsontask
object
*Собранный объект параметров обновляемого напоминания
kind
string
Тип
Возможные значения
Пример:
remindercontent
string
Описание. До 40 000 байт в UTF-8.
Пример:
Забрать со склада 21 заказdue_at
string, (date-time)
Срок выполнения напоминания (ISO-8601). Смещение вида
+03:00 учитывается, время без смещения считается UTC. Секунды отбрасываются: срок встаёт на начало минуты. Исключение — ровно 23:59:59: такое напоминание создаётся на весь день, без указания времени.Пример:
2020-06-05T12:00:00.000+03:00priority
integer, (int32)
Приоритет: 1, 2 (важно) или 3 (очень важно)
Пример:
2Диапазон:
1 — 3performer_ids[]
array of integers, (int32)
Массив идентификаторов пользователей, привязываемых к напоминанию как «ответственные»
Пример:
[12]status
string
Статус
Возможные значения
Пример:
doneall_day
boolean
Напоминание на весь день (без указания времени)
Пример:
falsedone_at
string, (date-time)
Дата и время выполнения напоминания (ISO-8601). Смещение вида
+03:00 учитывается, время без смещения считается UTC. Значение, которое не удалось разобрать, отметку о выполнении снимает: ответ придёт успешный, а в нём done_at будет null.Пример:
2020-06-05T12:00:00.000Zcustom_properties[]
array of objects
Задаваемые дополнительные поля
id
integer, (int32)
*Идентификатор поля
Пример:
78value
string
*Устанавливаемое значение
Пример:
Синий складОтвет
200OK
The request has succeeded.
data
object
*Напоминание
id
integer, (int32)
*Идентификатор напоминания
Пример:
22283kind
string
*Тип
Возможные значения
Пример:
remindercontent
string
*Описание
Пример:
Забрать со склада 21 заказdue_at
nullablestring, (date-time)
*Срок выполнения напоминания (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ.
null, если срок не задан.Пример:
2020-06-05T09:00:00.000Zpriority
integer, (int32)
*Приоритет
Пример:
2user_id
integer, (int32)
*Идентификатор пользователя-создателя напоминания
Пример:
12chat_id
nullableinteger, (int32)
*Идентификатор чата, к которому привязано напоминание.
null, если напоминание не привязано к чату.Пример:
334status
string
*Статус напоминания
Возможные значения
Пример:
undonecreated_at
string, (date-time)
*Дата и время создания напоминания (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
Пример:
2020-06-04T10:37:57.000Zperformer_ids[]
array of integers, (int32)
*Массив идентификаторов пользователей, привязанных к напоминанию как «ответственные»
Пример:
[12]all_day
boolean
*Напоминание на весь день (без указания времени)
Пример:
falsecustom_properties[]
array of objects
*Дополнительные поля напоминания
id
integer, (int32)
*Идентификатор поля
Пример:
1678name
string
*Название поля
Пример:
ГородДлина:
<= 32 символовdata_type
string
*Тип поля
Возможные значения
Пример:
stringvalue
nullablestring
*Значение. Возвращается
null, если поле не заполнено. Число передаётся строкой, дата — в формате ISO 8601.Пример:
Санкт-ПетербургДлина:
<= 768 символов