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	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": "23c18d3a-cfd9-4f7e-a9e6-ef390e941bb6",
  "ParentTaskId": "3ab0acba-7593-44e5-a090-77249f016f07",
  "Integration": {
    "IntegrationId": "53363e2c-bb9e-4738-9d3a-941480d9d0b6",
    "ExternalItemId": "sample string 2",
    "ExternalUrl": "sample string 3",
    "ReadOnlyFields": [
      "sample string 1",
      "sample string 2"
    ]
  },
  "Assignments": {
    "5ef47815-cc2c-43c6-9df7-7868e15ed303": 2.0,
    "476e887d-3f3e-4d78-b345-0e02d49a988d": 4.0
  },
  "ProcessAssignments": true
}

Response Information

Resource Description

WorkPlanTask

Name	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.
LinkedFileIds	Collection of string	None.
LinkedLinkIds	Collection of string	None.
WorkPlanId	globally unique identifier	None.
id	globally unique identifier	None.
ConfigId	globally unique identifier	None.

Response Formats

application/json, text/json

Sample:

{
  "WorkTypeId": "fbca1309-ad53-4966-ad47-288cd2e44067",
  "Name": "sample string 1",
  "Created": "2026-07-20T08:19:10.8492292+00:00",
  "Modified": "2026-07-20T08:19:10.8492292+00:00",
  "Author": "sample string 4",
  "Editor": "sample string 5",
  "AssignedTo": [
    "ce359e92-c97a-4ce8-9d07-84dd64a96e98",
    "7ab8530e-68f8-4e7a-9d17-60bf04df2c45"
  ],
  "NonLaborAssignments": [
    {
      "Id": "41692ce8-ce35-4525-a50b-e6997070759e",
      "ResourceId": "7dc42d51-0f5d-436c-acd2-5abcf4559ee0",
      "Quantity": 3.0
    },
    {
      "Id": "41692ce8-ce35-4525-a50b-e6997070759e",
      "ResourceId": "7dc42d51-0f5d-436c-acd2-5abcf4559ee0",
      "Quantity": 3.0
    }
  ],
  "Assignments": [
    {
      "Id": "fd14a8d5-bb3f-4691-aeb3-2f223df09d33",
      "Type": 0,
      "ResourceId": "13cad241-2523-4867-a0a0-d327bbaa41db",
      "Units": 3.0,
      "Quantity": 4.0,
      "Cost": 5.0
    },
    {
      "Id": "fd14a8d5-bb3f-4691-aeb3-2f223df09d33",
      "Type": 0,
      "ResourceId": "13cad241-2523-4867-a0a0-d327bbaa41db",
      "Units": 3.0,
      "Quantity": 4.0,
      "Cost": 5.0
    }
  ],
  "ParentId": "84e078cb-259b-41bc-b72c-d09c295b4fa2",
  "WorkTypeParentId": "1a95d416-9dc3-4c64-8741-7fe47a423556",
  "WorkTypeIndex": 9,
  "Fields": {
    "sample string 1": {},
    "sample string 3": {}
  },
  "Index": 10,
  "Complete": true,
  "Comments": [
    {
      "Id": "64945dcf-5b66-4ace-a68f-cdbde38db7ee",
      "UPN": "20162fcf-cb17-4c75-b671-6defbd0b646b",
      "PostDate": "2026-07-20T08:19:10.8492292+00:00",
      "Comment": "sample string 4",
      "CC": [
        "0646c7ec-8d98-40a6-8f51-1267146f5a22",
        "3a68169b-c08d-4c01-9801-ff7c3373135b"
      ],
      "Users": [
        "baf99aed-fbf9-42c6-8fe9-cb63f805bb9e",
        "1f3ffca3-2189-449c-95c8-4835090cdff9"
      ]
    },
    {
      "Id": "64945dcf-5b66-4ace-a68f-cdbde38db7ee",
      "UPN": "20162fcf-cb17-4c75-b671-6defbd0b646b",
      "PostDate": "2026-07-20T08:19:10.8492292+00:00",
      "Comment": "sample string 4",
      "CC": [
        "0646c7ec-8d98-40a6-8f51-1267146f5a22",
        "3a68169b-c08d-4c01-9801-ff7c3373135b"
      ],
      "Users": [
        "baf99aed-fbf9-42c6-8fe9-cb63f805bb9e",
        "1f3ffca3-2189-449c-95c8-4835090cdff9"
      ]
    }
  ],
  "StartDate": "2026-07-20T08:19:10.8492292+00:00",
  "DueDate": "2026-07-20T08:19:10.8492292+00:00",
  "TaskScheduleType": 0,
  "StatusUpdate": {
    "ResourceReplacements": {
      "769e36eb-209b-4507-bfa3-514cb91b1604": "8497f558-5fa3-4467-912c-6617dc9243ef",
      "de6bc660-2518-4c88-b4bf-bc469b5252be": "e8835841-aaa3-4a20-8447-87920660440e"
    },
    "HasUpdates": true,
    "Modified": "2026-07-20T08:19:10.8492292+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": "2026-07-20T08:19:10.8492292+00:00"
  },
  "LastComment": "2026-07-20T08:19:10.8492292+00:00",
  "IsScheduled": true,
  "Integration": {
    "IntegrationId": "e00bf4cb-64a3-4a52-8f15-40f60ea5fb33",
    "ExternalItemId": "sample string 2",
    "ExternalUrl": "sample string 3",
    "ReadOnlyFields": [
      "sample string 1",
      "sample string 2"
    ]
  },
  "LinkedFileIds": [
    "sample string 1",
    "sample string 2"
  ],
  "LinkedLinkIds": [
    "sample string 1",
    "sample string 2"
  ],
  "WorkPlanId": "a5c3e5cf-d681-4b10-bf3c-f4fbbbf2e678",
  "id": "b6e44767-eae4-449c-a8cc-f512cbeb2c33",
  "ConfigId": "765db11e-9d34-45a2-bda2-5cf9a3c9516a"
}