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": "2852cbe9-a162-41ef-872a-963412495c41",
"ParentTaskId": "47ab63ce-72ac-4677-ab16-38b3947ed1ac",
"Integration": {
"IntegrationId": "e2698df3-1f67-408e-b547-4cf7116981eb",
"ExternalItemId": "sample string 2",
"ExternalUrl": "sample string 3",
"ReadOnlyFields": [
"sample string 1",
"sample string 2"
]
},
"Assignments": {
"845d9019-8ffe-4ff7-a80b-db482aebd346": 2.0,
"4792cd8f-b259-4164-8716-7fbaec484814": 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": "2b26c59f-47d0-42c3-b65c-86106ecdaca2",
"Name": "sample string 1",
"Created": "2025-12-19T22:20:58.063191+00:00",
"Modified": "2025-12-19T22:20:58.063191+00:00",
"Author": "sample string 4",
"Editor": "sample string 5",
"AssignedTo": [
"c4cec116-b833-41a0-97e5-12e231d6c855",
"4bbf559d-72c3-480f-aba0-f983c74b2c40"
],
"NonLaborAssignments": [
{
"Id": "79f022fa-b37c-465a-9b6f-04437821ba42",
"ResourceId": "b4d81eed-d831-4327-ab06-e93f989a1284",
"Quantity": 3.0
},
{
"Id": "79f022fa-b37c-465a-9b6f-04437821ba42",
"ResourceId": "b4d81eed-d831-4327-ab06-e93f989a1284",
"Quantity": 3.0
}
],
"Assignments": [
{
"Id": "e0191aa7-773b-4006-b54a-5d43ffc3d3d3",
"Type": 0,
"ResourceId": "66d325f0-f693-44bf-9bf0-9d5aa6368954",
"Units": 3.0
},
{
"Id": "e0191aa7-773b-4006-b54a-5d43ffc3d3d3",
"Type": 0,
"ResourceId": "66d325f0-f693-44bf-9bf0-9d5aa6368954",
"Units": 3.0
}
],
"ParentId": "20217bb2-1a64-4f16-8e25-48b4ad87bb92",
"WorkTypeParentId": "0eb8f4ed-8fd9-4dce-b3cc-97e01d0673c5",
"WorkTypeIndex": 9,
"Fields": {
"sample string 1": {},
"sample string 3": {}
},
"Index": 10,
"Complete": true,
"Comments": [
{
"Id": "54630edf-154b-4746-ba87-71ba134cd568",
"UPN": "68978c5d-317e-465a-ad3d-de8ab3cd392b",
"PostDate": "2025-12-19T22:20:58.063191+00:00",
"Comment": "sample string 4",
"CC": [
"d4aafd76-0b9e-4fbb-ae20-c119e97426ce",
"d35a7fb6-9ecc-4990-8844-c3871c7083c6"
],
"Users": [
"760ccc43-8bfd-4b25-b1b0-b1d3e6b46990",
"73515ac5-fecd-48a0-a498-b0671b3adbf0"
]
},
{
"Id": "54630edf-154b-4746-ba87-71ba134cd568",
"UPN": "68978c5d-317e-465a-ad3d-de8ab3cd392b",
"PostDate": "2025-12-19T22:20:58.063191+00:00",
"Comment": "sample string 4",
"CC": [
"d4aafd76-0b9e-4fbb-ae20-c119e97426ce",
"d35a7fb6-9ecc-4990-8844-c3871c7083c6"
],
"Users": [
"760ccc43-8bfd-4b25-b1b0-b1d3e6b46990",
"73515ac5-fecd-48a0-a498-b0671b3adbf0"
]
}
],
"StartDate": "2025-12-19T22:20:58.063191+00:00",
"DueDate": "2025-12-19T22:20:58.063191+00:00",
"TaskScheduleType": 0,
"StatusUpdate": {
"ResourceReplacements": {
"92c64ff3-9da9-4086-99b1-6ce4e8453a10": "e4174449-3191-42bc-8e73-4ba890da0bae",
"880df76f-f2c6-4611-8f3f-296c9fd9cc05": "536dcf76-13cf-49c5-9f8c-f5df547da32e"
},
"HasUpdates": true,
"Modified": "2025-12-19T22:20:58.063191+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-19T22:20:58.063191+00:00"
},
"LastComment": "2025-12-19T22:20:58.063191+00:00",
"IsScheduled": true,
"Integration": {
"IntegrationId": "21736fc3-1c68-4593-8988-c43d446442b7",
"ExternalItemId": "sample string 2",
"ExternalUrl": "sample string 3",
"ReadOnlyFields": [
"sample string 1",
"sample string 2"
]
},
"WorkPlanId": "325ab8df-25b2-41f4-ac0d-70d49b408dd5",
"id": "80adc9e7-0dd7-4c8c-89db-b3d377a09d5a",
"ConfigId": "d8a42712-76f6-405c-8304-fd0866f7f4c7"
}