Delete telemetry records

This endpoint will delete any data within the appropriate stream that matches the supplied properties (timestamp and granularity are minimally required).

Note: The unit metric must already exist when using this endpoint, and no "value" can be supplied.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Delete matching telemetry records for an existing telemetry stream.

Body Params
records
array of objects
required

A batch of telemetry records to submit to CloudZero.

records*
Headers
string
required

Your CloudZero API Key. Note: This is not a bearer token, and should appear in the header as Authorization: <cloudzero-api-key>

Responses
201

Telemetry accepted

400

Invalid request, specific responses for:

  • Invalid JSON
  • Invalid Schema: Unrecognized filter keys
  • Invalid Schema: Missing required fields
  • Timestamp too far into the future
  • Telemetry stream must exist in order to update telemetry records
  • All records in a stream must contain the same filter keys
  • All records in a stream must contain the same granularity as the stream's granularity
403

Not authorized, make sure you're using a valid API key in the header Authorization

429

Rate limit exceeded. The API enforces rate limiting on incoming requests. Retry after a short delay.

503

Service temporarily unavailable due to downstream capacity constraints. Retry after a short delay with exponential backoff.

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!