PUT metrics/{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 metric to be updated.	`globally unique identifier` Required Guid ID of the metric to be updated.
tz `string`	`string`

Body Parameters (Metric)

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

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

Request Formats

application/xml, text/xml

Sample

<Metric xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>dc829871-b2b4-4e2b-9a9d-77745e4488ac</ID>
  <ParentID>648be67d-616d-482c-8adb-525f8789c97a</ParentID>
  <AncestorID>d92b4dd2-328c-45da-9404-00d4e694a618</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>
  <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>2024-10-23T22:07:52.480667Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </LastCommentDate>
  <LastCommentByID>aeef108e-bff3-410d-961e-44250dcb7523</LastCommentByID>
  <LastCommentBy>sample string 22</LastCommentBy>
  <DisplayColorName>sample string 23</DisplayColorName>
  <ColorName>sample string 24</ColorName>
  <OwnerList>
    <MetricOwner>
      <MetricID>9a283922-b825-445c-a0e4-771ed6a9bad7</MetricID>
      <IndividualID>06b5a6c3-ad57-41cb-90eb-dfa8e651a33e</IndividualID>
    </MetricOwner>
    <MetricOwner>
      <MetricID>9a283922-b825-445c-a0e4-771ed6a9bad7</MetricID>
      <IndividualID>06b5a6c3-ad57-41cb-90eb-dfa8e651a33e</IndividualID>
    </MetricOwner>
  </OwnerList>
  <RollUp>25</RollUp>
  <LinkedToID>b4b02d42-ccdc-40c6-9afa-8b36279f43e9</LinkedToID>
</Metric>

application/json, text/json

Sample

{"ID":"dc829871-b2b4-4e2b-9a9d-77745e4488ac","ParentID":"648be67d-616d-482c-8adb-525f8789c97a","AncestorID":"d92b4dd2-328c-45da-9404-00d4e694a618","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,"FormattedThreshold1":"sample string 17","FormattedThreshold2":"sample string 18","FormattedThreshold3":"sample string 19","FormattedLatestValue":"sample string 20","LastComment":"sample string 21","LastCommentDate":"2024-10-23T22:07:52.480667+00:00","LastCommentByID":"aeef108e-bff3-410d-961e-44250dcb7523","LastCommentBy":"sample string 22","DisplayColorName":"sample string 23","ColorName":"sample string 24","OwnerList":[{"MetricID":"9a283922-b825-445c-a0e4-771ed6a9bad7","IndividualID":"06b5a6c3-ad57-41cb-90eb-dfa8e651a33e","IndividualID":"06b5a6c3-ad57-41cb-90eb-dfa8e651a33e","RollUp":25,"LinkedToID":"b4b02d42-ccdc-40c6-9afa-8b36279f43e9"}

Response Information

Resource Description (Metric)

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

Response Formats

application/xml, text/xml

Sample

<Metric xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>55e533bd-4cba-4c37-a582-4add79f581d5</ID>
  <ParentID>c518e6ad-2aee-466e-bf15-645dbd5819b3</ParentID>
  <AncestorID>2b2b0a13-043b-45ec-8b8e-0dcb7961e0f4</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>67532c47-71a7-4df5-bd6c-e61c485b49ce</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>2024-10-23T22:07:52.5119194+00:00</Created>
  <CreatedBy>a06b5aa1-f2a3-4963-b736-43b302c3fdbc</CreatedBy>
  <Updated>2024-10-23T22:07:52.5119194+00:00</Updated>
  <UpdatedBy>ea05c2a8-a73f-4364-b4c9-127d6df19fc3</UpdatedBy>
  <DisplayColor>sample string 13</DisplayColor>
  <DisplayColorRank>1</DisplayColorRank>
  <LatestDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2024-10-23T22:07:52.5119194Z</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>2024-10-23T22:07:52.5119194Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </LastCommentDate>
  <LastCommentByID>dabb0054-5e5f-4330-9a9d-94995172c18a</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>ec5fb282-8189-4cd7-b6d3-3d217ba44027</MetricID>
      <IndividualID>40b405af-bbd2-430a-bf7f-31e8e0286255</IndividualID>
      <ID>56142cb4-ed34-4415-9a23-1b5987b93e1f</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>088b1aa1-920a-4028-975a-29720e94e9e5</SiteID>
    </MetricOwner>
    <MetricOwner>
      <MetricID>ec5fb282-8189-4cd7-b6d3-3d217ba44027</MetricID>
      <IndividualID>40b405af-bbd2-430a-bf7f-31e8e0286255</IndividualID>
      <ID>56142cb4-ed34-4415-9a23-1b5987b93e1f</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>088b1aa1-920a-4028-975a-29720e94e9e5</SiteID>
    </MetricOwner>
  </OwnerList>
  <RollUp>25</RollUp>
  <LinkedToID>ad5c8281-39dd-44f1-b329-dfac37739741</LinkedToID>
</Metric>

application/json, text/json

Sample

{
  "ID": "55e533bd-4cba-4c37-a582-4add79f581d5",
  "ParentID": "c518e6ad-2aee-466e-bf15-645dbd5819b3",
  "AncestorID": "2b2b0a13-043b-45ec-8b8e-0dcb7961e0f4",
  "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": "67532c47-71a7-4df5-bd6c-e61c485b49ce",
  "AncestorType": 1,
  "AncestorName": "sample string 10",
  "Deleted": true,
  "DeletedByRef": true,
  "Level": 1,
  "DisplayRank": "sample string 11",
  "RankPath": "QEA=",
  "RankOrder": "sample string 12",
  "Created": "2024-10-23T22:07:52.5119194+00:00",
  "CreatedBy": "a06b5aa1-f2a3-4963-b736-43b302c3fdbc",
  "Updated": "2024-10-23T22:07:52.5119194+00:00",
  "UpdatedBy": "ea05c2a8-a73f-4364-b4c9-127d6df19fc3",
  "DisplayColor": "sample string 13",
  "DisplayColorRank": 1,
  "LatestDate": "2024-10-23T22:07:52.5119194+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": "2024-10-23T22:07:52.5119194+00:00",
  "LastCommentByID": "dabb0054-5e5f-4330-9a9d-94995172c18a",
  "LastCommentBy": "sample string 22",
  "DisplayColorName": "sample string 23",
  "CanRead": true,
  "CanUpdate": true,
  "CanDelete": true,
  "CanDelegate": true,
  "ColorRank": 1,
  "ColorName": "sample string 24",
  "OwnerList": [
    {
      "MetricID": "ec5fb282-8189-4cd7-b6d3-3d217ba44027",
      "IndividualID": "40b405af-bbd2-430a-bf7f-31e8e0286255",
      "ID": "56142cb4-ed34-4415-9a23-1b5987b93e1f",
      "MetricName": "sample string 1",
      "FirstName": "sample string 2",
      "LastName": "sample string 3",
      "FullName": "sample string 4",
      "Email": "sample string 5",
      "SiteID": "088b1aa1-920a-4028-975a-29720e94e9e5"
    },
    {
      "MetricID": "ec5fb282-8189-4cd7-b6d3-3d217ba44027",
      "IndividualID": "40b405af-bbd2-430a-bf7f-31e8e0286255",
      "ID": "56142cb4-ed34-4415-9a23-1b5987b93e1f",
      "MetricName": "sample string 1",
      "FirstName": "sample string 2",
      "LastName": "sample string 3",
      "FullName": "sample string 4",
      "Email": "sample string 5",
      "SiteID": "088b1aa1-920a-4028-975a-29720e94e9e5"
    }
  ],
  "RollUp": 25,
  "LinkedToID": "ad5c8281-39dd-44f1-b329-dfac37739741"
}

Name	Description
ID `globally unique identifier` Required on Update ID of the given metric.	`globally unique identifier` Required on Update ID of the given metric.
ParentID `globally unique identifier` ID of the parent for the given metric.	`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.	`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.	`integer` Required Rank of the given metric.
Name `string` Required Name of the given metric. (Max length 255 characters)	`string` Required Name of the given metric. (Max length 255 characters)
Description `string` Required Description of the given metric.	`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.#')	`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.	`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)	`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)	`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)	`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)	`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.	`decimal number` First Threshold of the given metric.
Threshold2 `decimal number` Second threshold of the given metric.	`decimal number` Second threshold of the given metric.
Threshold3 `decimal number` Third threshold of the given metric.	`decimal number` Third threshold of the given metric.
ColorByValue `boolean` Color of the given metric.	`boolean` Color of the given metric.
Is8020 `boolean` 80/20 setting of the given metric.	`boolean` 80/20 setting of the given metric.
SiteID `globally unique identifier` ReadOnly ID of the site for the given metric.	`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.	`integer` ReadOnly Type of the ancestor for the metric; organization, project, or individual.
AncestorName `string` ReadOnly Name of the ancestor for the given metric.	`string` ReadOnly Name of the ancestor for the given metric.
Deleted `boolean` ReadOnly Deleted status of the given metric.	`boolean` ReadOnly Deleted status of the given metric.
DeletedByRef `boolean` ReadOnly Deleted by Ref status of the given metric.	`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	`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.	`string` ReadOnly Rank that is displayed to the user.
RankPath `Collection of byte` ReadOnly Current rank of the given metric in a byte array.	`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.	`string` ReadOnly Rank in string format, (0001.0001.0001) for the given organization/department.
Created `date` ReadOnly Date the given metric was created.	`date` ReadOnly Date the given metric was created.
CreatedBy `globally unique identifier` ReadOnly ID of the individual who created the given metric.	`globally unique identifier` ReadOnly ID of the individual who created the given metric.
Updated `date` ReadOnly Date the given metric was updated.	`date` ReadOnly Date the given metric was updated.
UpdatedBy `globally unique identifier` ReadOnly ID of the individual who updated the given metric.	`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.	`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.	`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.	`date` ReadOnly Latest date a value was entered for the given metric.
LatestValue `decimal number` ReadOnly Latest value of the given metric.	`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.	`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.	`string` ReadOnly (Deprecated, replaced with LastComment) Latest comment of the metric.
Owners `string` ReadOnly Owners of the given metric.	`string` ReadOnly Owners of the given metric.
FormattedThreshold1 `string` ReadOnly Minimum threshold of the given metric, formatted using the Format value.	`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.	`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.	`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.	`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.	`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.	`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.	`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.	`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.	`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.	`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.
ColorRank `integer` ReadOnly Rank of the color assigned to the given metric.	`integer` ReadOnly Rank of the color assigned to the given metric.
ColorName `string` ReadOnly Name of the color to assigned to the given metric.	`string` ReadOnly Name of the color to assigned to the given metric.
OwnerList `Collection of MetricOwner` ReadOnly	`Collection of MetricOwner` ReadOnly
RollUp `integer` ReadOnly Roll up status of a metric. 0 = Normal, 1 = Sum Roll up, 3 = Average Roll up	`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	`globally unique identifier` ReadOnly ID of the Linked Metric