PUT departments/{id}

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 organization or department to be updated.	`globally unique identifier` Required Guid ID of the organization or department to be updated.

Body Parameters (Organization)

This object takes all the parameters needed to update a department.

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

Request Formats

application/xml, text/xml

Sample

<Organization xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>62a87133-4175-4312-8467-05b3a5556603</ID>
  <SiteID>b79ae17d-cab6-4b8a-863c-75c05d4b388d</SiteID>
  <ParentID>fe234cc5-883f-4369-a821-61423e617485</ParentID>
  <Rank>1</Rank>
  <Name>sample string 1</Name>
  <EmotionalGoal>sample string 2</EmotionalGoal>
  <Focus>sample string 3</Focus>
  <Picture>QEA=</Picture>
</Organization>

application/json, text/json

Sample

{
  "ID": "62a87133-4175-4312-8467-05b3a5556603",
  "SiteID": "b79ae17d-cab6-4b8a-863c-75c05d4b388d",
  "ParentID": "fe234cc5-883f-4369-a821-61423e617485",
  "Rank": 1,
  "Name": "sample string 1",
  "EmotionalGoal": "sample string 2",
  "Focus": "sample string 3",
  "Picture": "QEA="
}

Response Information

Resource Description (Organization)

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

Response Formats

application/xml, text/xml

Sample

<Organization xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>3f47d3b5-a828-4ae3-9e68-68a05df1917d</ID>
  <SiteID>667edd0e-3f53-4b2b-8671-196544aa31e7</SiteID>
  <ParentID>dd3230c2-8428-4265-b4a3-2754095695c4</ParentID>
  <Rank>1</Rank>
  <Name>sample string 1</Name>
  <EmotionalGoal>sample string 2</EmotionalGoal>
  <Focus>sample string 3</Focus>
  <Picture>QEA=</Picture>
  <RowType>1</RowType>
  <RankPath>QEA=</RankPath>
  <RankOrder>sample string 4</RankOrder>
  <DisplayRank>sample string 5</DisplayRank>
  <Level>1</Level>
  <Values>sample string 6</Values>
  <Deleted>true</Deleted>
  <DeletedByRef>true</DeletedByRef>
  <Created>2025-02-14T16:53:59.9139975+00:00</Created>
  <CreatedBy>0b8d6e7a-ba10-4e9e-b019-6dbabb0e0189</CreatedBy>
  <Updated>2025-02-14T16:53:59.9139975+00:00</Updated>
  <UpdatedBy>ff64eaa3-d68f-4d85-8456-8e4f19e02598</UpdatedBy>
  <LastComment>sample string 7</LastComment>
  <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-02-14T16:53:59.9139975Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </LastCommentDate>
  <LastCommentByID>b0861d10-c5b7-4fb8-94c2-cb022860bdd3</LastCommentByID>
  <LastCommentBy>sample string 8</LastCommentBy>
  <ParentName>sample string 9</ParentName>
  <CanRead>true</CanRead>
  <CanUpdate>true</CanUpdate>
  <CanDelete>true</CanDelete>
  <CanDelegate>true</CanDelegate>
</Organization>

application/json, text/json

Sample

{
  "ID": "3f47d3b5-a828-4ae3-9e68-68a05df1917d",
  "SiteID": "667edd0e-3f53-4b2b-8671-196544aa31e7",
  "ParentID": "dd3230c2-8428-4265-b4a3-2754095695c4",
  "Rank": 1,
  "Name": "sample string 1",
  "EmotionalGoal": "sample string 2",
  "Focus": "sample string 3",
  "Picture": "QEA=",
  "RowType": 1,
  "RankPath": "QEA=",
  "RankOrder": "sample string 4",
  "DisplayRank": "sample string 5",
  "Level": 1,
  "Values": "sample string 6",
  "Deleted": true,
  "DeletedByRef": true,
  "Created": "2025-02-14T16:53:59.9139975+00:00",
  "CreatedBy": "0b8d6e7a-ba10-4e9e-b019-6dbabb0e0189",
  "Updated": "2025-02-14T16:53:59.9139975+00:00",
  "UpdatedBy": "ff64eaa3-d68f-4d85-8456-8e4f19e02598",
  "LastComment": "sample string 7",
  "LastCommentDate": "2025-02-14T16:53:59.9139975+00:00",
  "LastCommentByID": "b0861d10-c5b7-4fb8-94c2-cb022860bdd3",
  "LastCommentBy": "sample string 8",
  "ParentName": "sample string 9",
  "CanRead": true,
  "CanUpdate": true,
  "CanDelete": true,
  "CanDelegate": true
}

