Back

POST tasks?tz={tz}

Create a new task.

Request Information

URI Parameters

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
tz string

Optional parameter to set time zone information.

Body Parameters (Task)

This object takes all the parameters needed to create a new task.

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
ID globally unique identifier Required on Update

ID of the Task.
AncestorID globally unique identifier Required on Create

ID of the ancestor for a task; department, organization, or individual.
ParentID globally unique identifier

ID of the project above a task.
Name string Required

Name of the task. (Max length 255 characters)
Description string

Description of the task.
Priority integer

Priority of the task. Valid inputs are: 1= low, 2 = normal, 3 = high, or null.
Rank integer

Rank of the task.
Color string

Hex value for the color of the given task.
HoursActual decimal number

Number of actual hours this task took.
HoursProjected decimal number

Number of hours this task is projected to take.
StartDateActual string

Date this task was actually started.
StartDateProjected string

Date this task is projected to start.
EndDateActual string

Date this task was completed.
EndDateProjected string

Date this task is projected to complete.
Milestone boolean

Displays if this task is a milestone or not.
TrackingLabel string

Customizable label for task. (Max length 50 characters)
NearHighlightOverride integer

Override the near due date highlights settings for a specific task.
SiteID globally unique identifier ReadOnly

ID of the site for the task.
RankPath Collection of byte ReadOnly

Current rank of the given task in a byte array.
RankOrder string ReadOnly

RankOrder to sort rank in the format .0001.0001.0001 (This always returns null when reading a single task by ID.)
DisplayRank string ReadOnly

Rank that is displayed
Level integer ReadOnly

Number of indent levels, Ex: 1 = 1, 1.1 = 2, 1.1.1 = 3 (This always returns null when reading a single task by ID.)
SumHoursActual decimal number ReadOnly

Sum of the actual number of hours this task took.
SumHoursProjected decimal number ReadOnly

Sum of the number of hours this task is projected to take.
Deleted boolean ReadOnly

Deleted status of the task.
DeletedByRef boolean ReadOnly

Deleted by reference status of the task.
Created date ReadOnly

Date the task was created.
CreatedBy globally unique identifier ReadOnly

ID of the person that created the task.
Updated date ReadOnly

Date when the task was last updated.
UpdatedBy globally unique identifier ReadOnly

ID of the person that updated the task.
PeopleResponsible string ReadOnly

Names of the People responsible for this task.
PeopleResponsibleList Collection of PersonResponsible ReadOnly

List and details of all the people responsible for the given task.
LastComment string ReadOnly

Body of the most recent comment for the given task.
LastCommentDate date ReadOnly

Date of the most recent comment for the given task.
LastCommentByID globally unique identifier ReadOnly

ID of the individual who posted the most recent comment for the given task.
LastCommentBy string ReadOnly

Name of the individual who posted the most recent comment for the given task.
Draft boolean ReadOnly

Displays if this task is a draft or not.
RowType integer ReadOnly

Row type of the task.
AncestorType byte ReadOnly

Row type of the Ancestor.
AncestorName string ReadOnly

Name of the task's Ancestor.
ColorName string ReadOnly

Name of the task's color.
ColorRank integer ReadOnly

Rank of the task's color.
EndDate string ReadOnly

Date the task actually ended or projected to end.
StartDate string ReadOnly

Date the task actually started or projected to start.
NearHighlight integer ReadOnly

Near due date highlights settings for a specific task.
CanRead boolean ReadOnly

Read security setting for the object based on the current logged in user.
CanUpdate boolean ReadOnly

Update security setting for the object based on the current logged in user.
CanDelete boolean ReadOnly

Delete security setting for the object based on the current logged in user.
CanDelegate boolean ReadOnly

Delegate security setting for the object based on the current logged in user.
IsRecurring boolean

This denotes if the task will reoccur when it is completed.
Interval integer

Interval of the recurring task.
IntervalQualifier string

Interval type for the task. This can be: Day, Month, Week, or Year
MonthOption boolean

If it is monthly ex 2nd tuesday
DayOfMonth byte

Sets day of the month the task should reoccur
WeekDayInstance byte

1-5 Tuesday
WeekDay byte

Day of the week.
Sunday boolean

Denotes if this task should repeat on Sunday.
Monday boolean

Denotes if this task should repeat on Monday.
Tuesday boolean

Denotes if this task should repeat on Tuesday.
Wednesday boolean

Denotes if this task should repeat on Wednesday.
Thursday boolean

Denotes if this task should repeat on Thursday.
Friday boolean

Denotes if this task should repeat on Friday.
Saturday boolean

