Create a new metric.
None.
This object takes all the parameters needed to create a new metric.
System.Collections.ObjectModel.Collection`1[Connections.API.Areas.HelpPage.ModelDescriptions.ParameterDescription] IList
ID
globally unique identifier
Required on Update
ID of the given metric. |
ParentID
globally unique identifier
ID of the parent for the given metric. |
AncestorID
globally unique identifier
Required on Create
ID of the ancestor for the given metric; organization, department, project, or individual. |
Rank
integer
Required
Rank of the given metric. |
Name
string
Required
Name of the given metric. (Max length 255 characters) |
Description
string
Required
Description of the given metric. |
Format
string
Format of the number for the trend value. Examples can be found https://connectionsonline.zendesk.com/entries/21843291-Formatting-Metric-Examples. (Max length 255 characters, Default '0.#') |
Color
string
Hex value of the color for the given metric. |
TColor1
string
First threshold hex value of the color for the given metric. (Max length 6 characters) |
TColor2
string
Second threshold hex value of the color for the given metric. (Max length 6 characters) |
TColor3
string
Third threshold hex value of the color for the given metric. (Max length 6 characters) |
TColor4
string
Fourth threshold hex value of the color for the given metric. (Max length 6 characters) |
Threshold1
decimal number
First Threshold of the given metric. |
Threshold2
decimal number
Second threshold of the given metric. |
Threshold3
decimal number
Third threshold of the given metric. |
ColorByValue
boolean
Color of the given metric. |
Is8020
boolean
80/20 setting of the given metric. |
SiteID
globally unique identifier
ReadOnly
ID of the site for the given metric. |
AncestorType
integer
ReadOnly
Type of the ancestor for the metric; organization, project, or individual. |
AncestorName
string
ReadOnly
Name of the ancestor for the given metric. |
Deleted
boolean
ReadOnly
Deleted status of the given metric. |
DeletedByRef
boolean
ReadOnly
Deleted by Ref status of the given metric. |
Level
integer
ReadOnly
Number of indent levels, Ex: 1 = 1, 1.1 = 2, 1.1.1 = 3 |
DisplayRank
string
ReadOnly
Rank that is displayed to the user. |
RankPath
Collection of byte
ReadOnly
Current rank of the given metric in a byte array. |
RankOrder
string
ReadOnly
Rank in string format, (0001.0001.0001) for the given organization/department. |
Created
date
ReadOnly
Date the given metric was created. |
CreatedBy
globally unique identifier
ReadOnly
ID of the individual who created the given metric. |
Updated
date
ReadOnly
Date the given metric was updated. |
UpdatedBy
globally unique identifier
ReadOnly
ID of the individual who updated the given metric. |
DisplayColor
string
ReadOnly
Display color hex value entered for the given metric. |
DisplayColorRank
integer
ReadOnly
Rank of the display color for the given metric. Based on either the current value/threshold or the custom entered color. |
LatestDate
date
ReadOnly
Latest date a value was entered for the given metric. |
LatestValue
decimal number
ReadOnly
Latest value of the given metric. |
LatestValueColor
string
ReadOnly
Latest color hex value for the given metric, based on the current value. |
LatestComment
string
ReadOnly
(Deprecated, replaced with LastComment) Latest comment of the metric. |
Owners
string
ReadOnly
Owners of the given metric. |
FormattedThreshold1
string
ReadOnly
Minimum threshold of the given metric, formatted using the Format value. |
FormattedThreshold2
string
ReadOnly
Meets threshold of the given metric, formatted using the Format value. |
FormattedThreshold3
string
ReadOnly
Exceeds threshold of the given metric, formatted using the Format value. |
FormattedLatestValue
string
ReadOnly
Current value of the given metric formatted using the Format value. |
LastComment
string
ReadOnly
Body of the most recent comment on the given metric. |
LastCommentDate
date
ReadOnly
Post date of the most recent comment on the given metric. |
LastCommentByID
globally unique identifier
ReadOnly
User ID of the individual who posted the most recent comment on the given metric. |
LastCommentBy
string
ReadOnly
Name of the individual who posted the most recent comment on the given metric. |
DisplayColorName
string
ReadOnly
Name of the color to be displayed. |
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. |
ColorRank
integer
ReadOnly
Rank of the color assigned to the given metric. |
ColorName
string
ReadOnly
Name of the color to assigned to the given metric. |
OwnerList Collection of MetricOwner ReadOnly |
RollUp
integer
ReadOnly
Roll up status of a metric. 0 = Normal, 1 = Sum Roll up, 3 = Average Roll up |
LinkedToID
globally unique identifier
ReadOnly
ID of the Linked Metric |
<Metric xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4"> <ID>ef20c54b-6c2a-4e9e-9c88-9097472165a8</ID> <ParentID>e7d67d29-017e-40ea-887c-524fec872a6b</ParentID> <AncestorID>85b7e4f9-c6eb-43a2-b341-740c5d9de9c0</AncestorID> <Rank>1</Rank> <Name>sample string 2</Name> <Description>sample string 3</Description> <Format>sample string 4</Format> <Color>sample string 5</Color> <TColor1>sample string 6</TColor1> <TColor2>sample string 7</TColor2> <TColor3>sample string 8</TColor3> <TColor4>sample string 9</TColor4> <Threshold1>1</Threshold1> <Threshold2>1</Threshold2> <Threshold3>1</Threshold3> <ColorByValue>true</ColorByValue> <Is8020>true</Is8020> <Deleted>true</Deleted> <DeletedByRef>true</DeletedByRef> <Level>1</Level> <DisplayRank>sample string 11</DisplayRank> <RankPath>QEA=</RankPath> <RankOrder>sample string 12</RankOrder> <Created>2025-10-01T11:29:59.2139707+00:00</Created> <CreatedBy>b9380ecc-fb6c-4043-8cd7-728c987b7753</CreatedBy> <Updated>2025-10-01T11:29:59.2139707+00:00</Updated> <UpdatedBy>88259326-dca5-432a-9d53-b55e6f7406bf</UpdatedBy> <DisplayColor>sample string 13</DisplayColor> <DisplayColorRank>1</DisplayColorRank> <LatestDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-10-01T11:29:59.2139707Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </LatestDate> <LatestValue>1</LatestValue> <LatestValueColor>sample string 14</LatestValueColor> <LatestComment>sample string 15</LatestComment> <Owners>sample string 16</Owners> <FormattedThreshold1>sample string 17</FormattedThreshold1> <FormattedThreshold2>sample string 18</FormattedThreshold2> <FormattedThreshold3>sample string 19</FormattedThreshold3> <FormattedLatestValue>sample string 20</FormattedLatestValue> <LastComment>sample string 21</LastComment> <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-10-01T11:29:59.2139707Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </LastCommentDate> <LastCommentByID>11ab2de0-cd49-40b4-a609-489a3696f228</LastCommentByID> <LastCommentBy>sample string 22</LastCommentBy> <DisplayColorName>sample string 23</DisplayColorName> <CanRead>true</CanRead> <CanUpdate>true</CanUpdate> <CanDelete>true</CanDelete> <CanDelegate>true</CanDelegate> <ColorRank>1</ColorRank> <ColorName>sample string 24</ColorName> <OwnerList> <MetricOwner> <MetricID>532d2637-00db-453f-b281-328cdfbefd13</MetricID> <IndividualID>a6907785-2429-468e-9f1c-a4905df5a6a6</IndividualID> <ID>3d8342b0-4798-419f-af9a-fece53966c84</ID> <MetricName>sample string 1</MetricName> <FirstName>sample string 2</FirstName> <LastName>sample string 3</LastName> <FullName>sample string 4</FullName> <Email>sample string 5</Email> <SiteID>17969eb5-0688-41d7-b81a-60bf48452c73</SiteID> </MetricOwner> <MetricOwner> <MetricID>532d2637-00db-453f-b281-328cdfbefd13</MetricID> <IndividualID>a6907785-2429-468e-9f1c-a4905df5a6a6</IndividualID> <ID>3d8342b0-4798-419f-af9a-fece53966c84</ID> <MetricName>sample string 1</MetricName> <FirstName>sample string 2</FirstName> <LastName>sample string 3</LastName> <FullName>sample string 4</FullName> <Email>sample string 5</Email> <SiteID>17969eb5-0688-41d7-b81a-60bf48452c73</SiteID> </MetricOwner> </OwnerList> <RollUp>25</RollUp> <LinkedToID>65840d0b-8bad-4ea9-937e-8d2f9f4b44ac</LinkedToID> </Metric>
{ "ID": "ef20c54b-6c2a-4e9e-9c88-9097472165a8", "ParentID": "e7d67d29-017e-40ea-887c-524fec872a6b", "AncestorID": "85b7e4f9-c6eb-43a2-b341-740c5d9de9c0", "Rank": 1, "Name": "sample string 2", "Description": "sample string 3", "Format": "sample string 4", "Color": "sample string 5", "TColor1": "sample string 6", "TColor2": "sample string 7", "TColor3": "sample string 8", "TColor4": "sample string 9", "Threshold1": 1.0, "Threshold2": 1.0, "Threshold3": 1.0, "ColorByValue": true, "Is8020": true, "Deleted": true, "DeletedByRef": true, "Level": 1, "DisplayRank": "sample string 11", "RankPath": "QEA=", "RankOrder": "sample string 12", "Created": "2025-10-01T11:29:59.2139707+00:00", "CreatedBy": "b9380ecc-fb6c-4043-8cd7-728c987b7753", "Updated": "2025-10-01T11:29:59.2139707+00:00", "UpdatedBy": "88259326-dca5-432a-9d53-b55e6f7406bf", "DisplayColor": "sample string 13", "DisplayColorRank": 1, "LatestDate": "2025-10-01T11:29:59.2139707+00:00", "LatestValue": 1.0, "LatestValueColor": "sample string 14", "LatestComment": "sample string 15", "Owners": "sample string 16", "FormattedThreshold1": "sample string 17", "FormattedThreshold2": "sample string 18", "FormattedThreshold3": "sample string 19", "FormattedLatestValue": "sample string 20", "LastComment": "sample string 21", "LastCommentDate": "2025-10-01T11:29:59.2139707+00:00", "LastCommentByID": "11ab2de0-cd49-40b4-a609-489a3696f228", "LastCommentBy": "sample string 22", "DisplayColorName": "sample string 23", "CanRead": true, "CanUpdate": true, "CanDelete": true, "CanDelegate": true, "ColorRank": 1, "ColorName": "sample string 24", "OwnerList": [ { "MetricID": "532d2637-00db-453f-b281-328cdfbefd13", "IndividualID": "a6907785-2429-468e-9f1c-a4905df5a6a6", "ID": "3d8342b0-4798-419f-af9a-fece53966c84", "MetricName": "sample string 1", "FirstName": "sample string 2", "LastName": "sample string 3", "FullName": "sample string 4", "Email": "sample string 5", "SiteID": "17969eb5-0688-41d7-b81a-60bf48452c73" }, { "MetricID": "532d2637-00db-453f-b281-328cdfbefd13", "IndividualID": "a6907785-2429-468e-9f1c-a4905df5a6a6", "ID": "3d8342b0-4798-419f-af9a-fece53966c84", "MetricName": "sample string 1", "FirstName": "sample string 2", "LastName": "sample string 3", "FullName": "sample string 4", "Email": "sample string 5", "SiteID": "17969eb5-0688-41d7-b81a-60bf48452c73" } ], "RollUp": 25, "LinkedToID": "65840d0b-8bad-4ea9-937e-8d2f9f4b44ac" }
ID
globally unique identifier
Required on Update
ID of the given metric. |
ParentID
globally unique identifier
ID of the parent for the given metric. |
AncestorID
globally unique identifier
Required on Create
ID of the ancestor for the given metric; organization, department, project, or individual. |
Rank
integer
Required
Rank of the given metric. |
Name
string
Required
Name of the given metric. (Max length 255 characters) |
Description
string
Required
Description of the given metric. |
Format
string
Format of the number for the trend value. Examples can be found https://connectionsonline.zendesk.com/entries/21843291-Formatting-Metric-Examples. (Max length 255 characters, Default '0.#') |
Color
string
Hex value of the color for the given metric. |
TColor1
string
First threshold hex value of the color for the given metric. (Max length 6 characters) |
TColor2
string
Second threshold hex value of the color for the given metric. (Max length 6 characters) |
TColor3
string
Third threshold hex value of the color for the given metric. (Max length 6 characters) |
TColor4
string
Fourth threshold hex value of the color for the given metric. (Max length 6 characters) |
Threshold1
decimal number
First Threshold of the given metric. |
Threshold2
decimal number
Second threshold of the given metric. |
Threshold3
decimal number
Third threshold of the given metric. |
ColorByValue
boolean
Color of the given metric. |
Is8020
boolean
80/20 setting of the given metric. |
SiteID
globally unique identifier
ReadOnly
ID of the site for the given metric. |
AncestorType
integer
ReadOnly
Type of the ancestor for the metric; organization, project, or individual. |
AncestorName
string
ReadOnly
Name of the ancestor for the given metric. |
Deleted
boolean
ReadOnly
Deleted status of the given metric. |
DeletedByRef
boolean
ReadOnly
Deleted by Ref status of the given metric. |
Level
integer
ReadOnly
Number of indent levels, Ex: 1 = 1, 1.1 = 2, 1.1.1 = 3 |
DisplayRank
string
ReadOnly
Rank that is displayed to the user. |
RankPath
Collection of byte
ReadOnly
Current rank of the given metric in a byte array. |
RankOrder
string
ReadOnly
Rank in string format, (0001.0001.0001) for the given organization/department. |
Created
date
ReadOnly
Date the given metric was created. |
CreatedBy
globally unique identifier
ReadOnly
ID of the individual who created the given metric. |
Updated
date
ReadOnly
Date the given metric was updated. |
UpdatedBy
globally unique identifier
ReadOnly
ID of the individual who updated the given metric. |
DisplayColor
string
ReadOnly
Display color hex value entered for the given metric. |
DisplayColorRank
integer
ReadOnly
Rank of the display color for the given metric. Based on either the current value/threshold or the custom entered color. |
LatestDate
date
ReadOnly
Latest date a value was entered for the given metric. |
LatestValue
decimal number
ReadOnly
Latest value of the given metric. |
LatestValueColor
string
ReadOnly
Latest color hex value for the given metric, based on the current value. |
LatestComment
string
ReadOnly
(Deprecated, replaced with LastComment) Latest comment of the metric. |
Owners
string
ReadOnly
Owners of the given metric. |
FormattedThreshold1
string
ReadOnly
Minimum threshold of the given metric, formatted using the Format value. |
FormattedThreshold2
string
ReadOnly
Meets threshold of the given metric, formatted using the Format value. |
FormattedThreshold3
string
ReadOnly
Exceeds threshold of the given metric, formatted using the Format value. |
FormattedLatestValue
string
ReadOnly
Current value of the given metric formatted using the Format value. |
LastComment
string
ReadOnly
Body of the most recent comment on the given metric. |
LastCommentDate
date
ReadOnly
Post date of the most recent comment on the given metric. |
LastCommentByID
globally unique identifier
ReadOnly
User ID of the individual who posted the most recent comment on the given metric. |
LastCommentBy
string
ReadOnly
Name of the individual who posted the most recent comment on the given metric. |
DisplayColorName
string
ReadOnly
Name of the color to be displayed. |
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. |
ColorRank
integer
ReadOnly
Rank of the color assigned to the given metric. |
ColorName
string
ReadOnly
Name of the color to assigned to the given metric. |
OwnerList Collection of MetricOwner ReadOnly |
RollUp
integer
ReadOnly
Roll up status of a metric. 0 = Normal, 1 = Sum Roll up, 3 = Average Roll up |
LinkedToID
globally unique identifier
ReadOnly
ID of the Linked Metric |
<Metric xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4"> <ID>0c1fbb51-da12-459b-a3d5-83370c309ee8</ID> <ParentID>63b9a964-a2dd-4009-b333-f3894e1aedbc</ParentID> <AncestorID>63da4de5-400a-4302-ac4a-84e19b888daa</AncestorID> <Rank>1</Rank> <Name>sample string 2</Name> <Description>sample string 3</Description> <Format>sample string 4</Format> <Color>sample string 5</Color> <TColor1>sample string 6</TColor1> <TColor2>sample string 7</TColor2> <TColor3>sample string 8</TColor3> <TColor4>sample string 9</TColor4> <Threshold1>1</Threshold1> <Threshold2>1</Threshold2> <Threshold3>1</Threshold3> <ColorByValue>true</ColorByValue> <Is8020>true</Is8020> <SiteID>2f7bfd1a-50b1-4274-94a1-e5452d539761</SiteID> <AncestorType>1</AncestorType> <AncestorName>sample string 10</AncestorName> <Deleted>true</Deleted> <DeletedByRef>true</DeletedByRef> <Level>1</Level> <DisplayRank>sample string 11</DisplayRank> <RankPath>QEA=</RankPath> <RankOrder>sample string 12</RankOrder> <Created>2025-10-01T11:29:59.2265946+00:00</Created> <CreatedBy>530e12a2-9459-43dc-bd68-829260c5a6e1</CreatedBy> <Updated>2025-10-01T11:29:59.2265946+00:00</Updated> <UpdatedBy>d39e305e-9c6a-43b0-882e-2476fef10d18</UpdatedBy> <DisplayColor>sample string 13</DisplayColor> <DisplayColorRank>1</DisplayColorRank> <LatestDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-10-01T11:29:59.2265946Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </LatestDate> <LatestValue>1</LatestValue> <LatestValueColor>sample string 14</LatestValueColor> <LatestComment>sample string 15</LatestComment> <Owners>sample string 16</Owners> <FormattedThreshold1>sample string 17</FormattedThreshold1> <FormattedThreshold2>sample string 18</FormattedThreshold2> <FormattedThreshold3>sample string 19</FormattedThreshold3> <FormattedLatestValue>sample string 20</FormattedLatestValue> <LastComment>sample string 21</LastComment> <LastCommentDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System"> <d2p1:DateTime>2025-10-01T11:29:59.2265946Z</d2p1:DateTime> <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes> </LastCommentDate> <LastCommentByID>b24c7a3a-a48d-43e0-9b45-761d155350f4</LastCommentByID> <LastCommentBy>sample string 22</LastCommentBy> <DisplayColorName>sample string 23</DisplayColorName> <CanRead>true</CanRead> <CanUpdate>true</CanUpdate> <CanDelete>true</CanDelete> <CanDelegate>true</CanDelegate> <ColorRank>1</ColorRank> <ColorName>sample string 24</ColorName> <OwnerList> <MetricOwner> <MetricID>e29f4589-4559-4a8d-a758-db517b306373</MetricID> <IndividualID>505c6b18-30c9-44eb-b658-c7cd838a0021</IndividualID> <ID>24f29e05-1b2e-49a3-84ce-ba75556dde57</ID> <MetricName>sample string 1</MetricName> <FirstName>sample string 2</FirstName> <LastName>sample string 3</LastName> <FullName>sample string 4</FullName> <Email>sample string 5</Email> <SiteID>19047ab4-403d-4c74-b6ba-0a0a6ca9dd7c</SiteID> </MetricOwner> <MetricOwner> <MetricID>e29f4589-4559-4a8d-a758-db517b306373</MetricID> <IndividualID>505c6b18-30c9-44eb-b658-c7cd838a0021</IndividualID> <ID>24f29e05-1b2e-49a3-84ce-ba75556dde57</ID> <MetricName>sample string 1</MetricName> <FirstName>sample string 2</FirstName> <LastName>sample string 3</LastName> <FullName>sample string 4</FullName> <Email>sample string 5</Email> <SiteID>19047ab4-403d-4c74-b6ba-0a0a6ca9dd7c</SiteID> </MetricOwner> </OwnerList> <RollUp>25</RollUp> <LinkedToID>6dfef025-76c7-4f97-9aec-3f90a3592e4f</LinkedToID> </Metric>
{ "ID": "0c1fbb51-da12-459b-a3d5-83370c309ee8", "ParentID": "63b9a964-a2dd-4009-b333-f3894e1aedbc", "AncestorID": "63da4de5-400a-4302-ac4a-84e19b888daa", "Rank": 1, "Name": "sample string 2", "Description": "sample string 3", "Format": "sample string 4", "Color": "sample string 5", "TColor1": "sample string 6", "TColor2": "sample string 7", "TColor3": "sample string 8", "TColor4": "sample string 9", "Threshold1": 1.0, "Threshold2": 1.0, "Threshold3": 1.0, "ColorByValue": true, "Is8020": true, "SiteID": "2f7bfd1a-50b1-4274-94a1-e5452d539761", "AncestorType": 1, "AncestorName": "sample string 10", "Deleted": true, "DeletedByRef": true, "Level": 1, "DisplayRank": "sample string 11", "RankPath": "QEA=", "RankOrder": "sample string 12", "Created": "2025-10-01T11:29:59.2265946+00:00", "CreatedBy": "530e12a2-9459-43dc-bd68-829260c5a6e1", "Updated": "2025-10-01T11:29:59.2265946+00:00", "UpdatedBy": "d39e305e-9c6a-43b0-882e-2476fef10d18", "DisplayColor": "sample string 13", "DisplayColorRank": 1, "LatestDate": "2025-10-01T11:29:59.2265946+00:00", "LatestValue": 1.0, "LatestValueColor": "sample string 14", "LatestComment": "sample string 15", "Owners": "sample string 16", "FormattedThreshold1": "sample string 17", "FormattedThreshold2": "sample string 18", "FormattedThreshold3": "sample string 19", "FormattedLatestValue": "sample string 20", "LastComment": "sample string 21", "LastCommentDate": "2025-10-01T11:29:59.2265946+00:00", "LastCommentByID": "b24c7a3a-a48d-43e0-9b45-761d155350f4", "LastCommentBy": "sample string 22", "DisplayColorName": "sample string 23", "CanRead": true, "CanUpdate": true, "CanDelete": true, "CanDelegate": true, "ColorRank": 1, "ColorName": "sample string 24", "OwnerList": [ { "MetricID": "e29f4589-4559-4a8d-a758-db517b306373", "IndividualID": "505c6b18-30c9-44eb-b658-c7cd838a0021", "ID": "24f29e05-1b2e-49a3-84ce-ba75556dde57", "MetricName": "sample string 1", "FirstName": "sample string 2", "LastName": "sample string 3", "FullName": "sample string 4", "Email": "sample string 5", "SiteID": "19047ab4-403d-4c74-b6ba-0a0a6ca9dd7c" }, { "MetricID": "e29f4589-4559-4a8d-a758-db517b306373", "IndividualID": "505c6b18-30c9-44eb-b658-c7cd838a0021", "ID": "24f29e05-1b2e-49a3-84ce-ba75556dde57", "MetricName": "sample string 1", "FirstName": "sample string 2", "LastName": "sample string 3", "FullName": "sample string 4", "Email": "sample string 5", "SiteID": "19047ab4-403d-4c74-b6ba-0a0a6ca9dd7c" } ], "RollUp": 25, "LinkedToID": "6dfef025-76c7-4f97-9aec-3f90a3592e4f" }