Name	Description
ID `globally unique identifier` Required on Update ID of the given organization/department.	`globally unique identifier` Required on Update ID of the given organization/department.
SiteID `globally unique identifier` ID of the site for the given organization/department.	`globally unique identifier` ID of the site for the given organization/department.
ParentID `globally unique identifier` ID of the parent for the given organization/department. This will be a site ID for a given organization or an organization ID for a given department.	`globally unique identifier` ID of the parent for the given organization/department. This will be a site ID for a given organization or an organization ID for a given department.
Rank `integer` Required Rank of the given organization/department.	`integer` Required Rank of the given organization/department.
Name `string` Required Name of the given organization/department. (Max length 100 characters)	`string` Required Name of the given organization/department. (Max length 100 characters)
EmotionalGoal `string` Emotional Goal of the given organization/department. (Max length 1000 characters)	`string` Emotional Goal of the given organization/department. (Max length 1000 characters)
Focus `string` Focus of the given organization/department.	`string` Focus of the given organization/department.
Picture `Collection of byte` Picture of the given organization/department.	`Collection of byte` Picture of the given organization/department.
RowType `integer` ReadOnly RowType of the given organization(4) or department(56).	`integer` ReadOnly RowType of the given organization(4) or department(56).
RankPath `Collection of byte` ReadOnly Current rank of the given Organization/Department in a byte array.	`Collection of byte` ReadOnly Current rank of the given Organization/Department in a byte array.
RankOrder `string` ReadOnly Rank in string format, (0001.0001.0001) for the given organization/department.	`string` ReadOnly Rank in string format, (0001.0001.0001) for the given organization/department.
DisplayRank `string` ReadOnly Rank that is actually displayed.	`string` ReadOnly Rank that is actually displayed.
Level `integer` ReadOnly Number of indent levels, Ex: 1 = 1, 1.1 = 2, 1.1.1 = 3	`integer` ReadOnly Number of indent levels, Ex: 1 = 1, 1.1 = 2, 1.1.1 = 3
Values `string` ReadOnly Value of the given organization/department.	`string` ReadOnly Value of the given organization/department.
Deleted `boolean` ReadOnly Deleted status of the given organization/department.	`boolean` ReadOnly Deleted status of the given organization/department.
DeletedByRef `boolean` ReadOnly Deleted by reference status of the given organization/department.	`boolean` ReadOnly Deleted by reference status of the given organization/department.
Created `date` ReadOnly Date the given organization/department was created.	`date` ReadOnly Date the given organization/department was created.
CreatedBy `globally unique identifier` ReadOnly ID of the individual who created the given organization/department.	`globally unique identifier` ReadOnly ID of the individual who created the given organization/department.
Updated `date` ReadOnly The date that the given organization/department was last updated.	`date` ReadOnly The date that the given organization/department was last updated.
UpdatedBy `globally unique identifier` ReadOnly The ID of the individual that updated the given organization/department.	`globally unique identifier` ReadOnly The ID of the individual that updated the given organization/department.
LastComment `string` ReadOnly Body of the most recent comment.	`string` ReadOnly Body of the most recent comment.
LastCommentDate `date` ReadOnly Date the most recent comment was posted.	`date` ReadOnly Date the most recent comment was posted.
LastCommentByID `globally unique identifier` ReadOnly ID of the user who posted the most recent comment.	`globally unique identifier` ReadOnly ID of the user who posted the most recent comment.
LastCommentBy `string` ReadOnly Name of the user who posted the most recent comment.	`string` ReadOnly Name of the user who posted the most recent comment.
ParentName `string` ReadOnly Name of the parent for the given Organization/Department. This will be a site for a given organization or an organization for a given department.	`string` ReadOnly Name of the parent for the given Organization/Department. This will be a site for a given organization or an organization for a given department.
CanRead `boolean` ReadOnly Read security setting for the object based on the current logged in user.	`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.	`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.	`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.	`boolean` ReadOnly Delegate security setting for the object based on the current logged in user.