PUT api/2.0/crm/task/{taskid}
Важно
Для этой функции требуется аутентификация.
Описание
Обновляет выбранную задачу с параметрами (название, описание, срок выполнения и т.д.), указанными в запросе.
Параметры
| Название | Описание | Тип | Пример |
| taskid sent in url |
Идентификатор задачи | номер | 1234 |
| title sent in body |
Новое название задачи | строковый | текст |
| description sent in body |
Новое описание задачи | строковый | текст |
| deadline sent in body |
Новый срок выполнения задачи | дата и время | Roundtrip format: 2008-04-10T06-30-00.000Z |
| responsibleid sent in body |
Новый идентификатор ответственного за выполнение задачи | guid | 9924256A-739C-462b-AF15-E652A3B1B6EB |
| categoryid sent in body |
Новый идентификатор категории задач | номер | 1234 |
| contactid sent in body |
Новый идентификатор контакта | номер | 1234 |
| entityType sent in body |
Новый тип связанной сущности Допустимые значения: opportunity or case |
строковый | текст |
| entityid sent in body |
Новый идентификатор связанной сущности | номер | 1234 |
| isNotify sent in body |
Уведомляет ответственного о задаче | логический | истина |
| alertValue sent in body |
Новый период времени в минутах, чтобы напомнить ответственному о задаче Необязательно |
номер | 1234 |
Пример
PUT api/2.0/crm/task/1234
Host: yourportal.r7-office.ru
Content-Type: application/json
Accept: application/json
{
"title": "some text",
"description": "some text",
"deadline": "2008-04-10T06-30-00.000Z",
"responsibleid": "9924256A-739C-462b-AF15-E652A3B1B6EB",
"categoryid": 1234,
"contactid": 1234,
"entityType": "some text",
"entityid": 1234,
"isNotify": true,
"alertValue": 1234
}
Возвращает
Задача.
Пример ответа
application/json
{
"status": 0,
"response": {
"createBy": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "Mike Zanyatski",
"title": "Manager",
"avatarSmall": "url to small avatar",
"profileUrl": ""
},
"created": "2022-10-09T20:03:09.6137431Z",
"title": "Send a commercial offer",
"deadLine": "2022-10-09T20:03:09.6137431Z",
"responsible": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "Mike Zanyatski",
"title": "Manager",
"avatarSmall": "url to small avatar",
"profileUrl": ""
},
"category": {
"imagePath": "path to image",
"title": "Appointment",
"description": "",
"sortOrder": 2,
"id": 30
},
"canEdit": true,
"id": 0
}
}
text/xml
<result>
<status>0</status>
<response>
<createBy>
<id>00000000-0000-0000-0000-000000000000</id>
<displayName>Mike Zanyatski</displayName>
<title>Manager</title>
<avatarSmall>url to small avatar</avatarSmall>
<profileUrl></profileUrl>
</createBy>
<created>2022-10-09T20:03:09.6137431Z</created>
<title>Send a commercial offer</title>
<deadLine>2022-10-09T20:03:09.6137431Z</deadLine>
<responsible>
<id>00000000-0000-0000-0000-000000000000</id>
<displayName>Mike Zanyatski</displayName>
<title>Manager</title>
<avatarSmall>url to small avatar</avatarSmall>
<profileUrl></profileUrl>
</responsible>
<category>
<imagePath>path to image</imagePath>
<title>Appointment</title>
<description></description>
<sortOrder>2</sortOrder>
<id>30</id>
</category>
<canEdit>true</canEdit>
<id>0</id>
</response>
</result>