Denotes if this task should repeat on Saturday.
PreviousTask globally unique identifier ReadOnly

ID of the previous task.
NextTask globally unique identifier ReadOnly

ID of the next task. Recurrence can no longer be set if this is not null.
NewPeople string

List of comma separated GUID Individual IDs to add to a new task.

Request Formats

application/xml, text/xml

Sample
<Task xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>bb33710a-eb0b-4969-aec7-7851833fecc8</ID>
  <AncestorID>b401f08b-46cb-47a2-bc70-c3dd1a7e8bdc</AncestorID>
  <ParentID>e905bacf-8bf2-4baa-954a-5fb6a64b4d22</ParentID>
  <Name>sample string 1</Name>
  <Description>sample string 2</Description>
  <Priority>1</Priority>
  <Rank>1</Rank>
  <Color>sample string 3</Color>
  <HoursActual>1</HoursActual>
  <HoursProjected>1</HoursProjected>
  <Milestone>true</Milestone>
  <TrackingLabel>sample string 8</TrackingLabel>
  <NearHighlightOverride>1</NearHighlightOverride>
  <IsRecurring>true</IsRecurring>
  <Interval>1</Interval>
  <IntervalQualifier>sample string 19</IntervalQualifier>
  <MonthOption>true</MonthOption>
  <DayOfMonth>64</DayOfMonth>
  <WeekDayInstance>64</WeekDayInstance>
  <WeekDay>64</WeekDay>
  <Sunday>true</Sunday>
  <Monday>true</Monday>
  <Tuesday>true</Tuesday>
  <Wednesday>true</Wednesday>
  <Thursday>true</Thursday>
  <Friday>true</Friday>
  <Saturday>true</Saturday>
  <NewPeople>sample string 27</NewPeople>
</Task>

application/json, text/json

Sample
{
  "ID": "bb33710a-eb0b-4969-aec7-7851833fecc8",
  "AncestorID": "b401f08b-46cb-47a2-bc70-c3dd1a7e8bdc",
  "ParentID": "e905bacf-8bf2-4baa-954a-5fb6a64b4d22",
  "Name": "sample string 1",
  "Description": "sample string 2",
  "Priority": 1,
  "Rank": 1,
  "Color": "sample string 3",
  "HoursActual": 1.0,
  "HoursProjected": 1.0,
  "Milestone": true,
  "TrackingLabel": "sample string 8",
  "NearHighlightOverride": 1,
  "IsRecurring": true,
  "Interval": 1,
  "IntervalQualifier": "sample string 19",
  "MonthOption": true,
  "DayOfMonth": 64,
  "WeekDayInstance": 64,
  "WeekDay": 64,
  "Sunday": true,
  "Monday": true,
  "Tuesday": true,
  "Wednesday": true,
  "Thursday": true,
  "Friday": true,
  "Saturday": true,
  "NewPeople": "sample string 27"
}

Response Information

Resource Description (Task)

System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
ID globally unique identifier Required on Update

ID of the Task.
AncestorID globally unique identifier Required on Create

ID of the ancestor for a task; department, organization, or individual.
ParentID globally unique identifier

ID of the project above a task.
Name string Required

Name of the task. (Max length 255 characters)
Description string

Description of the task.
Priority integer

Priority of the task. Valid inputs are: 1= low, 2 = normal, 3 = high, or null.
Rank integer

Rank of the task.
Color string

Hex value for the color of the given task.
HoursActual decimal number

Number of actual hours this task took.
HoursProjected decimal number

Number of hours this task is projected to take.
StartDateActual string

Date this task was actually started.
StartDateProjected string

Date this task is projected to start.
EndDateActual string

Date this task was completed.
EndDateProjected string

Date this task is projected to complete.
Milestone boolean

Displays if this task is a milestone or not.
TrackingLabel string

Customizable label for task. (Max length 50 characters)
NearHighlightOverride integer

Override the near due date highlights settings for a specific task.
SiteID globally unique identifier ReadOnly

ID of the site for the task.
RankPath Collection of byte ReadOnly

Current rank of the given task in a byte array.
RankOrder string ReadOnly

RankOrder to sort rank in the format .0001.0001.0001 (This always returns null when reading a single task by ID.)
DisplayRank string ReadOnly

Rank that is displayed
Level integer ReadOnly

Number of indent levels, Ex: 1 = 1, 1.1 = 2, 1.1.1 = 3 (This always returns null when reading a single task by ID.)
SumHoursActual decimal number ReadOnly

Sum of the actual number of hours this task took.
SumHoursProjected decimal number ReadOnly

