• 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>