Back

POST projects?tz={tz}

Create a new poject.

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 (Project)

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

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

ID of the project.
ParentID globally unique identifier

ID of the parent.
AncestorID globally unique identifier Required

Ancestor ID of the project; organization or department..
Rank integer

Rank of the project.
Color string

Hex value of the color for the project. (Max length 6 characters)
HoursActual decimal number

(Deprecated) Number of hours this project actually took to complete.
HoursProjected decimal number

(Deprecated) Number of hours this project is projected to take.
StartDateActual string

Actual start date of the project.
StartDateProjected string

Projected start date of the project.
EndDateActual string

Date the project actually ended.
EndDateProjected string

Date the project is projected to end.
TrackingLabel string

Customizable label for project.
NearHighlightOverride integer

Near due highlight settings for a given project that have been overridden at the project level.
Name string

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

Description of the project.
StatusID integer

ID of the status linked to this project.
PhaseID integer Required

ID of the phase linked to this project.
AncestorName string ReadOnly

Ancestor Name of the project; department or organization.
RankOrder string ReadOnly

RankOrder to sort rank in the format .0001.0001.0001
DisplayRank string ReadOnly

Rank that is displayed
Level integer ReadOnly

Number of indent levels, Ex: 1 = 1, 1.1 = 2, 1.1.1 = 3
SumHoursActual decimal number ReadOnly

Sum of all the hours spent on this project.
SumHoursProjected decimal number ReadOnly

Sum of the projected number of hours to be spent on this project.
Status string ReadOnly

Name of the status linked to this project.
Phase string ReadOnly

Name of the phase linked to this project.
Deleted boolean ReadOnly

Deleted status of this project.
DeletedByRef boolean ReadOnly

Deleted by reference status of this project.
Created string ReadOnly

Date the project was created.
CreatedBy globally unique identifier ReadOnly

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

Date the given project was last updated.
UpdatedBy globally unique identifier ReadOnly

ID of the person that last updated the given project.
TeamMembers string ReadOnly

Individuals assigned to the project as team members.
LastComment string ReadOnly

Last comment made on this project.
LastCommentDate date ReadOnly

Date the last comment was made.
LastCommentByID globally unique identifier ReadOnly

ID of the person that made the last comment.
LastCommentBy string ReadOnly

Name of the person that last commented.
EndDateChanges integer ReadOnly

Number of times the end date has changed for the project.
IncludeSurveys boolean ReadOnly

Parameter to include or omit surveys.
AncestorType integer ReadOnly

AncestorType of the project.
Draft boolean

Indicates if the given project is a draft, this defaults to false. (drafts are unfinished projects that are only visible to the person that created them and not public).
LinkedToID globally unique identifier ReadOnly

ID of the linked project.
TeamMemberList Collection of TeamMember ReadOnly

List and details of Team Members for a given project.
StatusName string ReadOnly

Name of the status for the given project.
StatusRank integer ReadOnly

Rank of the status for the given project.
PhaseName string ReadOnly

Name of the phase for the given project.
PhaseRank integer ReadOnly

Rank of the phase for the given project.
ColorName string ReadOnly

Name of the color for the given project.
ColorRank integer ReadOnly

Rank of the color for the given project.
LinkedAncestorID globally unique identifier ReadOnly

Ancestor ID of the linked project.
LinkedToName string ReadOnly

Name of the linked project.
LinkedToRowType integer ReadOnly

RowType of the linked project.
LinkedAncestorName string ReadOnly

Name of the linked Ancestor.
EndDate string ReadOnly

Actual end date of the project, if it is not set then projected end date of the project.
StartDate string ReadOnly

Actual start date of the project, if it is not set then the projected start date of the given project.
RowType integer ReadOnly

Row type of the given project.
RankPath Collection of byte ReadOnly

Current rank of the given project in a byte array.
OnTime boolean ReadOnly

Indicates the on time status of the project, by comparing the actual and projected end dates.
CanRead boolean ReadOnly

Read permission of the given project for the currently logged in individual.
CanUpdate boolean ReadOnly

Update permission of the given project for the currently logged in individual.
CanDelete boolean ReadOnly

Delete permission of the given project for the currently logged in individual.
CanDelegate boolean ReadOnly

