Batch delete time series points

post

https://data.api.exabel.com/v1/signals/{signalId}/timeSeries/points:batchDelete

Delete multiple time series points in bulk, by erasing the points from the storage. Use with care: Time series storage is optimized by discarding values which haven't changed from the previous versions. Note that this optimization may cause surprising behavior when updating older versions. When older versions are deleted, it is therefore recommended to perform a full backload from this version on.

Deleting a value is both different from inserting NaN values, or inserting no value.

If you would like to delete multiple time series points belonging to different signals, specify - as the signal identifier. (Signal identifiers are part of each time series' resource name, so your time series will still be assigned to their corresponding signals.)

Note: Exabel only supports processing time series with daily or lower resolution. Timestamps must be RFC 3339 timestamps, normalised to midnight UTC, e.g. 2020-01-01T00:00:00Z.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

signalId

string

required

The ID of a signal, e.g. signalIdentifier or namespace.signalIdentifier. The namespace must be empty (being global) or a namespace accessible to the customer. The signal identifier must match the regex [a-zA-Z]\w{0,63}.

Body Params

timeSeries

array of objects

The list of time series points to delete. If a knownTime is empty, all data for the time series at that time is deleted. For all points, value is ignored. Trying to delete points from a non-existing time series will result in an error, but trying to delete a non-existing point from an existing time series will not result in an error.

timeSeries

statusInResponse

boolean

Set to true to report the status of each time series in the response. If false, a failure for one time series will fail the entire request, and a sample of the failures will be reported in the trailers.

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A successful response.

defaultAn unexpected error response.