Sum of the number of hours this task is projected to take.
Deleted boolean ReadOnly

Deleted status of the task.
DeletedByRef boolean ReadOnly

Deleted by reference status of the task.
Created date ReadOnly

Date the task was created.
CreatedBy globally unique identifier ReadOnly

ID of the person that created the task.
Updated date ReadOnly

Date when the task was last updated.
UpdatedBy globally unique identifier ReadOnly

ID of the person that updated the task.
PeopleResponsible string ReadOnly

Names of the People responsible for this task.
PeopleResponsibleList Collection of PersonResponsible ReadOnly

List and details of all the people responsible for the given task.
LastComment string ReadOnly

Body of the most recent comment for the given task.
LastCommentDate date ReadOnly

Date of the most recent comment for the given task.
LastCommentByID globally unique identifier ReadOnly

ID of the individual who posted the most recent comment for the given task.
LastCommentBy string ReadOnly

Name of the individual who posted the most recent comment for the given task.
Draft boolean ReadOnly

Displays if this task is a draft or not.
RowType integer ReadOnly

Row type of the task.
AncestorType byte ReadOnly

Row type of the Ancestor.
AncestorName string ReadOnly

Name of the task's Ancestor.
ColorName string ReadOnly

Name of the task's color.
ColorRank integer ReadOnly

Rank of the task's color.
EndDate string ReadOnly

Date the task actually ended or projected to end.
StartDate string ReadOnly

Date the task actually started or projected to start.
NearHighlight integer ReadOnly

Near due date highlights settings for a specific task.
CanRead boolean ReadOnly

Read security setting for the object based on the current logged in user.
CanUpdate boolean ReadOnly

Update security setting for the object based on the current logged in user.
CanDelete boolean ReadOnly

Delete security setting for the object based on the current logged in user.
CanDelegate boolean ReadOnly

Delegate security setting for the object based on the current logged in user.
IsRecurring boolean

This denotes if the task will reoccur when it is completed.
Interval integer

Interval of the recurring task.
IntervalQualifier string

Interval type for the task. This can be: Day, Month, Week, or Year
MonthOption boolean

If it is monthly ex 2nd tuesday
DayOfMonth byte

Sets day of the month the task should reoccur
WeekDayInstance byte

1-5 Tuesday
WeekDay byte

Day of the week.
Sunday boolean

Denotes if this task should repeat on Sunday.
Monday boolean

Denotes if this task should repeat on Monday.
Tuesday boolean

Denotes if this task should repeat on Tuesday.
Wednesday boolean

Denotes if this task should repeat on Wednesday.
Thursday boolean

Denotes if this task should repeat on Thursday.
Friday boolean

Denotes if this task should repeat on Friday.
Saturday boolean

Denotes if this task should repeat on Saturday.
PreviousTask globally unique identifier ReadOnly

ID of the previous task.
NextTask globally unique identifier ReadOnly

ID of the next task. Recurrence can no longer be set if this is not null.
NewPeople string

List of comma separated GUID Individual IDs to add to a new task.

Response Formats

application/xml, text/xml