Delegate permission of the given project for the currently logged in individual.
NearHighlight integer Required

Near due highlight settings for a given project that have not been overridden.

Request Formats

application/xml, text/xml

Sample
<Project xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>14b50f3c-592d-4603-a2d8-8cb936347a77</ID>
  <ParentID>67a88d99-9ebe-46df-9d52-3515645253b3</ParentID>
  <AncestorID>193f1688-c998-49d7-8162-70e209b65cc8</AncestorID>
  <Rank>1</Rank>
  <Color>sample string 1</Color>
  <HoursActual>1</HoursActual>
  <HoursProjected>1</HoursProjected>
  <TrackingLabel>sample string 6</TrackingLabel>
  <NearHighlightOverride>1</NearHighlightOverride>
  <Name>sample string 7</Name>
  <Description>sample string 8</Description>
  <StatusID>1</StatusID>
  <PhaseID>1</PhaseID>
  <Draft>true</Draft>
  <NearHighlight>1</NearHighlight>
</Project>

application/json, text/json

Sample
{
  "ID": "14b50f3c-592d-4603-a2d8-8cb936347a77",
  "ParentID": "67a88d99-9ebe-46df-9d52-3515645253b3",
  "AncestorID": "193f1688-c998-49d7-8162-70e209b65cc8",
  "Rank": 1,
  "Color": "sample string 1",
  "HoursActual": 1.0,
  "HoursProjected": 1.0,
  "TrackingLabel": "sample string 6",
  "NearHighlightOverride": 1,
  "Name": "sample string 7",
  "Description": "sample string 8",
  "StatusID": 1,
  "PhaseID": 1,
  "Draft": true,
  "NearHighlight": 1
}

Response Information

Resource Description (Project)

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

ID of the project.
ParentID globally unique identifier

ID of the parent.
AncestorID globally unique identifier Required

Ancestor ID of the project; organization or department..
Rank integer

Rank of the project.
Color string

Hex value of the color for the project. (Max length 6 characters)
HoursActual decimal number

(Deprecated) Number of hours this project actually took to complete.
HoursProjected decimal number

(Deprecated) Number of hours this project is projected to take.
StartDateActual string

Actual start date of the project.
StartDateProjected string

Projected start date of the project.
EndDateActual string

Date the project actually ended.
EndDateProjected string

Date the project is projected to end.
TrackingLabel string

Customizable label for project.
NearHighlightOverride integer

Near due highlight settings for a given project that have been overridden at the project level.
Name string

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

Description of the project.
StatusID integer

ID of the status linked to this project.
PhaseID integer Required

ID of the phase linked to this project.
AncestorName string ReadOnly

Ancestor Name of the project; department or organization.
RankOrder string ReadOnly

RankOrder to sort rank in the format .0001.0001.0001
DisplayRank string ReadOnly

Rank that is displayed
Level integer ReadOnly

Number of indent levels, Ex: 1 = 1, 1.1 = 2, 1.1.1 = 3
SumHoursActual decimal number ReadOnly

Sum of all the hours spent on this project.
SumHoursProjected decimal number ReadOnly

Sum of the projected number of hours to be spent on this project.
Status string ReadOnly

Name of the status linked to this project.
Phase string ReadOnly

Name of the phase linked to this project.
Deleted boolean ReadOnly

Deleted status of this project.
DeletedByRef boolean ReadOnly

Deleted by reference status of this project.
Created string ReadOnly

Date the project was created.
CreatedBy globally unique identifier ReadOnly

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

Date the given project was last updated.
UpdatedBy globally unique identifier ReadOnly

ID of the person that last updated the given project.
TeamMembers string ReadOnly

Individuals assigned to the project as team members.
LastComment string ReadOnly

Last comment made on this project.
LastCommentDate date ReadOnly

Date the last comment was made.
LastCommentByID globally unique identifier ReadOnly

ID of the person that made the last comment.
LastCommentBy string ReadOnly

Name of the person that last commented.
EndDateChanges integer ReadOnly

Number of times the end date has changed for the project.
IncludeSurveys boolean ReadOnly

Parameter to include or omit surveys.
AncestorType integer ReadOnly

AncestorType of the project.
Draft boolean

