Back

PUT teammembers/{id}

Update a team member.

Request Information

URI Parameters

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

Guid ID of the Team Member to be updated.

Body Parameters (TeamMember)

This object takes all the parameters needed to update a team member.

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

ID of the Project.
IndividualID globally unique identifier Required

ID of the user.
RoleID globally unique identifier Required

ID of the Team member's role.
HoursProjected decimal number Required

Number of hours this team member is projected to work on this project.
HoursActual decimal number Required

Number of hours this team member actually worked on this project.
ID globally unique identifier ReadOnly

ID of the Team Member.
RoleName string ReadOnly

Name of the team member's role.
HoursActualRollup decimal number ReadOnly

Sum of the actual number of hours spent on this project.
HoursProjectedRollup decimal number ReadOnly

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

Full name of the team member.
Created date ReadOnly

Date the team member was added to the project.
CreatedBy globally unique identifier ReadOnly

ID of the individual that created the team member.
SiteID globally unique identifier ReadOnly

ID of the site for the team member.
Updated date ReadOnly

Date the team member was last updated.
UpdatedBy globally unique identifier ReadOnly

ID of the individual that updated the team member.
IndividualFullOrderedName string ReadOnly

Full ordered name of the given team member.
RoleDescription string

Description of the team member's role on the project (Max 50 charactors)
TeamSurvey boolean

Set if Team Survey should be sent to the team member.

Request Formats

application/xml, text/xml

Sample
<TeamMember xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <TaskID>33589430-3db9-42c6-9af4-acf5bf8239a0</TaskID>
  <IndividualID>71581b7b-9795-43a5-bc9e-51cc99ace0f1</IndividualID>
  <RoleID>e406ffa4-c427-4314-9043-6d96d927004b</RoleID>
  <HoursProjected>1</HoursProjected>
  <HoursActual>1</HoursActual>
  <RoleDescription>sample string 4</RoleDescription>
  <TeamSurvey>true</TeamSurvey>
</TeamMember>

application/json, text/json

Sample
{
  "TaskID": "33589430-3db9-42c6-9af4-acf5bf8239a0",
  "IndividualID": "71581b7b-9795-43a5-bc9e-51cc99ace0f1",
  "RoleID": "e406ffa4-c427-4314-9043-6d96d927004b",
  "HoursProjected": 1.0,
  "HoursActual": 1.0,
  "RoleDescription": "sample string 4",
  "TeamSurvey": true
}

Response Information

Resource Description (TeamMember)

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

ID of the Project.
IndividualID globally unique identifier Required

ID of the user.
RoleID globally unique identifier Required

ID of the Team member's role.
HoursProjected decimal number Required

Number of hours this team member is projected to work on this project.
HoursActual decimal number Required

Number of hours this team member actually worked on this project.
ID globally unique identifier ReadOnly

ID of the Team Member.
RoleName string ReadOnly

Name of the team member's role.
HoursActualRollup decimal number ReadOnly

Sum of the actual number of hours spent on this project.
HoursProjectedRollup decimal number ReadOnly

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

Full name of the team member.
Created date ReadOnly

Date the team member was added to the project.
CreatedBy globally unique identifier ReadOnly

ID of the individual that created the team member.
SiteID globally unique identifier ReadOnly

ID of the site for the team member.
Updated date ReadOnly

Date the team member was last updated.
UpdatedBy globally unique identifier ReadOnly

ID of the individual that updated the team member.
IndividualFullOrderedName string ReadOnly

Full ordered name of the given team member.
RoleDescription string

Description of the team member's role on the project (Max 50 charactors)
TeamSurvey boolean

Set if Team Survey should be sent to the team member.

Response Formats

application/xml, text/xml

Sample
<TeamMember xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <TaskID>6f0d823b-8840-4dac-a3e4-f761690f2f37</TaskID>
  <IndividualID>ba5438cd-06bc-4026-a085-b4f0f347b8ad</IndividualID>
  <RoleID>b17befd5-276d-45b2-bcbb-28af72db5bc2</RoleID>
  <HoursProjected>1</HoursProjected>
  <HoursActual>1</HoursActual>
  <ID>40f1c0d0-2b3e-4530-bc25-024fb5891ef3</ID>
  <RoleName>sample string 1</RoleName>
  <HoursActualRollup>1</HoursActualRollup>
  <HoursProjectedRollup>1</HoursProjectedRollup>
  <IndividualFullName>sample string 2</IndividualFullName>
  <Created>2025-05-22T23:10:41.7653143+00:00</Created>
  <CreatedBy>bcbf2c8e-0c4a-425d-91aa-26ff1ce5b732</CreatedBy>
  <SiteID>308d9e12-7258-4a3c-aadd-57000dbbd419</SiteID>
  <Updated>2025-05-22T23:10:41.7653143+00:00</Updated>
  <UpdatedBy>6e2e06b2-f3b6-40fc-b97c-8c4ffc8f1ce1</UpdatedBy>
  <IndividualFullOrderedName>sample string 3</IndividualFullOrderedName>
  <RoleDescription>sample string 4</RoleDescription>
  <TeamSurvey>true</TeamSurvey>
</TeamMember>

application/json, text/json

Sample
{
  "TaskID": "6f0d823b-8840-4dac-a3e4-f761690f2f37",
  "IndividualID": "ba5438cd-06bc-4026-a085-b4f0f347b8ad",
  "RoleID": "b17befd5-276d-45b2-bcbb-28af72db5bc2",
  "HoursProjected": 1.0,
  "HoursActual": 1.0,
  "ID": "40f1c0d0-2b3e-4530-bc25-024fb5891ef3",
  "RoleName": "sample string 1",
  "HoursActualRollup": 1.0,
  "HoursProjectedRollup": 1.0,
  "IndividualFullName": "sample string 2",
  "Created": "2025-05-22T23:10:41.7653143+00:00",
  "CreatedBy": "bcbf2c8e-0c4a-425d-91aa-26ff1ce5b732",
  "SiteID": "308d9e12-7258-4a3c-aadd-57000dbbd419",
  "Updated": "2025-05-22T23:10:41.7653143+00:00",
  "UpdatedBy": "6e2e06b2-f3b6-40fc-b97c-8c4ffc8f1ce1",
  "IndividualFullOrderedName": "sample string 3",
  "RoleDescription": "sample string 4",
  "TeamSurvey": true
}