Back

POST metricvalues?tz={tz}

Create new metric data.

Request Information

URI Parameters

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

Optional parameter to set time zone information.

Body Parameters (TrendValue)

This object takes all the parameters needed to create a new 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>dd084d3b-6036-4f79-a57c-1bece7e4af7f</ID>
  <MetricID>942e7bd2-7ee6-4a6a-9a22-8e490379bcc7</MetricID>
  <Date xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-08-28T07:25:26.9362813Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </Date>
  <Value>1</Value>
</TrendValue>

application/json, text/json

Sample
{
  "ID": "dd084d3b-6036-4f79-a57c-1bece7e4af7f",
  "MetricID": "942e7bd2-7ee6-4a6a-9a22-8e490379bcc7",
  "Date": "2025-08-28T07:25:26.9362813+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>a17b1c4a-7752-467c-9263-bfe563caa901</ID>
  <MetricID>1707c29c-89a0-4082-ad4a-81974546d1a6</MetricID>
  <Date xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-08-28T07:25:26.9362813Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </Date>
  <Value>1</Value>
  <MetricName>sample string 1</MetricName>
  <ArchiveID>7a121498-7911-40a9-8863-fb35a7dbb429</ArchiveID>
  <ArchiveName>sample string 2</ArchiveName>
  <ArchiveDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>2025-08-28T07:25:26.9362813Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </ArchiveDate>
</TrendValue>

application/json, text/json

Sample
{
  "ID": "a17b1c4a-7752-467c-9263-bfe563caa901",
  "MetricID": "1707c29c-89a0-4082-ad4a-81974546d1a6",
  "Date": "2025-08-28T07:25:26.9362813+00:00",
  "Value": 1.0,
  "MetricName": "sample string 1",
  "ArchiveID": "7a121498-7911-40a9-8863-fb35a7dbb429",
  "ArchiveName": "sample string 2",
  "ArchiveDate": "2025-08-28T07:25:26.9362813+00:00"
}