Indicates if the given project is a draft, this defaults to false. (drafts are unfinished projects that are only visible to the person that created them and not public).
LinkedToID globally unique identifier ReadOnly

ID of the linked project.
TeamMemberList Collection of TeamMember ReadOnly

List and details of Team Members for a given project.
StatusName string ReadOnly

Name of the status for the given project.
StatusRank integer ReadOnly

Rank of the status for the given project.
PhaseName string ReadOnly

Name of the phase for the given project.
PhaseRank integer ReadOnly

Rank of the phase for the given project.
ColorName string ReadOnly

Name of the color for the given project.
ColorRank integer ReadOnly

Rank of the color for the given project.
LinkedAncestorID globally unique identifier ReadOnly

Ancestor ID of the linked project.
LinkedToName string ReadOnly

Name of the linked project.
LinkedToRowType integer ReadOnly

RowType of the linked project.
LinkedAncestorName string ReadOnly

Name of the linked Ancestor.
EndDate string ReadOnly

Actual end date of the project, if it is not set then projected end date of the project.
StartDate string ReadOnly

Actual start date of the project, if it is not set then the projected start date of the given project.
RowType integer ReadOnly

Row type of the given project.
RankPath Collection of byte ReadOnly

Current rank of the given project in a byte array.
OnTime boolean ReadOnly

Indicates the on time status of the project, by comparing the actual and projected end dates.
CanRead boolean ReadOnly

Read permission of the given project for the currently logged in individual.
CanUpdate boolean ReadOnly

Update permission of the given project for the currently logged in individual.
CanDelete boolean ReadOnly

Delete permission of the given project for the currently logged in individual.
CanDelegate boolean ReadOnly

Delegate permission of the given project for the currently logged in individual.
NearHighlight integer Required

Near due highlight settings for a given project that have not been overridden.

Response Formats

application/xml, text/xml

