PUT api/2.0/project/task/{taskid} This function requires authentication

Description

Updates the selected task with the parameters (responsible user ID, task description, deadline time, etc) specified in the request.

Parameters
Name Description Type Example
taskid
sent in url
Task ID number 1234
description
sent in body
New task description string some text
deadline
sent in body
New task deadline time Date and Time Roundtrip format: 2008-04-10T06-30-00.000Z
startDate
sent in body
New task start date Date and Time Roundtrip format: 2008-04-10T06-30-00.000Z
priority
sent in body
New task priority
optional
High = 1, Normal = 0, Low = -1 Normal
title
sent in body
New task title string some text
milestoneid
sent in body
New task milestone ID number 1234
responsibles
sent in body
New list of task responsibles Collection of guids
collection
9924256A-739C-462b-AF15-E652A3B1B6EB
projectID
sent in body
New task project ID
optional
number 1234
notify
sent in body
Specifies whether to notify responsibles about the task actions or not Bool value true
status
sent in body
New task status
optional
NotAccept = 0,Open = 1, Closed = 2,Disable = 3,Unclassified = 4,NotInMilestone = 5 NotAccept
progress
sent in body
New task progress
optional
number 1234
Example
PUT api/2.0/project/task/1234
Host: yourportal.onlyoffice.com
Content-Type: application/json
Accept: application/json

{
  "description": "some text",
  "deadline": "2008-04-10T06-30-00.000Z",
  "startDate": "2008-04-10T06-30-00.000Z",
  "priority": "Normal",
  "title": "some text",
  "milestoneid": 1234,
  "responsibles": [
    "9924256A-739C-462b-AF15-E652A3B1B6EB"
  ],
  "projectID": 1234,
  "notify": true,
  "status": "NotAccept",
  "progress": 1234
}
Returns

Updated task

Example Response

application/json

