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": "1ce41cb3-c92e-4520-9905-0d52b7af6c98",
"ParentTaskId": "633128f6-96b1-46db-b630-bf478af858e1",
"Integration": {
"IntegrationId": "934194df-f28f-4054-8393-2f2d59a2b8d2",
"ExternalItemId": "sample string 2",
"ExternalUrl": "sample string 3",
"ReadOnlyFields": [
"sample string 1",
"sample string 2"
]
},
"Assignments": {
"143dc416-bd09-4b85-adb4-ce72cd24c9f5": 2.0,
"9e287fc5-ab18-4562-ae8a-17f734f3ea88": 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": "d9678fe1-3678-4dbd-b7d2-295b2ea0c14e",
"Name": "sample string 1",
"Created": "2025-12-10T23:31:32.6372262+00:00",
"Modified": "2025-12-10T23:31:32.6372262+00:00",
"Author": "sample string 4",
"Editor": "sample string 5",
"AssignedTo": [
"9303c781-15e6-4cec-954e-cc0e680852c2",
"6fb5a3b6-15f0-4acc-a2e4-bc30752ba30c"
],
"NonLaborAssignments": [
{
"Id": "639cf681-dab3-4845-bfe3-db68d509f4ee",
"ResourceId": "9a84982e-958f-4d4d-a28b-085dbda1294f",
"Quantity": 3.0
},
{
"Id": "639cf681-dab3-4845-bfe3-db68d509f4ee",
"ResourceId": "9a84982e-958f-4d4d-a28b-085dbda1294f",
"Quantity": 3.0
}
],
"Assignments": [
{
"Id": "f8a7efda-15d5-48df-8f29-49addda52ed3",
"Type": 0,
"ResourceId": "fc99f0b1-0065-441c-b008-a018ef303581",
"Units": 3.0
},
{
"Id": "f8a7efda-15d5-48df-8f29-49addda52ed3",
"Type": 0,
"ResourceId": "fc99f0b1-0065-441c-b008-a018ef303581",
"Units": 3.0
}
],
"ParentId": "d6b6925a-fbfe-4e73-9576-c1893b4de5b3",
"WorkTypeParentId": "7a924e5c-ec0e-496a-9847-22aebf1ec0fa",
"WorkTypeIndex": 9,
"Fields": {
"sample string 1": {},
"sample string 3": {}
},
"Index": 10,
"Complete": true,
"Comments": [
{
"Id": "cabcc12d-11cd-441d-a0a9-a7c95bff465b",
"UPN": "a473dd92-85ba-4b3b-bbf5-55c88d4722e5",
"PostDate": "2025-12-10T23:31:32.6372262+00:00",
"Comment": "sample string 4",
"CC": [
"13104be1-b2bf-45ba-98e9-157e1ca1c9f0",
"20f6bfd9-195c-48fb-b56b-a846150f1172"
],
"Users": [
"1b8946cd-1eea-4c17-aae6-427b73bd934a",
"cce84c75-b21b-492b-a6f6-10fd10bdb48e"
]
},
{
"Id": "cabcc12d-11cd-441d-a0a9-a7c95bff465b",
"UPN": "a473dd92-85ba-4b3b-bbf5-55c88d4722e5",
"PostDate": "2025-12-10T23:31:32.6372262+00:00",
"Comment": "sample string 4",
"CC": [
"13104be1-b2bf-45ba-98e9-157e1ca1c9f0",
"20f6bfd9-195c-48fb-b56b-a846150f1172"
],
"Users": [
"1b8946cd-1eea-4c17-aae6-427b73bd934a",
"cce84c75-b21b-492b-a6f6-10fd10bdb48e"
]
}
],
"StartDate": "2025-12-10T23:31:32.6372262+00:00",
"DueDate": "2025-12-10T23:31:32.6372262+00:00",
"TaskScheduleType": 0,
"StatusUpdate": {
"ResourceReplacements": {
"e516d333-f510-4bcd-ab42-34aaf0cadd20": "97d51f70-b075-4883-a076-d38bc60a479d",
"c2e8522b-317f-40db-8052-f94a059cbd57": "43e2eeea-4a31-479f-8c2a-6219c71b8601"
},
"HasUpdates": true,
"Modified": "2025-12-10T23:31:32.6372262+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-10T23:31:32.6372262+00:00"
},
"LastComment": "2025-12-10T23:31:32.6372262+00:00",
"IsScheduled": true,
"Integration": {
"IntegrationId": "26d16d06-a3aa-452a-8146-d9cfbd493134",
"ExternalItemId": "sample string 2",
"ExternalUrl": "sample string 3",
"ReadOnlyFields": [
"sample string 1",
"sample string 2"
]
},
"WorkPlanId": "5d8f62b4-6126-4f9d-9079-42bb78da1c6c",
"id": "5b4cdb72-2629-4a94-9e0a-5eaa503c931a",
"ConfigId": "794c9674-4698-4f38-b546-4f4470b178e4"
}