Sample
<Project xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>3582c638-1cac-4952-9960-bb88f71fdc9f</ID>
  <ParentID>b5047d23-e824-4687-b9a0-91e5f5f51417</ParentID>
  <AncestorID>dd9956ff-56de-443f-8cb9-c340ef69615b</AncestorID>
  <Rank>1</Rank>
  <Color>sample string 1</Color>
  <HoursActual>1</HoursActual>
  <HoursProjected>1</HoursProjected>
  <TrackingLabel>sample string 6</TrackingLabel>
  <NearHighlightOverride>1</NearHighlightOverride>
  <Name>sample string 7</Name>
  <Description>sample string 8</Description>
  <StatusID>1</StatusID>
  <PhaseID>1</PhaseID>
  <AncestorName>sample string 9</AncestorName>
  <RankOrder>sample string 10</RankOrder>
  <DisplayRank>sample string 11</DisplayRank>
  <Level>1</Level>
  <SumHoursActual>1</SumHoursActual>
  <SumHoursProjected>1</SumHoursProjected>
  <Status>sample string 12</Status>
  <Phase>sample string 13</Phase>
  <Deleted>true</Deleted>
  <DeletedByRef>true</DeletedByRef>
  <Created>sample string 14</Created>
  <CreatedBy>b1b1d057-b1f8-4f33-b92d-e9a3b6292cad</CreatedBy>
  <Updated>2025-04-18T09:25:01.8653086+00:00</Updated>
  <UpdatedBy>9d2b8b9b-d67e-479d-b335-a50cc5751f31</UpdatedBy>
  <TeamMembers>sample string 15</TeamMembers>
  <LastComment>sample string 16</LastComment>
  <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-04-18T09:25:01.8653086Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </LastCommentDate>
  <LastCommentByID>c2a00a0f-ae36-4769-b60c-46d0f81b9cb8</LastCommentByID>
  <LastCommentBy>sample string 17</LastCommentBy>
  <EndDateChanges>1</EndDateChanges>
  <IncludeSurveys>true</IncludeSurveys>
  <AncestorType>1</AncestorType>
  <Draft>true</Draft>
  <LinkedToID>ec8b3881-a15d-4490-b5be-b2a1e9259d2b</LinkedToID>
  <TeamMemberList>
    <TeamMember>
      <TaskID>55865d5a-899e-48ee-b825-151b4a603edf</TaskID>
      <IndividualID>14853fc5-0901-4206-b2b6-ff024b49b694</IndividualID>
      <RoleID>8d8a95a7-170d-4268-9bea-d356c6b5846b</RoleID>
      <HoursProjected>1</HoursProjected>
      <HoursActual>1</HoursActual>
      <ID>570dff14-1feb-466d-87fb-f0fd2591c1d6</ID>
      <RoleName>sample string 1</RoleName>
      <HoursActualRollup>1</HoursActualRollup>
      <HoursProjectedRollup>1</HoursProjectedRollup>
      <IndividualFullName>sample string 2</IndividualFullName>
      <Created>2025-04-18T09:25:01.8653086+00:00</Created>
      <CreatedBy>c0ca3d2b-b1f9-4930-a03f-545ee860f18f</CreatedBy>
      <SiteID>60c38438-14a7-446e-a120-f003fa75cd11</SiteID>
      <Updated>2025-04-18T09:25:01.8653086+00:00</Updated>
      <UpdatedBy>aae93420-d009-49fb-aa84-14b44b92b1be</UpdatedBy>
      <IndividualFullOrderedName>sample string 3</IndividualFullOrderedName>
      <RoleDescription>sample string 4</RoleDescription>
      <TeamSurvey>true</TeamSurvey>
    </TeamMember>
    <TeamMember>
      <TaskID>55865d5a-899e-48ee-b825-151b4a603edf</TaskID>
      <IndividualID>14853fc5-0901-4206-b2b6-ff024b49b694</IndividualID>
      <RoleID>8d8a95a7-170d-4268-9bea-d356c6b5846b</RoleID>
      <HoursProjected>1</HoursProjected>
      <HoursActual>1</HoursActual>
      <ID>570dff14-1feb-466d-87fb-f0fd2591c1d6</ID>
      <RoleName>sample string 1</RoleName>
      <HoursActualRollup>1</HoursActualRollup>
      <HoursProjectedRollup>1</HoursProjectedRollup>
      <IndividualFullName>sample string 2</IndividualFullName>
      <Created>2025-04-18T09:25:01.8653086+00:00</Created>
      <CreatedBy>c0ca3d2b-b1f9-4930-a03f-545ee860f18f</CreatedBy>
      <SiteID>60c38438-14a7-446e-a120-f003fa75cd11</SiteID>
      <Updated>2025-04-18T09:25:01.8653086+00:00</Updated>
      <UpdatedBy>aae93420-d009-49fb-aa84-14b44b92b1be</UpdatedBy>
      <IndividualFullOrderedName>sample string 3</IndividualFullOrderedName>
      <RoleDescription>sample string 4</RoleDescription>
      <TeamSurvey>true</TeamSurvey>
    </TeamMember>
  </TeamMemberList>
  <StatusName>sample string 18</StatusName>
  <StatusRank>1</StatusRank>
  <PhaseName>sample string 19</PhaseName>
  <PhaseRank>1</PhaseRank>
  <ColorName>sample string 20</ColorName>
  <ColorRank>1</ColorRank>
  <LinkedAncestorID>a6a1289d-3df9-4285-9f77-293e529d1d47</LinkedAncestorID>
  <LinkedToName>sample string 21</LinkedToName>
  <LinkedToRowType>1</LinkedToRowType>
  <LinkedAncestorName>sample string 22</LinkedAncestorName>
  <RowType>1</RowType>
  <RankPath>QEA=</RankPath>
  <OnTime>true</OnTime>
  <CanRead>true</CanRead>
  <CanUpdate>true</CanUpdate>
  <CanDelete>true</CanDelete>
  <CanDelegate>true</CanDelegate>
  <NearHighlight>1</NearHighlight>
</Project>

application/json, text/json