Sample
<Task xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>9802e17a-0300-42ad-a659-5d87b8544d7e</ID>
  <AncestorID>c36c1229-211d-4043-b174-7220af50c7b0</AncestorID>
  <ParentID>56b508f0-00d9-4b12-a8c9-538077a167c3</ParentID>
  <Name>sample string 1</Name>
  <Description>sample string 2</Description>
  <Priority>1</Priority>
  <Rank>1</Rank>
  <Color>sample string 3</Color>
  <HoursActual>1</HoursActual>
  <HoursProjected>1</HoursProjected>
  <Milestone>true</Milestone>
  <TrackingLabel>sample string 8</TrackingLabel>
  <NearHighlightOverride>1</NearHighlightOverride>
  <SiteID>f5c8973f-da14-4fcb-8351-78fc42beb9da</SiteID>
  <RankPath>QEA=</RankPath>
  <RankOrder>sample string 9</RankOrder>
  <DisplayRank>sample string 10</DisplayRank>
  <Level>1</Level>
  <SumHoursActual>1</SumHoursActual>
  <SumHoursProjected>1</SumHoursProjected>
  <Deleted>true</Deleted>
  <DeletedByRef>true</DeletedByRef>
  <Created>2026-01-29T03:39:17.2086225+00:00</Created>
  <CreatedBy>26c203c3-63da-4d05-93db-d666a4736235</CreatedBy>
  <Updated>2026-01-29T03:39:17.2086225+00:00</Updated>
  <UpdatedBy>b47b3d6d-1992-4e46-b654-3616b2f27b18</UpdatedBy>
  <PeopleResponsible>sample string 11</PeopleResponsible>
  <PeopleResponsibleList>
    <PersonResponsible>
      <TaskID>e10ce7df-4ac0-4dd0-b48b-7c1963d94e22</TaskID>
      <IndividualID>1a9023ed-c72a-4073-9058-0edcac2d44df</IndividualID>
      <HoursProjected>1</HoursProjected>
      <HoursActual>1</HoursActual>
      <ID>073ba0e8-1854-43f8-adfe-b3e26e4344bb</ID>
      <TaskIndividualGroupID>f3baa72e-0900-42b7-aa3a-de31161b86f0</TaskIndividualGroupID>
      <Created>2026-01-29T03:39:17.2086225+00:00</Created>
      <CreatedBy>bdfbd1d4-1280-42d1-a1b8-d5d5f99c3892</CreatedBy>
      <SiteID>973ddfa1-3998-4648-ab70-bfce1e45d228</SiteID>
      <Updated>2026-01-29T03:39:17.2086225+00:00</Updated>
      <UpdatedBy>70607a7e-c3c8-4664-9caa-80de9912b02f</UpdatedBy>
      <HoursActualRollup>1</HoursActualRollup>
      <HoursProjectedRollup>1</HoursProjectedRollup>
      <FullName>sample string 1</FullName>
    </PersonResponsible>
    <PersonResponsible>
      <TaskID>e10ce7df-4ac0-4dd0-b48b-7c1963d94e22</TaskID>
      <IndividualID>1a9023ed-c72a-4073-9058-0edcac2d44df</IndividualID>
      <HoursProjected>1</HoursProjected>
      <HoursActual>1</HoursActual>
      <ID>073ba0e8-1854-43f8-adfe-b3e26e4344bb</ID>
      <TaskIndividualGroupID>f3baa72e-0900-42b7-aa3a-de31161b86f0</TaskIndividualGroupID>
      <Created>2026-01-29T03:39:17.2086225+00:00</Created>
      <CreatedBy>bdfbd1d4-1280-42d1-a1b8-d5d5f99c3892</CreatedBy>
      <SiteID>973ddfa1-3998-4648-ab70-bfce1e45d228</SiteID>
      <Updated>2026-01-29T03:39:17.2086225+00:00</Updated>
      <UpdatedBy>70607a7e-c3c8-4664-9caa-80de9912b02f</UpdatedBy>
      <HoursActualRollup>1</HoursActualRollup>
      <HoursProjectedRollup>1</HoursProjectedRollup>
      <FullName>sample string 1</FullName>
    </PersonResponsible>
  </PeopleResponsibleList>
  <LastComment>sample string 12</LastComment>
  <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2026-01-29T03:39:17.2086225Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </LastCommentDate>
  <LastCommentByID>9bb33782-c3f7-4df7-8703-391969235c81</LastCommentByID>
  <LastCommentBy>sample string 13</LastCommentBy>
  <Draft>true</Draft>
  <RowType>1</RowType>
  <AncestorType>64</AncestorType>
  <AncestorName>sample string 14</AncestorName>
  <ColorName>sample string 15</ColorName>
  <ColorRank>1</ColorRank>
  <NearHighlight>1</NearHighlight>
  <CanRead>true</CanRead>
  <CanUpdate>true</CanUpdate>
  <CanDelete>true</CanDelete>
  <CanDelegate>true</CanDelegate>
  <IsRecurring>true</IsRecurring>
  <Interval>1</Interval>
  <IntervalQualifier>sample string 19</IntervalQualifier>
  <MonthOption>true</MonthOption>
  <DayOfMonth>64</DayOfMonth>
  <WeekDayInstance>64</WeekDayInstance>
  <WeekDay>64</WeekDay>
  <Sunday>true</Sunday>
  <Monday>true</Monday>
  <Tuesday>true</Tuesday>
  <Wednesday>true</Wednesday>
  <Thursday>true</Thursday>
  <Friday>true</Friday>
  <Saturday>true</Saturday>
  <PreviousTask>6c42e433-6d95-48e9-9a04-15fcb232ff80</PreviousTask>
  <NextTask>14e078aa-2d50-41bd-818e-6d80ef949e65</NextTask>
  <NewPeople>sample string 27</NewPeople>
</Task>

application/json, text/json

