Новое напоминание
Создаёт напоминание и назначает на него ответственных.
При создании напоминания обязательно указать его тип: звонок, встреча, простое напоминание, событие или письмо. Описание при этом не требуется — напоминание создастся с текстом по типу. Если описание передано, именно оно и станет текстом напоминания.
У напоминания должны быть ответственные. Если их не указать, ответственным становится владелец токена.
Ответственным для напоминания без привязки к каким-либо сущностям может стать любой сотрудник компании. Актуальный состав сотрудников компании вы можете получить в методе [Список сотрудников](GET /users). Ответственные, которых вызывающий не видит, молча отбрасываются: ответ приходит успешным, а в performer_ids их нет, поэтому сверяйте состав в ответе.
Напоминание можно привязать к беседе полем chat_id — тогда кроме автора и ответственных его видят участники этой беседы. Привязывающий должен сам в ней состоять. В канале, в треде и в архивном чате напоминания не создаются.
Передать напоминание другому сотруднику — значит сменить ответственного методом [Редактирование напоминания](PUT /tasks/{id}).
Если к пространству или к профилю подключён календарь, напоминание заодно появляется в нём событием.
Request
- Base URL: https://api.pachca.com/api/shared/v1
- URL: https://api.pachca.com/api/shared/v1/tasks
- Auth: HTTP bearer
Request body
Example request
{
"task": {
"content": "Забрать со склада 21 заказ",
"due_at": "2020-06-05T12:00:00.000+03:00",
"priority": 2,
"performer_ids": [
12,
13
],
"chat_id": 456,
"custom_properties": [
{
"id": 78,
"value": "Синий склад"
}
]
}
}Response
The request has succeeded and a new resource has been created as a result.
Example response
{
"data": {
"id": 22283,
"content": "Забрать со склада 21 заказ",
"due_at": "2020-06-05T09:00:00.000Z",
"priority": 2,
"user_id": 12,
"chat_id": 334,
"created_at": "2020-06-04T10:37:57.000Z",
"performer_ids": [
12
],
"custom_properties": [
{
"id": 1678,
"name": "Город",
"value": "Санкт-Петербург"
}
]
}
}Changes
No recorded changes to this operation across all 1 revision of this API.