PUT individuals/{id}?tz={tz}

Request Information

URI Parameters

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

Name	Description
id `globally unique identifier` Required Guid ID of the individual to be updated.	`globally unique identifier` Required Guid ID of the individual to be updated.
tz `string` Optional parameter to set time zone information.	`string` Optional parameter to set time zone information.

Body Parameters (Individual)

This object takes all the parameters needed to update an individual.

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

Request Formats

application/xml, text/xml

Sample

<Individual xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>96257011-488e-4522-aec4-19815a6b32c0</ID>
  <IsAdmin>true</IsAdmin>
  <Prefix>sample string 1</Prefix>
  <Suffix>sample string 2</Suffix>
  <FirstName>sample string 3</FirstName>
  <LastName>sample string 4</LastName>
  <UserDefined1>sample string 5</UserDefined1>
  <UserDefined2>sample string 6</UserDefined2>
  <UserDefined3>sample string 7</UserDefined3>
  <UserDefined4>sample string 8</UserDefined4>
  <Email>sample string 9</Email>
  <PrimaryOrganizationID>69b1ef5f-c191-46d2-ae44-2ffbcb757a52</PrimaryOrganizationID>
  <PrimaryTitle>sample string 10</PrimaryTitle>
  <PrimaryReportsTo>1ee12f81-b558-45d7-938c-cbae9ec1dfc5</PrimaryReportsTo>
  <UserName>sample string 11</UserName>
  <Password>sample string 12</Password>
  <ParentID>63b764ef-562f-4456-9937-859890a799a5</ParentID>
  <Deleted>false</Deleted>
  <DeletedByRef>false</DeletedByRef>
  <UserEmail>sample string 19</UserEmail>
  <HireDate>2025-04-10T03:39:12.7076822+00:00</HireDate>
</Individual>

application/json, text/json

Sample

{
  "ID": "96257011-488e-4522-aec4-19815a6b32c0",
  "IsAdmin": true,
  "Prefix": "sample string 1",
  "Suffix": "sample string 2",
  "FirstName": "sample string 3",
  "LastName": "sample string 4",
  "UserDefined1": "sample string 5",
  "UserDefined2": "sample string 6",
  "UserDefined3": "sample string 7",
  "UserDefined4": "sample string 8",
  "Email": "sample string 9",
  "PrimaryOrganizationID": "69b1ef5f-c191-46d2-ae44-2ffbcb757a52",
  "PrimaryTitle": "sample string 10",
  "PrimaryReportsTo": "1ee12f81-b558-45d7-938c-cbae9ec1dfc5",
  "UserName": "sample string 11",
  "Password": "sample string 12",
  "ParentID": "63b764ef-562f-4456-9937-859890a799a5",
  "Deleted": false,
  "DeletedByRef": false,
  "UserEmail": "sample string 19",
  "HireDate": "2025-04-10T03:39:12.7076822+00:00"
}

Response Information

Resource Description (Individual)

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

Response Formats

application/xml, text/xml

Sample

<Individual xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>2b26744f-3800-4740-b44c-8d57baab7c90</ID>
  <SiteID>bdfdb7bc-a87c-49ee-8348-8d32b0d6d1d6</SiteID>
  <IsAdmin>true</IsAdmin>
  <UserID>49f8425d-5960-4de9-b421-7c8b8c949dcc</UserID>
  <Prefix>sample string 1</Prefix>
  <Suffix>sample string 2</Suffix>
  <FirstName>sample string 3</FirstName>
  <LastName>sample string 4</LastName>
  <UserDefined1>sample string 5</UserDefined1>
  <UserDefined2>sample string 6</UserDefined2>
  <UserDefined3>sample string 7</UserDefined3>
  <UserDefined4>sample string 8</UserDefined4>
  <Email>sample string 9</Email>
  <PrimaryOrganizationID>8e5df3a7-ec51-44bd-b979-969b88248568</PrimaryOrganizationID>
  <PrimaryTitle>sample string 10</PrimaryTitle>
  <PrimaryReportsTo>e93c0960-3f96-41a9-89b2-a18a12595ca7</PrimaryReportsTo>
  <UserName>sample string 11</UserName>
  <Password>sample string 12</Password>
  <ParentID>7325b545-78f3-4e72-9d28-bf9e4c5ddb8b</ParentID>
  <PrimaryOrganizationName>sample string 13</PrimaryOrganizationName>
  <FullName>sample string 14</FullName>
  <FormalName>sample string 15</FormalName>
  <FullOrderedName>sample string 16</FullOrderedName>
  <Deleted>true</Deleted>
  <DeletedByRef>true</DeletedByRef>
  <Created>2025-04-10T03:39:12.7076822+00:00</Created>
  <CreatedBy>08b6ef1c-a0ef-4d83-b092-5aba7c3e138e</CreatedBy>
  <Updated>2025-04-10T03:39:12.7076822+00:00</Updated>
  <UpdatedBy>1d05ff30-405c-4e63-a81a-8c641126beec</UpdatedBy>
  <IsGlobalAdmin>true</IsGlobalAdmin>
  <UserEmail>sample string 19</UserEmail>
  <LastComment>sample string 20</LastComment>
  <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-04-10T03:39:12.7076822Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </LastCommentDate>
  <LastCommentByID>171d01fc-ae4b-434b-9a56-c558e42d5c55</LastCommentByID>
  <LastCommentBy>sample string 21</LastCommentBy>
  <CanRead>true</CanRead>
  <CanUpdate>true</CanUpdate>
  <CanDelete>true</CanDelete>
  <CanDelegate>true</CanDelegate>
  <SendEvalSurvey>true</SendEvalSurvey>
  <HireDate>2025-04-10T03:39:12.7076822+00:00</HireDate>
