Update a to do task of a user
patch
/fscmRestApi/resources/11.13.18.05/projectsUsers/{ResourceId}/child/ToDoTasks/{ToDoTasksUniqID}
Request
Path Parameters
-
ResourceId(required): integer(int64)
The unique identifier of the resource assigned to the task.
-
ToDoTasksUniqID(required): string
This is the hash key of the attributes which make up the composite key for the To Do Tasks resource and used to uniquely identify an instance of To Do Tasks. The client should not generate the hash key value. Instead, the client should query on the To Do Tasks collection resource in order to navigate to a specific instance of To Do Tasks to get the hash key.
Header Parameters
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
ElementType: string
Maximum Length:
30
The element type of the task. -
ElementVersionId: integer
(int64)
The unique identifier of the element version of the task.
-
ObjectType: string
Maximum Length:
30
Default Value:PJF_TASKS
The object type of the task. - OsnSharedTaskFlag: boolean
-
PlanLineId: integer
(int64)
The unique identifier of the plan line of the to do task.
-
TaskDescription: string
Title:
Description
Maximum Length:2000
The description of the task. -
TaskName: string
Title:
Task Name
Maximum Length:255
The name of the task. -
TaskPlannedFinishDate: string
(date)
Title:
Finish Date
The date when the task ends. -
TaskPlannedStartDate: string
(date)
Title:
Start Date
The date when the task starts. -
TaskPriority: number
Title:
Priority
The priority of the task. -
TaskProgressEnteredDate: string
(date)
The date when progress on a task was last entered.
-
TaskProgressStatusCode: string
Maximum Length:
20
The Code of progress status of the task. -
ToDoTaskFollowers: array
To Do Task Followers
Title:
To Do Task Followers
The to do task follower resource is used to store values while adding or removing followers on to do tasks.
Nested Schema : To Do Task Followers
Type:
array
Title:
To Do Task Followers
The to do task follower resource is used to store values while adding or removing followers on to do tasks.
Show Source
Nested Schema : projectsUsers-ToDoTasks-ToDoTaskFollowers-item-patch-request
Type:
Show Source
object
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context(required):
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version(required):
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : projectsUsers-ToDoTasks-item-response
Type:
Show Source
object
-
CreatedBy: string
Read Only:
true
Maximum Length:64
The unique identifier of the user who created the task. -
CreationDate: string
(date-time)
Read Only:
true
The date when the task is created. -
ElementType: string
Maximum Length:
30
The element type of the task. -
ElementVersionId: integer
(int64)
The unique identifier of the element version of the task.
-
LastUpdateDate: string
(date-time)
Title:
Last Updated Date
Read Only:true
The date when the task is last updated. -
LastUpdatedBy: string
Read Only:
true
Maximum Length:64
The unique identifier of the user who last updated the task. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
ObjectType: string
Maximum Length:
30
Default Value:PJF_TASKS
The object type of the task. - OsnSharedTaskFlag: boolean
-
PlanLineId: integer
(int64)
The unique identifier of the plan line of the to do task.
-
ProjElementId: integer
(int64)
Read Only:
true
The unique identifier of the project element of the task. -
TaskDescription: string
Title:
Description
Maximum Length:2000
The description of the task. -
TaskId: integer
(int64)
Read Only:
true
The unique identifier of the task. -
TaskName: string
Title:
Task Name
Maximum Length:255
The name of the task. -
TaskPlannedFinishDate: string
(date)
Title:
Finish Date
The date when the task ends. -
TaskPlannedStartDate: string
(date)
Title:
Start Date
The date when the task starts. -
TaskPriority: number
Title:
Priority
The priority of the task. -
TaskProgressEnteredDate: string
(date)
The date when progress on a task was last entered.
-
TaskProgressStatus: string
Read Only:
true
Maximum Length:80
The status of work completed on the task. -
TaskProgressStatusCode: string
Maximum Length:
20
The Code of progress status of the task. -
ToDoTaskFollowers: array
To Do Task Followers
Title:
To Do Task Followers
The to do task follower resource is used to store values while adding or removing followers on to do tasks.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : To Do Task Followers
Type:
array
Title:
To Do Task Followers
The to do task follower resource is used to store values while adding or removing followers on to do tasks.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : projectsUsers-ToDoTasks-ToDoTaskFollowers-item-response
Type:
Show Source
object
-
DisplayName: string
Title:
Name
Read Only:true
Maximum Length:240
The name of projects user. -
ElementVersionId: integer
(int64)
Read Only:
true
The unique identifier of the element version of the task. -
Email: string
Title:
Email
Read Only:true
Maximum Length:240
The e-mail address of the resource. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
Phone: string
Title:
Phone
Read Only:true
Maximum Length:240
The telephone number of the projects user. -
ResourceId: integer
(int64)
Read Only:
true
Unique identifier of the resource assigned to the task. -
TaskFollowerId: integer
(int64)
Read Only:
true
The unique identifier of the task follower.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Links
- ToDoTaskFollowers
-
Parameters:
- ResourceId:
$request.path.ResourceId
- ToDoTasksUniqID:
$request.path.ToDoTasksUniqID
The to do task follower resource is used to store values while adding or removing followers on to do tasks. - ResourceId:
Examples
The following example shows how to update a project task by submitting a PATCH request on the REST resource using cURL.
curl -i -u "<username>:<password>" -X PATCH https://<host>:<port>/fscmRestApi/resources/latest/projectsUsers/<ResourceId>/child/ToDoTasks/<ToDoTasksUniqID>
Example of Request Header
The following shows an example of the request header.
{ "TaskPriority":1, "TaskDescription": "Updated Task" }
Example of Response Body
The following example shows the contents of the response body in JSON format.
{ "TaskName" : "Finish FDD", "ProjElementId" : 300100090309803, "ObjectType" : "PJF_TASKS", "ElementType" : "TODO", "TaskDescription" : "Updated Task", "TaskPlannedFinishDate" : "2016-12-16", "TaskPlannedStartDate" : null, "TaskProgressStatusCode" : "NOT_STARTED", "TaskProgressEnteredDate" : "2017-01-09", "TaskPriority" : 1, "TaskProgressStatus" : "Not started", "ElementVersionId" : 300100090309801, "TaskId" : 300100090309803, "CreatedBy" : "Connor.Horton", "CreationDate" : "2016-12-14T16:13:39-08:00", "LastUpdateDate" : "2017-01-09T09:43:08-08:00", "LastUpdatedBy" : "Connor.Horton", "links" : [ { "rel" : "self", "href" : "https://servername/projectsManagementApi/resources/11.1.13/projectsUsers/300100024326655/child/ToDoTasks/00040000000EACED00057708000110F07F47ACAB0000000EACED00057708000110F07F47ACAA0000000EACED00057708000110F07F47ACA90000000EACED00057708000110F07F47ACAC", "name" : "ToDoTasks", "kind" : "item", "properties" : { ... }