Sample
{
  "ID": "3582c638-1cac-4952-9960-bb88f71fdc9f",
  "ParentID": "b5047d23-e824-4687-b9a0-91e5f5f51417",
  "AncestorID": "dd9956ff-56de-443f-8cb9-c340ef69615b",
  "Rank": 1,
  "Color": "sample string 1",
  "HoursActual": 1.0,
  "HoursProjected": 1.0,
  "TrackingLabel": "sample string 6",
  "NearHighlightOverride": 1,
  "Name": "sample string 7",
  "Description": "sample string 8",
  "StatusID": 1,
  "PhaseID": 1,
  "AncestorName": "sample string 9",
  "RankOrder": "sample string 10",
  "DisplayRank": "sample string 11",
  "Level": 1,
  "SumHoursActual": 1.0,
  "SumHoursProjected": 1.0,
  "Status": "sample string 12",
  "Phase": "sample string 13",
  "Deleted": true,
  "DeletedByRef": true,
  "Created": "sample string 14",
  "CreatedBy": "b1b1d057-b1f8-4f33-b92d-e9a3b6292cad",
  "Updated": "2025-04-18T09:25:01.8653086+00:00",
  "UpdatedBy": "9d2b8b9b-d67e-479d-b335-a50cc5751f31",
  "TeamMembers": "sample string 15",
  "LastComment": "sample string 16",
  "LastCommentDate": "2025-04-18T09:25:01.8653086+00:00",
  "LastCommentByID": "c2a00a0f-ae36-4769-b60c-46d0f81b9cb8",
  "LastCommentBy": "sample string 17",
  "EndDateChanges": 1,
  "IncludeSurveys": true,
  "AncestorType": 1,
  "Draft": true,
  "LinkedToID": "ec8b3881-a15d-4490-b5be-b2a1e9259d2b",
  "TeamMemberList": [
    {
      "TaskID": "55865d5a-899e-48ee-b825-151b4a603edf",
      "IndividualID": "14853fc5-0901-4206-b2b6-ff024b49b694",
      "RoleID": "8d8a95a7-170d-4268-9bea-d356c6b5846b",
      "HoursProjected": 1.0,
      "HoursActual": 1.0,
      "ID": "570dff14-1feb-466d-87fb-f0fd2591c1d6",
      "RoleName": "sample string 1",
      "HoursActualRollup": 1.0,
      "HoursProjectedRollup": 1.0,
      "IndividualFullName": "sample string 2",
      "Created": "2025-04-18T09:25:01.8653086+00:00",
      "CreatedBy": "c0ca3d2b-b1f9-4930-a03f-545ee860f18f",
      "SiteID": "60c38438-14a7-446e-a120-f003fa75cd11",
      "Updated": "2025-04-18T09:25:01.8653086+00:00",
      "UpdatedBy": "aae93420-d009-49fb-aa84-14b44b92b1be",
      "IndividualFullOrderedName": "sample string 3",
      "RoleDescription": "sample string 4",
      "TeamSurvey": true
    },
    {
      "TaskID": "55865d5a-899e-48ee-b825-151b4a603edf",
      "IndividualID": "14853fc5-0901-4206-b2b6-ff024b49b694",
      "RoleID": "8d8a95a7-170d-4268-9bea-d356c6b5846b",
      "HoursProjected": 1.0,
      "HoursActual": 1.0,
      "ID": "570dff14-1feb-466d-87fb-f0fd2591c1d6",
      "RoleName": "sample string 1",
      "HoursActualRollup": 1.0,
      "HoursProjectedRollup": 1.0,
      "IndividualFullName": "sample string 2",
      "Created": "2025-04-18T09:25:01.8653086+00:00",
      "CreatedBy": "c0ca3d2b-b1f9-4930-a03f-545ee860f18f",
      "SiteID": "60c38438-14a7-446e-a120-f003fa75cd11",
      "Updated": "2025-04-18T09:25:01.8653086+00:00",
      "UpdatedBy": "aae93420-d009-49fb-aa84-14b44b92b1be",
      "IndividualFullOrderedName": "sample string 3",
      "RoleDescription": "sample string 4",
      "TeamSurvey": true
    }
  ],
  "StatusName": "sample string 18",
  "StatusRank": 1,
  "PhaseName": "sample string 19",
  "PhaseRank": 1,
  "ColorName": "sample string 20",
  "ColorRank": 1,
  "LinkedAncestorID": "a6a1289d-3df9-4285-9f77-293e529d1d47",
  "LinkedToName": "sample string 21",
  "LinkedToRowType": 1,
  "LinkedAncestorName": "sample string 22",
  "RowType": 1,
  "RankPath": "QEA=",
  "OnTime": true,
  "CanRead": true,
  "CanUpdate": true,
  "CanDelete": true,
  "CanDelegate": true,
  "NearHighlight": 1
}