{
  "status": 0,
  "response": {
    "Id": 10,
    "Title": "Sample Title",
    "Description": "Sample description",
    "Deadline": "2020-12-22T04:11:56.5768573Z",
    "Priority": 1,
    "MilestoneId": 123,
    "ProjectOwner": {
      "Id": "123",
      "Title": "Sample project",
      "Status": 0,
      "IsPrivate": false
    },
    "Progress": 55,
    "Status": 0,
    "Subtasks": [
      {
        "Id": 10,
        "Title": "Sample Title",
        "Description": "Sample description",
        "Status": 0,
        "Responsible": {
          "Id": "00000000-0000-0000-0000-000000000000",
          "DisplayName": "Mike Zanyatski",
          "Title": "Manager",
          "AvatarSmall": "url to small avatar",
          "ProfileUrl": "\\/Products\\/People\\/Profile.aspx?user=administrator"
        },
        "ResponsibleId": "00000000-0000-0000-0000-000000000000",
        "UpdatedBy": {
          "Id": "00000000-0000-0000-0000-000000000000",
          "DisplayName": "Mike Zanyatski",
          "Title": "Manager",
          "AvatarSmall": "url to small avatar",
          "ProfileUrl": "\\/Products\\/People\\/Profile.aspx?user=administrator"
        },
        "UpdatedById": "00000000-0000-0000-0000-000000000000",
        "Created": "2020-12-22T04:11:56.5658524Z",
        "CreatedBy": {
          "Id": "00000000-0000-0000-0000-000000000000",
          "DisplayName": "Mike Zanyatski",
          "Title": "Manager",
          "AvatarSmall": "url to small avatar",
          "ProfileUrl": "\\/Products\\/People\\/Profile.aspx?user=administrator"
        },
        "CreatedById": "00000000-0000-0000-0000-000000000000",
        "Updated": "2020-12-22T04:11:56.5658524Z",
        "CanEdit": false,
        "TaskId": 1234
      }
    ],
    "Links": [
      {
        "DependenceTaskId": "123",
        "ParentTaskId": "44",
        "LinkType": "1"
      }
    ],
    "Responsible": {
      "Id": "00000000-0000-0000-0000-000000000000",
      "DisplayName": "Mike Zanyatski",
      "Title": "Manager",
      "AvatarSmall": "url to small avatar",
      "ProfileUrl": "\\/Products\\/People\\/Profile.aspx?user=administrator"
    },
    "ResponsibleId": "00000000-0000-0000-0000-000000000000",
    "UpdatedBy": {
      "Id": "00000000-0000-0000-0000-000000000000",
      "DisplayName": "Mike Zanyatski",
      "Title": "Manager",
      "AvatarSmall": "url to small avatar",
      "ProfileUrl": "\\/Products\\/People\\/Profile.aspx?user=administrator"
    },
    "UpdatedById": "00000000-0000-0000-0000-000000000000",
    "Created": "2020-12-22T04:11:56.5658524Z",
    "CreatedBy": {
      "Id": "00000000-0000-0000-0000-000000000000",
      "DisplayName": "Mike Zanyatski",
      "Title": "Manager",
      "AvatarSmall": "url to small avatar",
      "ProfileUrl": "\\/Products\\/People\\/Profile.aspx?user=administrator"
    },
    "CreatedById": "00000000-0000-0000-0000-000000000000",
    "Updated": "2020-12-22T04:11:56.5658524Z",
    "Responsibles": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "DisplayName": "Mike Zanyatski",
        "Title": "Manager",
        "AvatarSmall": "url to small avatar",
        "ProfileUrl": "\\/Products\\/People\\/Profile.aspx?user=administrator"
      }
    ],
    "ResponsibleIds": [
      "00000000-0000-0000-0000-000000000000"
    ],
    "Milestone": {
      "Id": 123,
      "Title": "Title",
      "Deadline": "2020-12-22T04:11:56.5768573Z"
    },
    "CustomTaskStatus": 1,
    "Files": [
      {
        "RootFolderType": 2,
        "UpdatedBy": {
          "Id": "00000000-0000-0000-0000-000000000000",
          "DisplayName": "Mike Zanyatski",
          "Title": "Manager",
          "AvatarSmall": "url to small avatar",
          "ProfileUrl": "\\/Products\\/People\\/Profile.aspx?user=administrator"
        },
        "Created": "2020-12-13T17:13:31.5902727Z",
        "CreatedBy": {
          "Id": "00000000-0000-0000-0000-000000000000",
          "DisplayName": "Mike Zanyatski",
          "Title": "Manager",
          "AvatarSmall": "url to small avatar",
          "ProfileUrl": "\\/Products\\/People\\/Profile.aspx?user=administrator"
        },
        "Updated": "2020-12-13T17:13:31.5902727Z",
        "ProviderItem": true,
        "ProviderKey": "1234d",
        "ProviderId": 1234,
        "FolderId": 12334,
        "Version": 3,
        "VersionGroup": 1,
        "ContentLength": "12.06 KB",
        "PureContentLength": 12345,
        "FileStatus": 2,
        "ViewUrl": "http:\\/\\/www.onlyoffice.com\\/viewfile?fileid=2221",
        "WebUrl": "http:\\/\\/www.onlyoffice.com\\/viewfile?fileid=2221",
        "FileType": 7,
        "FileExst": ".txt",
        "Comment": null,
        "Encrypted": true,
        "Id": 857864274,
        "Title": "Some titile.txt",
        "Access": 1,
        "Shared": false
      }
    ],
    "Comments": [
      {
        "commentID": "12261949-db62-43c2-b956-91e12c412d5a",
        "userID": "15985c13-ad91-4f2c-9286-cf991448e796",
        "userPost": null,
        "userFullName": "Administrator",
        "userProfileLink": "\\/Products\\/People\\/Profile.aspx?user=administrator",
        "userAvatarPath": "\\/skins\\/default\\/images\\/default_user_photo_size_82-82.png",
        "commentBody": "das\\u000a",
        "inactive": false,
        "isRead": true,
        "isEditPermissions": true,
        "isResponsePermissions": true,
        "timeStampStr": "15:39 Today",
        "commentList": null,
        "attachments": null
      }
    ],
    "CommentsCount": 1,
    "IsSubscribed": false,
    "CanEditFiles": false,
    "CanCreateComment": false,
    "Project": {
      "Id": 10,
      "Title": "Sample Title",
      "Description": "Sample description",
      "Status": 0,
      "Responsible": {
        "Id": "00000000-0000-0000-0000-000000000000",
        "DisplayName": "Mike Zanyatski",
        "Title": "Manager",
        "AvatarSmall": "url to small avatar",
        "ProfileUrl": "\\/Products\\/People\\/Profile.aspx?user=administrator"
      },
      "ResponsibleId": "00000000-0000-0000-0000-000000000000",
      "IsPrivate": false,
      "TaskCount": 0,
      "TaskCountTotal": 0,
      "MilestoneCount": 0,
      "DiscussionCount": 0,
      "ParticipantCount": 0,
      "TimeTrackingTotal": "TimeTrackingTotal",
      "DocumentsCount": 0,
      "IsFollow": 0,
      "Tags": [
        "Tags1",
        "Tags2"
      ],
      "UpdatedBy": {
        "Id": "00000000-0000-0000-0000-000000000000",
        "DisplayName": "Mike Zanyatski",
        "Title": "Manager",
        "AvatarSmall": "url to small avatar",
        "ProfileUrl": "\\/Products\\/People\\/Profile.aspx?user=administrator"
      },
      "UpdatedById": "00000000-0000-0000-0000-000000000000",
      "Created": "2020-12-22T04:11:56.5658524Z",
      "CreatedBy": {
        "Id": "00000000-0000-0000-0000-000000000000",
        "DisplayName": "Mike Zanyatski",
        "Title": "Manager",
        "AvatarSmall": "url to small avatar",
        "ProfileUrl": "\\/Products\\/People\\/Profile.aspx?user=administrator"
      },
      "CreatedById": "00000000-0000-0000-0000-000000000000",
      "Updated": "2020-12-22T04:11:56.5658524Z",
      "CanEdit": false,
      "CanDelete": false,
      "Security": {
        "CanCreateMilestone": false,
        "CanCreateMessage": false,
        "CanCreateTask": false,
        "CanCreateTimeSpend": false,
        "CanEditTeam": false,
        "CanReadFiles": false,
        "CanReadMilestones": false,
        "CanReadMessages": false,
        "CanReadTasks": false,
        "CanLinkContact": false,
        "CanReadContacts": false,
        "CanEdit": false,
        "CanDelete": false,
        "IsInTeam": false
      },
      "ProjectFolder": 13234
    },
    "TimeSpend": 35.0,
    "CanEdit": false,
    "CanCreateSubtask": false,
    "CanCreateTimeSpend": false,
    "CanDelete": false,
    "CanReadFiles": false,
    "StartDate": "2020-12-22T04:11:56.5768573Z"
  }
}

