Запись опубликована:10.10.2022
Post category:Задачи
Запись изменена:03.11.2022

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>