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": "19654745-a336-40d4-8f95-c17d53622e8b",
"ParentTaskId": "7219c9a2-1ea5-483c-8bea-502229e9b8ac",
"Integration": {
"IntegrationId": "03524b7a-78cb-4f8a-9dda-baa0e5a01d0a",
"ExternalItemId": "sample string 2",
"ExternalUrl": "sample string 3",
"ReadOnlyFields": [
"sample string 1",
"sample string 2"
]
},
"Assignments": {
"14494c67-43d8-4aed-84af-7e7eb8821712": 2.0,
"33a00b95-5cb5-415a-8f7d-26b4ed0d672b": 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": "787b6439-4b94-4d84-9ef8-201256ef17fd",
"Name": "sample string 1",
"Created": "2025-11-22T05:45:38.5229842+00:00",
"Modified": "2025-11-22T05:45:38.5229842+00:00",
"Author": "sample string 4",
"Editor": "sample string 5",
"AssignedTo": [
"3eb94718-d2ca-46cd-a77a-83c2cc19d89d",
"68e250aa-a747-417f-b562-41ac6a9e45af"
],
"NonLaborAssignments": [
{
"Id": "7172cf11-83bc-47e6-ba40-f5fc3091faa6",
"ResourceId": "8823c640-db49-46f8-a2c0-b92e5a5071b3",
"Quantity": 3.0
},
{
"Id": "7172cf11-83bc-47e6-ba40-f5fc3091faa6",
"ResourceId": "8823c640-db49-46f8-a2c0-b92e5a5071b3",
"Quantity": 3.0
}
],
"Assignments": [
{
"Id": "e368d1e6-0329-4df6-bb30-d5745750e7de",
"Type": 0,
"ResourceId": "961ce1bb-4c75-4ab1-8b66-e24053c5fc0d",
"Units": 3.0
},
{
"Id": "e368d1e6-0329-4df6-bb30-d5745750e7de",
"Type": 0,
"ResourceId": "961ce1bb-4c75-4ab1-8b66-e24053c5fc0d",
"Units": 3.0
}
],
"ParentId": "767a769a-9103-42c0-8614-3e29b4da5baf",
"WorkTypeParentId": "f0788785-f0c1-42e3-96cd-cac63fa01015",
"WorkTypeIndex": 9,
"Fields": {
"sample string 1": {},
"sample string 3": {}
},
"Index": 10,
"Complete": true,
"Comments": [
{
"Id": "f2342d7b-c818-4cc2-ae79-8c6a6b994a17",
"UPN": "3d787f42-dfe7-47f0-940a-3bb33d99e4a7",
"PostDate": "2025-11-22T05:45:38.5229842+00:00",
"Comment": "sample string 4",
"CC": [
"b06d7fa7-2d42-41be-9ff7-d7b598ebaac5",
"3300ce73-45e5-4724-8305-f1ebc423dd68"
],
"Users": [
"d480d6af-64b7-4062-8f97-eea194030813",
"35cd381b-6c64-439e-85c1-1768f72ce154"
]
},
{
"Id": "f2342d7b-c818-4cc2-ae79-8c6a6b994a17",
"UPN": "3d787f42-dfe7-47f0-940a-3bb33d99e4a7",
"PostDate": "2025-11-22T05:45:38.5229842+00:00",
"Comment": "sample string 4",
"CC": [
"b06d7fa7-2d42-41be-9ff7-d7b598ebaac5",
"3300ce73-45e5-4724-8305-f1ebc423dd68"
],
"Users": [
"d480d6af-64b7-4062-8f97-eea194030813",
"35cd381b-6c64-439e-85c1-1768f72ce154"
]
}
],
"StartDate": "2025-11-22T05:45:38.5229842+00:00",
"DueDate": "2025-11-22T05:45:38.5229842+00:00",
"TaskScheduleType": 0,
"StatusUpdate": {
"ResourceReplacements": {
"349eb517-713b-4dbb-b09b-06e0f4e2d6ac": "ff65d4c2-6ce9-4f4f-9e99-9649b445259f",
"9c11c64d-4c28-40cc-9c14-f86e8d28a222": "f4b39361-e42a-404d-9b36-55c2311c997c"
},
"HasUpdates": true,
"Modified": "2025-11-22T05:45:38.5229842+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-11-22T05:45:38.5229842+00:00"
},
"LastComment": "2025-11-22T05:45:38.5229842+00:00",
"IsScheduled": true,
"Integration": {
"IntegrationId": "b3ca9851-4558-499b-9b90-3e880642d508",
"ExternalItemId": "sample string 2",
"ExternalUrl": "sample string 3",
"ReadOnlyFields": [
"sample string 1",
"sample string 2"
]
},
"WorkPlanId": "a8d3764e-96cc-4f57-bfad-9df21bc1b4f2",
"id": "7271713d-b1c3-4b54-9edb-ad45b85b2405",
"ConfigId": "f904020b-e6de-4155-907b-0a95550aa5f4"
}