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": "82910a45-d3d0-45bc-b70e-1e635c3226fa",
"ParentTaskId": "71da498a-6c70-4fb0-bd24-bc58865ea778",
"Integration": {
"IntegrationId": "95ffec36-b1e2-4ea7-a17e-2fd6f78ad461",
"ExternalItemId": "sample string 2",
"ExternalUrl": "sample string 3",
"ReadOnlyFields": [
"sample string 1",
"sample string 2"
]
},
"Assignments": {
"be236d21-5ef6-4fc5-839e-134a1eed6353": 2.0,
"a8d47ea1-4f9d-4056-b89d-eff3d9c5b4f2": 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": "cd0679fe-395f-47f3-84fa-db993b80469e",
"Name": "sample string 1",
"Created": "2025-12-03T22:55:02.2059939+00:00",
"Modified": "2025-12-03T22:55:02.2059939+00:00",
"Author": "sample string 4",
"Editor": "sample string 5",
"AssignedTo": [
"ad4ae384-b578-4a7d-9c3e-c8eaad8e976b",
"9e91dacf-f703-422c-90e6-c75476612ef0"
],
"NonLaborAssignments": [
{
"Id": "a557d40c-9d52-4779-bb02-a4ea6a796771",
"ResourceId": "9a1dac69-1b2d-4e1b-907b-45a6ec3f7c5a",
"Quantity": 3.0
},
{
"Id": "a557d40c-9d52-4779-bb02-a4ea6a796771",
"ResourceId": "9a1dac69-1b2d-4e1b-907b-45a6ec3f7c5a",
"Quantity": 3.0
}
],
"Assignments": [
{
"Id": "39b08224-3776-45a1-84f3-b2b49ce27a16",
"Type": 0,
"ResourceId": "55453e2c-54af-4508-8d79-17b44419374e",
"Units": 3.0
},
{
"Id": "39b08224-3776-45a1-84f3-b2b49ce27a16",
"Type": 0,
"ResourceId": "55453e2c-54af-4508-8d79-17b44419374e",
"Units": 3.0
}
],
"ParentId": "62c7c01e-883d-465d-8e2f-f603f738b2ce",
"WorkTypeParentId": "276d22a8-b752-410b-9ac6-2d652ff1408e",
"WorkTypeIndex": 9,
"Fields": {
"sample string 1": {},
"sample string 3": {}
},
"Index": 10,
"Complete": true,
"Comments": [
{
"Id": "30372de7-1cc6-40e2-bd82-88517c7d1929",
"UPN": "71f0e4b9-5c5e-4532-994e-2bbbf77ee3fe",
"PostDate": "2025-12-03T22:55:02.2059939+00:00",
"Comment": "sample string 4",
"CC": [
"74570f8c-fd8e-4a78-ab0e-942d7a49d556",
"a471fd42-4668-45e3-b9e0-b057ee92e908"
],
"Users": [
"ed045ea9-2f9f-43c8-93e3-e99bb3efbaaa",
"a06d0edd-60ce-4324-a7ee-7d3847e75291"
]
},
{
"Id": "30372de7-1cc6-40e2-bd82-88517c7d1929",
"UPN": "71f0e4b9-5c5e-4532-994e-2bbbf77ee3fe",
"PostDate": "2025-12-03T22:55:02.2059939+00:00",
"Comment": "sample string 4",
"CC": [
"74570f8c-fd8e-4a78-ab0e-942d7a49d556",
"a471fd42-4668-45e3-b9e0-b057ee92e908"
],
"Users": [
"ed045ea9-2f9f-43c8-93e3-e99bb3efbaaa",
"a06d0edd-60ce-4324-a7ee-7d3847e75291"
]
}
],
"StartDate": "2025-12-03T22:55:02.2059939+00:00",
"DueDate": "2025-12-03T22:55:02.2059939+00:00",
"TaskScheduleType": 0,
"StatusUpdate": {
"ResourceReplacements": {
"f09dfd1f-8ebf-4ef8-a0dd-521524b11636": "a5a71583-3451-426d-bd9c-31d9694dc4a5",
"131f8e77-063b-4846-8500-6d7d5ea2daaa": "825310e9-2b50-43f4-ab85-93346913b60f"
},
"HasUpdates": true,
"Modified": "2025-12-03T22:55:02.2059939+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-03T22:55:02.2059939+00:00"
},
"LastComment": "2025-12-03T22:55:02.2059939+00:00",
"IsScheduled": true,
"Integration": {
"IntegrationId": "d101f155-2800-44d2-856d-46dbedb4f414",
"ExternalItemId": "sample string 2",
"ExternalUrl": "sample string 3",
"ReadOnlyFields": [
"sample string 1",
"sample string 2"
]
},
"WorkPlanId": "0a211f4e-8517-452e-a6cf-7ca409c6f3e5",
"id": "978a65e2-9461-4a25-8636-1865ceb85358",
"ConfigId": "6386f514-4193-431e-a0d2-37fb390cf4e4"
}