</Individual>

application/json, text/json

Sample

{
  "ID": "2b26744f-3800-4740-b44c-8d57baab7c90",
  "SiteID": "bdfdb7bc-a87c-49ee-8348-8d32b0d6d1d6",
  "IsAdmin": true,
  "UserID": "49f8425d-5960-4de9-b421-7c8b8c949dcc",
  "Prefix": "sample string 1",
  "Suffix": "sample string 2",
  "FirstName": "sample string 3",
  "LastName": "sample string 4",
  "UserDefined1": "sample string 5",
  "UserDefined2": "sample string 6",
  "UserDefined3": "sample string 7",
  "UserDefined4": "sample string 8",
  "Email": "sample string 9",
  "PrimaryOrganizationID": "8e5df3a7-ec51-44bd-b979-969b88248568",
  "PrimaryTitle": "sample string 10",
  "PrimaryReportsTo": "e93c0960-3f96-41a9-89b2-a18a12595ca7",
  "UserName": "sample string 11",
  "Password": "sample string 12",
  "ParentID": "7325b545-78f3-4e72-9d28-bf9e4c5ddb8b",
  "PrimaryOrganizationName": "sample string 13",
  "FullName": "sample string 14",
  "FormalName": "sample string 15",
  "FullOrderedName": "sample string 16",
  "Deleted": true,
  "DeletedByRef": true,
  "Created": "2025-04-10T03:39:12.7076822+00:00",
  "CreatedBy": "08b6ef1c-a0ef-4d83-b092-5aba7c3e138e",
  "Updated": "2025-04-10T03:39:12.7076822+00:00",
  "UpdatedBy": "1d05ff30-405c-4e63-a81a-8c641126beec",
  "IsGlobalAdmin": true,
  "UserEmail": "sample string 19",
  "LastComment": "sample string 20",
  "LastCommentDate": "2025-04-10T03:39:12.7076822+00:00",
  "LastCommentByID": "171d01fc-ae4b-434b-9a56-c558e42d5c55",
  "LastCommentBy": "sample string 21",
  "CanRead": true,
  "CanUpdate": true,
  "CanDelete": true,
  "CanDelegate": true,
  "SendEvalSurvey": true,
  "HireDate": "2025-04-10T03:39:12.7076822+00:00"
}