Sample
{
  "ID": "9802e17a-0300-42ad-a659-5d87b8544d7e",
  "AncestorID": "c36c1229-211d-4043-b174-7220af50c7b0",
  "ParentID": "56b508f0-00d9-4b12-a8c9-538077a167c3",
  "Name": "sample string 1",
  "Description": "sample string 2",
  "Priority": 1,
  "Rank": 1,
  "Color": "sample string 3",
  "HoursActual": 1.0,
  "HoursProjected": 1.0,
  "Milestone": true,
  "TrackingLabel": "sample string 8",
  "NearHighlightOverride": 1,
  "SiteID": "f5c8973f-da14-4fcb-8351-78fc42beb9da",
  "RankPath": "QEA=",
  "RankOrder": "sample string 9",
  "DisplayRank": "sample string 10",
  "Level": 1,
  "SumHoursActual": 1.0,
  "SumHoursProjected": 1.0,
  "Deleted": true,
  "DeletedByRef": true,
  "Created": "2026-01-29T03:39:17.2086225+00:00",
  "CreatedBy": "26c203c3-63da-4d05-93db-d666a4736235",
  "Updated": "2026-01-29T03:39:17.2086225+00:00",
  "UpdatedBy": "b47b3d6d-1992-4e46-b654-3616b2f27b18",
  "PeopleResponsible": "sample string 11",
  "PeopleResponsibleList": [
    {
      "TaskID": "e10ce7df-4ac0-4dd0-b48b-7c1963d94e22",
      "IndividualID": "1a9023ed-c72a-4073-9058-0edcac2d44df",
      "HoursProjected": 1.0,
      "HoursActual": 1.0,
      "ID": "073ba0e8-1854-43f8-adfe-b3e26e4344bb",
      "TaskIndividualGroupID": "f3baa72e-0900-42b7-aa3a-de31161b86f0",
      "Created": "2026-01-29T03:39:17.2086225+00:00",
      "CreatedBy": "bdfbd1d4-1280-42d1-a1b8-d5d5f99c3892",
      "SiteID": "973ddfa1-3998-4648-ab70-bfce1e45d228",
      "Updated": "2026-01-29T03:39:17.2086225+00:00",
      "UpdatedBy": "70607a7e-c3c8-4664-9caa-80de9912b02f",
      "HoursActualRollup": 1.0,
      "HoursProjectedRollup": 1.0,
      "FullName": "sample string 1"
    },
    {
      "TaskID": "e10ce7df-4ac0-4dd0-b48b-7c1963d94e22",
      "IndividualID": "1a9023ed-c72a-4073-9058-0edcac2d44df",
      "HoursProjected": 1.0,
      "HoursActual": 1.0,
      "ID": "073ba0e8-1854-43f8-adfe-b3e26e4344bb",
      "TaskIndividualGroupID": "f3baa72e-0900-42b7-aa3a-de31161b86f0",
      "Created": "2026-01-29T03:39:17.2086225+00:00",
      "CreatedBy": "bdfbd1d4-1280-42d1-a1b8-d5d5f99c3892",
      "SiteID": "973ddfa1-3998-4648-ab70-bfce1e45d228",
      "Updated": "2026-01-29T03:39:17.2086225+00:00",
      "UpdatedBy": "70607a7e-c3c8-4664-9caa-80de9912b02f",
      "HoursActualRollup": 1.0,
      "HoursProjectedRollup": 1.0,
      "FullName": "sample string 1"
    }
  ],
  "LastComment": "sample string 12",
  "LastCommentDate": "2026-01-29T03:39:17.2086225+00:00",
  "LastCommentByID": "9bb33782-c3f7-4df7-8703-391969235c81",
  "LastCommentBy": "sample string 13",
  "Draft": true,
  "RowType": 1,
  "AncestorType": 64,
  "AncestorName": "sample string 14",
  "ColorName": "sample string 15",
  "ColorRank": 1,
  "NearHighlight": 1,
  "CanRead": true,
  "CanUpdate": true,
  "CanDelete": true,
  "CanDelegate": true,
  "IsRecurring": true,
  "Interval": 1,
  "IntervalQualifier": "sample string 19",
  "MonthOption": true,
  "DayOfMonth": 64,
  "WeekDayInstance": 64,
  "WeekDay": 64,
  "Sunday": true,
  "Monday": true,
  "Tuesday": true,
  "Wednesday": true,
  "Thursday": true,
  "Friday": true,
  "Saturday": true,
  "PreviousTask": "6c42e433-6d95-48e9-9a04-15fcb232ff80",
  "NextTask": "14e078aa-2d50-41bd-818e-6d80ef949e65",
  "NewPeople": "sample string 27"
}