Updates one or more time series. Fields outside of the request remain unchanged.
For primitive fields (those whose type is string, number, or boolean), use "set": value
to update the value; use "setNull": true
to set the field to null.
For JSON array fields (for example securityCategories
), use "set": [value1, value2]
to
update the value; use "add": [value1, value2]
to add values; use
"remove": [value1, value2]
to remove values.
List of changes.
required | Array of TimeSeriesUpdateById (object) or TimeSeriesUpdateByExternalId (object) or TimeSeriesUpdateByInstanceId (object) (TimeSeriesUpdate) [ 1 .. 1000 ] items |
Response with the corresponding time series after applying the updates.
IDs not found.
Time series with the specified externalIds already exists. Retry request, with the existing externalIds removed.
Duplicate IDs found. Retry request, keeping only one instance of each duplicated ID.
{- "items": [
- {
- "id": 1,
- "update": {
- "externalId": {
- "set": "string"
}, - "name": {
- "set": "string"
}, - "metadata": {
- "set": {
- "key1": "value1",
- "key2": "value2"
}
}, - "unit": {
- "set": "string"
}, - "unitExternalId": {
- "set": "string"
}, - "assetId": {
- "set": 0
}, - "isStep": {
- "set": true
}, - "description": {
- "set": "string"
}, - "securityCategories": {
- "set": [
- 0
]
}, - "dataSetId": {
- "set": 0
}
}
}
]
}
{- "items": [
- {
- "id": 1,
- "externalId": "string",
- "instanceId": {
- "space": "string",
- "externalId": "string"
}, - "name": "string",
- "isString": true,
- "metadata": {
- "property1": "string",
- "property2": "string"
}, - "unit": "string",
- "unitExternalId": "string",
- "assetId": 1,
- "isStep": true,
- "description": "string",
- "securityCategories": [
- 0
], - "dataSetId": 1,
- "createdTime": 1730204346000,
- "lastUpdatedTime": 1730204346000
}
]
}