Name	Description
ID `globally unique identifier` Required on Update ID of the given individual.	`globally unique identifier` Required on Update ID of the given individual.
SiteID `globally unique identifier` ReadOnly ID of the site for the given individual.	`globally unique identifier` ReadOnly ID of the site for the given individual.
IsAdmin `boolean` Administrator setting for the given individual.	`boolean` Administrator setting for the given individual.
UserID `globally unique identifier` ReadOnly User ID of the given individual.	`globally unique identifier` ReadOnly User ID of the given individual.
Prefix `string` Prefix of the given individual's name. (Max length 25 characters)	`string` Prefix of the given individual's name. (Max length 25 characters)
Suffix `string` Suffix of the given individual's name. (Max length 25 characters)	`string` Suffix of the given individual's name. (Max length 25 characters)
FirstName `string` Required First name of the given individual. (Max length 50 characters)	`string` Required First name of the given individual. (Max length 50 characters)
LastName `string` Required Last name of the given individual. (Max length 50 characters)	`string` Required Last name of the given individual. (Max length 50 characters)
UserDefined1 `string` User defined field one. (Max length 255 characters)	`string` User defined field one. (Max length 255 characters)
UserDefined2 `string` User defined field two. (Max length 255 characters)	`string` User defined field two. (Max length 255 characters)
UserDefined3 `string` User defined field three. (Max length 255 characters)	`string` User defined field three. (Max length 255 characters)
UserDefined4 `string` User defined field four. (Max length 255 characters)	`string` User defined field four. (Max length 255 characters)
Email `string` Required on Create Email address of the given individual. (Max length 255 characters)	`string` Required on Create Email address of the given individual. (Max length 255 characters)
PrimaryOrganizationID `globally unique identifier` Required on Create ID of the primary organization of the given individual.	`globally unique identifier` Required on Create ID of the primary organization of the given individual.
PrimaryTitle `string` Required on Create Title of the given individual. (Max length 255 characters)	`string` Required on Create Title of the given individual. (Max length 255 characters)
PrimaryReportsTo `globally unique identifier` Required on Create ID of the primary reports to person for the given individual.	`globally unique identifier` Required on Create ID of the primary reports to person for the given individual.
UserName `string` Required User name of the given individual. (Max length 255 characters)	`string` Required User name of the given individual. (Max length 255 characters)
Password `string` Password of the given individual(Used for create and update). (This varible has been Deprecated and may be removed at a later date.)	`string` Password of the given individual(Used for create and update). (This varible has been Deprecated and may be removed at a later date.)
ParentID `globally unique identifier` Required on Create Deprecated, this is no longer used and is always null.	`globally unique identifier` Required on Create Deprecated, this is no longer used and is always null.
PrimaryOrganizationName `string` ReadOnly Name of the primary organization for the given individual.	`string` ReadOnly Name of the primary organization for the given individual.
FullName `string` ReadOnly Full name of the given individual.	`string` ReadOnly Full name of the given individual.
FormalName `string` ReadOnly Formal name of the given individual.	`string` ReadOnly Formal name of the given individual.
FullOrderedName `string` ReadOnly Full ordered name of the given individual.	`string` ReadOnly Full ordered name of the given individual.
Deleted `boolean` ReadOnly Deleted status of the given individual.	`boolean` ReadOnly Deleted status of the given individual.
DeletedByRef `boolean` ReadOnly Deleted by reference status of the given individual.	`boolean` ReadOnly Deleted by reference status of the given individual.
Created `date` ReadOnly Date the given individual was created.	`date` ReadOnly Date the given individual was created.
CreatedBy `globally unique identifier` ReadOnly ID of the person that created the given individual.	`globally unique identifier` ReadOnly ID of the person that created the given individual.
Updated `date` ReadOnly Date the given individual was last updated.	`date` ReadOnly Date the given individual was last updated.
UpdatedBy `globally unique identifier` ReadOnly ID of the person that last updated the given individual.	`globally unique identifier` ReadOnly ID of the person that last updated the given individual.
IsGlobalAdmin `boolean` ReadOnly Global administrator setting for the given individual.	`boolean` ReadOnly Global administrator setting for the given individual.
UserEmail `string` Required on Create User email address of the given individual. (This varible has been Deprecated and may be removed at a later date.)	`string` Required on Create User email address of the given individual. (This varible has been Deprecated and may be removed at a later date.)
LastComment `string` ReadOnly Body of the most recent comment for the given individual.	`string` ReadOnly Body of the most recent comment for the given individual.
LastCommentDate `date` ReadOnly Date of the most recent comment for the given individual.	`date` ReadOnly Date of the most recent comment for the given individual.
LastCommentByID `globally unique identifier` ReadOnly ID of the individual who created the most recent comment for the given individual.	`globally unique identifier` ReadOnly ID of the individual who created the most recent comment for the given individual.
LastCommentBy `string` ReadOnly Name of the individual who created the most recent comment for the given individual.	`string` ReadOnly Name of the individual who created the most recent comment for the given individual.
CanRead `boolean` ReadOnly Read security setting for the individual based on the current logged in user.	`boolean` ReadOnly Read security setting for the individual based on the current logged in user.
CanUpdate `boolean` ReadOnly Update security setting for the individual based on the current logged in user.	`boolean` ReadOnly Update security setting for the individual based on the current logged in user.
CanDelete `boolean` ReadOnly Delete security setting for the individual based on the current logged in user.	`boolean` ReadOnly Delete security setting for the individual based on the current logged in user.
CanDelegate `boolean` ReadOnly Delegate security setting for the individual based on the current logged in user.	`boolean` ReadOnly Delegate security setting for the individual based on the current logged in user.
SendEvalSurvey `boolean` ReadOnly Send Individual Evaluation Surveys	`boolean` ReadOnly Send Individual Evaluation Surveys
HireDate `date` Date the given Individual was hired.	`date` Date the given Individual was hired.