Back

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

Update metric data.

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 trend value to update.
tz string

Optional parameter to set time zone information.

Body Parameters (TrendValue)

This object takes all the parameters needed to update a trend value.

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

ID of the Metric Data.
MetricID globally unique identifier Required on Create

ID of the metric.
Date date Required

Date of the metric data
Value decimal number Required

Value of the metric data
MetricName string ReadOnly

Name of the metric.
ArchiveID globally unique identifier ReadOnly

ID of the archive were the metric data is stored.
ArchiveName string ReadOnly

Name of the archive were the metric data is stored.
ArchiveDate date ReadOnly

Date the metric data was archived.

Request Formats

application/xml, text/xml

Sample
<TrendValue xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>b281af22-9704-4f71-be20-3a35dc6f192b</ID>
  <MetricID>08db4cf6-b4d7-462e-aa7f-ec1528be7bc7</MetricID>
  <Date xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-08-26T16:59:31.4683722Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </Date>
  <Value>1</Value>
</TrendValue>

application/json, text/json

Sample
{
  "ID": "b281af22-9704-4f71-be20-3a35dc6f192b",
  "MetricID": "08db4cf6-b4d7-462e-aa7f-ec1528be7bc7",
  "Date": "2025-08-26T16:59:31.4683722+00:00",
  "Value": 1.0
}

Response Information

Resource Description (TrendValue)

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

ID of the Metric Data.
MetricID globally unique identifier Required on Create

ID of the metric.
Date date Required

Date of the metric data
Value decimal number Required

Value of the metric data
MetricName string ReadOnly

Name of the metric.
ArchiveID globally unique identifier ReadOnly

ID of the archive were the metric data is stored.
ArchiveName string ReadOnly

Name of the archive were the metric data is stored.
ArchiveDate date ReadOnly

Date the metric data was archived.

Response Formats

application/xml, text/xml

Sample
<TrendValue xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://col4.com/api/v4">
  <ID>1c57ce5e-afa6-4ba5-b822-f1d6b445f66c</ID>
  <MetricID>45538d28-436d-4e52-abf5-aeaae3579411</MetricID>
  <Date xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-08-26T16:59:31.4683722Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </Date>
  <Value>1</Value>
  <MetricName>sample string 1</MetricName>
  <ArchiveID>d9ab1818-ff02-485e-8bfa-16b90147a725</ArchiveID>
  <ArchiveName>sample string 2</ArchiveName>
  <ArchiveDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-08-26T16:59:31.4683722Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </ArchiveDate>
</TrendValue>

application/json, text/json

Sample
{
  "ID": "1c57ce5e-afa6-4ba5-b822-f1d6b445f66c",
  "MetricID": "45538d28-436d-4e52-abf5-aeaae3579411",
  "Date": "2025-08-26T16:59:31.4683722+00:00",
  "Value": 1.0,
  "MetricName": "sample string 1",
  "ArchiveID": "d9ab1818-ff02-485e-8bfa-16b90147a725",
  "ArchiveName": "sample string 2",
  "ArchiveDate": "2025-08-26T16:59:31.4683722+00:00"
}