POST api/workplan/{id}/tasks
Add Task
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
Work Plan Id |
globally unique identifier |
Required |
Body Parameters
TasksRequest| Name | Description | Type | Additional information |
|---|---|---|---|
| Name | string |
None. |
|
| Fields | Dictionary of string [key] and Object [value] |
None. |
|
| WorkTypeId | globally unique identifier |
None. |
|
| ParentTaskId | globally unique identifier |
None. |
|
| Integration | TaskIntegrationInfo |
None. |
|
| Assignments | Dictionary of globally unique identifier [key] and decimal number [value] |
None. |
|
| ProcessAssignments | boolean |
None. |
Request Formats
application/json, text/json
Sample:
{
"Name": "sample string 1",
"Fields": {
"sample string 1": {},
"sample string 3": {}
},
"WorkTypeId": "40a6f53b-d6c6-4020-b062-a545d59a449e",
"ParentTaskId": "6ba3020a-a5aa-480f-a0c0-b8268514a5a2",
"Integration": {
"IntegrationId": "59ecf98b-f0d2-45ed-bc0b-8de97fa1f506",
"ExternalItemId": "sample string 2",
"ExternalUrl": "sample string 3",
"ReadOnlyFields": [
"sample string 1",
"sample string 2"
]
},
"Assignments": {
"3cbfdf77-edc8-48d0-9b1f-fb0ff342db3e": 2.0,
"8565599f-24d1-4ed9-a97f-3834ed89178c": 4.0
},
"ProcessAssignments": true
}
Response Information
Resource Description
WorkPlanTask| Name | Description | Type | Additional information |
|---|---|---|---|
| WorkTypeId | globally unique identifier |
None. |
|
| Name | string |
None. |
|
| Created | date |
None. |
|
| Modified | date |
None. |
|
| Author | string |
None. |
|
| Editor | string |
None. |
|
| AssignedTo | Collection of globally unique identifier |
None. |
|
| NonLaborAssignments | Collection of TaskNonLaborAssignment |
None. |
|
| Assignments | Collection of TaskAssignment |
None. |
|
| ParentId | globally unique identifier |
None. |
|
| WorkTypeParentId | globally unique identifier |
None. |
|
| WorkTypeIndex | integer |
None. |
|
| Fields | Dictionary of string [key] and Object [value] |
None. |
|
| Index | integer |
None. |
|
| Complete | boolean |
None. |
|
| Comments | Collection of TaskComment |
None. |
|
| StartDate | date |
None. |
|
| DueDate | date |
None. |
|
| TaskScheduleType | TaskType |
None. |
|
| StatusUpdate | StatusUpdateClass |
None. |
|
| LastComment | date |
None. |
|
| IsScheduled | boolean |
None. |
|
| Integration | TaskIntegrationInfo |
None. |
|
| WorkPlanId | globally unique identifier |
None. |
|
| id | globally unique identifier |
None. |
|
| ConfigId | globally unique identifier |
None. |
Response Formats
application/json, text/json
Sample:
{
"WorkTypeId": "a9f2afcb-6f99-4b2d-baf8-b07c8e8a0b94",
"Name": "sample string 1",
"Created": "2025-12-25T07:18:52.896138+00:00",
"Modified": "2025-12-25T07:18:52.896138+00:00",
"Author": "sample string 4",
"Editor": "sample string 5",
"AssignedTo": [
"3929d500-68f8-46a9-ab77-8c3084a483eb",
"0eb7ea9c-715c-4385-ae0e-f801049e28c8"
],
"NonLaborAssignments": [
{
"Id": "ca9f3e09-b952-4fcb-8336-1e7c38ff6ca4",
"ResourceId": "f160e7e5-ac04-485f-96a8-cb5b7f72c411",
"Quantity": 3.0
},
{
"Id": "ca9f3e09-b952-4fcb-8336-1e7c38ff6ca4",
"ResourceId": "f160e7e5-ac04-485f-96a8-cb5b7f72c411",
"Quantity": 3.0
}
],
"Assignments": [
{
"Id": "6bb95e9c-ed3b-4674-8e70-f03db98980a7",
"Type": 0,
"ResourceId": "4fbf4752-1db5-4890-8bf5-57970712f61a",
"Units": 3.0
},
{
"Id": "6bb95e9c-ed3b-4674-8e70-f03db98980a7",
"Type": 0,
"ResourceId": "4fbf4752-1db5-4890-8bf5-57970712f61a",
"Units": 3.0
}
],
"ParentId": "6a328115-9abf-441a-a012-3f9e6e65f720",
"WorkTypeParentId": "0b36173f-89b8-40b7-bb3a-8d3dd1da2030",
"WorkTypeIndex": 9,
"Fields": {
"sample string 1": {},
"sample string 3": {}
},
"Index": 10,
"Complete": true,
"Comments": [
{
"Id": "7c7aeac6-0cbd-43bb-977c-781f9036a916",
"UPN": "a0fbe415-7423-4a66-8063-26b275f2c908",
"PostDate": "2025-12-25T07:18:52.896138+00:00",
"Comment": "sample string 4",
"CC": [
"8c43eb8f-65cf-45a9-a435-e2c74830e26a",
"2b3d8889-04ea-4a2e-b785-2ac6734ef846"
],
"Users": [
"5ee9b6df-f6b1-4dfa-9f37-8b4010f9d98a",
"ee0076d5-cd6d-4ec8-a405-1c6ac25bf02d"
]
},
{
"Id": "7c7aeac6-0cbd-43bb-977c-781f9036a916",
"UPN": "a0fbe415-7423-4a66-8063-26b275f2c908",
"PostDate": "2025-12-25T07:18:52.896138+00:00",
"Comment": "sample string 4",
"CC": [
"8c43eb8f-65cf-45a9-a435-e2c74830e26a",
"2b3d8889-04ea-4a2e-b785-2ac6734ef846"
],
"Users": [
"5ee9b6df-f6b1-4dfa-9f37-8b4010f9d98a",
"ee0076d5-cd6d-4ec8-a405-1c6ac25bf02d"
]
}
],
"StartDate": "2025-12-25T07:18:52.896138+00:00",
"DueDate": "2025-12-25T07:18:52.896138+00:00",
"TaskScheduleType": 0,
"StatusUpdate": {
"ResourceReplacements": {
"9b27f184-b3ca-46f4-9528-b2d0a9b9063d": "6ead66c1-e411-47f3-b510-0958ff6ca79a",
"3c5f159e-ed91-461e-90f6-fb03e0110202": "4990278d-7314-46c2-a8f1-c4666d5419e6"
},
"HasUpdates": true,
"Modified": "2025-12-25T07:18:52.896138+00:00",
"Editor": "sample string 3",
"Fields": {
"sample string 1": {},
"sample string 3": {}
},
"CalcFields": {
"sample string 1": {},
"sample string 3": {}
},
"State": 0,
"ApproveRejectBy": "sample string 4",
"ApproveRejectDate": "2025-12-25T07:18:52.896138+00:00"
},
"LastComment": "2025-12-25T07:18:52.896138+00:00",
"IsScheduled": true,
"Integration": {
"IntegrationId": "5c620505-ffa3-467b-b7f6-0dda613e9767",
"ExternalItemId": "sample string 2",
"ExternalUrl": "sample string 3",
"ReadOnlyFields": [
"sample string 1",
"sample string 2"
]
},
"WorkPlanId": "8815a1cb-1dea-451c-bc39-12de6e0d8654",
"id": "0ca9990c-2de5-4d7d-a003-69bab7c965fd",
"ConfigId": "3676fc02-d94c-47ee-9338-57bac7de8386"
}