Tasks

Новое напоминание

Создаёт напоминание и назначает на него ответственных.

При создании напоминания обязательно указать его тип: звонок, встреча, простое напоминание, событие или письмо. Описание при этом не требуется — напоминание создастся с текстом по типу. Если описание передано, именно оно и станет текстом напоминания.

У напоминания должны быть ответственные. Если их не указать, ответственным становится владелец токена.

Ответственным для напоминания без привязки к каким-либо сущностям может стать любой сотрудник компании. Актуальный состав сотрудников компании вы можете получить в методе [Список сотрудников](GET /users). Ответственные, которых вызывающий не видит, молча отбрасываются: ответ приходит успешным, а в performer_ids их нет, поэтому сверяйте состав в ответе.

Напоминание можно привязать к беседе полем chat_id — тогда кроме автора и ответственных его видят участники этой беседы. Привязывающий должен сам в ней состоять. В канале, в треде и в архивном чате напоминания не создаются.

Передать напоминание другому сотруднику — значит сменить ответственного методом [Редактирование напоминания](PUT /tasks/{id}).

Если к пространству или к профилю подключён календарь, напоминание заодно появляется в нём событием.

post/tasks

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.