text/xml

<result>
  <status>0</status>
  <response>
    <Id>10</Id>
    <Title>Sample Title</Title>
    <Description>Sample description</Description>
    <Deadline>2020-12-22T04:11:56.5768573Z</Deadline>
    <Priority>1</Priority>
    <MilestoneId>123</MilestoneId>
    <ProjectOwner>
      <Id>123</Id>
      <Title>Sample project</Title>
      <Status>0</Status>
      <IsPrivate>False</IsPrivate>
    </ProjectOwner>
    <Progress>55</Progress>
    <Status>0</Status>
    <Subtasks>
      <Id>10</Id>
      <Title>Sample Title</Title>
      <Description>Sample description</Description>
      <Status>0</Status>
      <Responsible>
        <Id>00000000-0000-0000-0000-000000000000</Id>
        <DisplayName>Mike Zanyatski</DisplayName>
        <Title>Manager</Title>
        <AvatarSmall>url to small avatar</AvatarSmall>
        <ProfileUrl>\/Products\/People\/Profile.aspx?user=administrator</ProfileUrl>
      </Responsible>
      <ResponsibleId>00000000-0000-0000-0000-000000000000</ResponsibleId>
      <UpdatedBy>
        <Id>00000000-0000-0000-0000-000000000000</Id>
        <DisplayName>Mike Zanyatski</DisplayName>
        <Title>Manager</Title>
        <AvatarSmall>url to small avatar</AvatarSmall>
        <ProfileUrl>\/Products\/People\/Profile.aspx?user=administrator</ProfileUrl>
      </UpdatedBy>
      <UpdatedById>00000000-0000-0000-0000-000000000000</UpdatedById>
      <Created>2020-12-22T04:11:56.5658524Z</Created>
      <CreatedBy>
        <Id>00000000-0000-0000-0000-000000000000</Id>
        <DisplayName>Mike Zanyatski</DisplayName>
        <Title>Manager</Title>
        <AvatarSmall>url to small avatar</AvatarSmall>
        <ProfileUrl>\/Products\/People\/Profile.aspx?user=administrator</ProfileUrl>
      </CreatedBy>
      <CreatedById>00000000-0000-0000-0000-000000000000</CreatedById>
      <Updated>2020-12-22T04:11:56.5658524Z</Updated>
      <CanEdit>False</CanEdit>
      <TaskId>1234</TaskId>
    </Subtasks>
    <Links>
      <DependenceTaskId>123</DependenceTaskId>
      <ParentTaskId>44</ParentTaskId>
      <LinkType>1</LinkType>
    </Links>
    <Responsible>
      <Id>00000000-0000-0000-0000-000000000000</Id>
      <DisplayName>Mike Zanyatski</DisplayName>
      <Title>Manager</Title>
      <AvatarSmall>url to small avatar</AvatarSmall>
      <ProfileUrl>\/Products\/People\/Profile.aspx?user=administrator</ProfileUrl>
    </Responsible>
    <ResponsibleId>00000000-0000-0000-0000-000000000000</ResponsibleId>
    <UpdatedBy>
      <Id>00000000-0000-0000-0000-000000000000</Id>
      <DisplayName>Mike Zanyatski</DisplayName>
      <Title>Manager</Title>
      <AvatarSmall>url to small avatar</AvatarSmall>
      <ProfileUrl>\/Products\/People\/Profile.aspx?user=administrator</ProfileUrl>
    </UpdatedBy>
    <UpdatedById>00000000-0000-0000-0000-000000000000</UpdatedById>
    <Created>2020-12-22T04:11:56.5658524Z</Created>
    <CreatedBy>
      <Id>00000000-0000-0000-0000-000000000000</Id>
      <DisplayName>Mike Zanyatski</DisplayName>
      <Title>Manager</Title>
      <AvatarSmall>url to small avatar</AvatarSmall>
      <ProfileUrl>\/Products\/People\/Profile.aspx?user=administrator</ProfileUrl>
    </CreatedBy>
    <CreatedById>00000000-0000-0000-0000-000000000000</CreatedById>
    <Updated>2020-12-22T04:11:56.5658524Z</Updated>
    <Responsibles>
      <Id>00000000-0000-0000-0000-000000000000</Id>
      <DisplayName>Mike Zanyatski</DisplayName>
      <Title>Manager</Title>
      <AvatarSmall>url to small avatar</AvatarSmall>
      <ProfileUrl>\/Products\/People\/Profile.aspx?user=administrator</ProfileUrl>
    </Responsibles>
    <ResponsibleIds>00000000-0000-0000-0000-000000000000</ResponsibleIds>
    <Milestone>
      <Id>123</Id>
      <Title>Title</Title>
      <Deadline>2020-12-22T04:11:56.5768573Z</Deadline>
    </Milestone>
    <CustomTaskStatus>1</CustomTaskStatus>
    <Files>
      <RootFolderType>2</RootFolderType>
      <UpdatedBy>
        <Id>00000000-0000-0000-0000-000000000000</Id>
        <DisplayName>Mike Zanyatski</DisplayName>
        <Title>Manager</Title>
        <AvatarSmall>url to small avatar</AvatarSmall>
        <ProfileUrl>\/Products\/People\/Profile.aspx?user=administrator</ProfileUrl>
      </UpdatedBy>
      <Created>2020-12-13T17:13:31.5902727Z</Created>
      <CreatedBy>
        <Id>00000000-0000-0000-0000-000000000000</Id>
        <DisplayName>Mike Zanyatski</DisplayName>
        <Title>Manager</Title>
        <AvatarSmall>url to small avatar</AvatarSmall>
        <ProfileUrl>\/Products\/People\/Profile.aspx?user=administrator</ProfileUrl>
      </CreatedBy>
      <Updated>2020-12-13T17:13:31.5902727Z</Updated>
      <ProviderItem>True</ProviderItem>
      <ProviderKey>1234d</ProviderKey>
      <ProviderId>1234</ProviderId>
      <FolderId>12334</FolderId>
      <Version>3</Version>
      <VersionGroup>1</VersionGroup>
      <ContentLength>12.06 KB</ContentLength>
      <PureContentLength>12345</PureContentLength>
      <FileStatus>2</FileStatus>
      <ViewUrl>http:\/\/www.onlyoffice.com\/viewfile?fileid=2221</ViewUrl>
      <WebUrl>http:\/\/www.onlyoffice.com\/viewfile?fileid=2221</WebUrl>
      <FileType>7</FileType>
      <FileExst>.txt</FileExst>
      <Comment />
      <Encrypted>True</Encrypted>
      <Id>857864274</Id>
      <Title>Some titile.txt</Title>
      <Access>1</Access>
      <Shared>False</Shared>
    </Files>
    <Comments>
      <commentID>12261949-db62-43c2-b956-91e12c412d5a</commentID>
      <userID>15985c13-ad91-4f2c-9286-cf991448e796</userID>
      <userPost />
      <userFullName>Administrator</userFullName>
      <userProfileLink>\/Products\/People\/Profile.aspx?user=administrator</userProfileLink>
      <userAvatarPath>\/skins\/default\/images\/default_user_photo_size_82-82.png</userAvatarPath>
      <commentBody>das\u000a</commentBody>
      <inactive>False</inactive>
      <isRead>True</isRead>
      <isEditPermissions>True</isEditPermissions>
      <isResponsePermissions>True</isResponsePermissions>
      <timeStampStr>15:39 Today</timeStampStr>
      <commentList />
      <attachments />
    </Comments>
    <CommentsCount>1</CommentsCount>
    <IsSubscribed>False</IsSubscribed>
    <CanEditFiles>False</CanEditFiles>
    <CanCreateComment>False</CanCreateComment>
    <Project>
      <Id>10</Id>
      <Title>Sample Title</Title>
      <Description>Sample description</Description>
      <Status>0</Status>
      <Responsible>
        <Id>00000000-0000-0000-0000-000000000000</Id>
        <DisplayName>Mike Zanyatski</DisplayName>
        <Title>Manager</Title>
        <AvatarSmall>url to small avatar</AvatarSmall>
        <ProfileUrl>\/Products\/People\/Profile.aspx?user=administrator</ProfileUrl>
      </Responsible>
      <ResponsibleId>00000000-0000-0000-0000-000000000000</ResponsibleId>
      <IsPrivate>False</IsPrivate>
      <TaskCount>0</TaskCount>
      <TaskCountTotal>0</TaskCountTotal>
      <MilestoneCount>0</MilestoneCount>
      <DiscussionCount>0</DiscussionCount>
      <ParticipantCount>0</ParticipantCount>
      <TimeTrackingTotal>TimeTrackingTotal</TimeTrackingTotal>
      <DocumentsCount>0</DocumentsCount>
      <IsFollow>0</IsFollow>
      <Tags>Tags1</Tags>
      <Tags>Tags2</Tags>
      <UpdatedBy>
        <Id>00000000-0000-0000-0000-000000000000</Id>
        <DisplayName>Mike Zanyatski</DisplayName>
        <Title>Manager</Title>
        <AvatarSmall>url to small avatar</AvatarSmall>
        <ProfileUrl>\/Products\/People\/Profile.aspx?user=administrator</ProfileUrl>
      </UpdatedBy>
      <UpdatedById>00000000-0000-0000-0000-000000000000</UpdatedById>
      <Created>2020-12-22T04:11:56.5658524Z</Created>
      <CreatedBy>
        <Id>00000000-0000-0000-0000-000000000000</Id>
        <DisplayName>Mike Zanyatski</DisplayName>
        <Title>Manager</Title>
        <AvatarSmall>url to small avatar</AvatarSmall>
        <ProfileUrl>\/Products\/People\/Profile.aspx?user=administrator</ProfileUrl>
      </CreatedBy>
      <CreatedById>00000000-0000-0000-0000-000000000000</CreatedById>
      <Updated>2020-12-22T04:11:56.5658524Z</Updated>
      <CanEdit>False</CanEdit>
      <CanDelete>False</CanDelete>
      <Security>
        <CanCreateMilestone>False</CanCreateMilestone>
        <CanCreateMessage>False</CanCreateMessage>
        <CanCreateTask>False</CanCreateTask>
        <CanCreateTimeSpend>False</CanCreateTimeSpend>
        <CanEditTeam>False</CanEditTeam>
        <CanReadFiles>False</CanReadFiles>
        <CanReadMilestones>False</CanReadMilestones>
        <CanReadMessages>False</CanReadMessages>
        <CanReadTasks>False</CanReadTasks>
        <CanLinkContact>False</CanLinkContact>
        <CanReadContacts>False</CanReadContacts>
        <CanEdit>False</CanEdit>
        <CanDelete>False</CanDelete>
        <IsInTeam>False</IsInTeam>
      </Security>
      <ProjectFolder>13234</ProjectFolder>
    </Project>
    <TimeSpend>35</TimeSpend>
    <CanEdit>False</CanEdit>
    <CanCreateSubtask>False</CanCreateSubtask>
    <CanCreateTimeSpend>False</CanCreateTimeSpend>
    <CanDelete>False</CanDelete>
    <CanReadFiles>False</CanReadFiles>
    <StartDate>2020-12-22T04:11:56.5768573Z</StartDate>
  </response>
</result>