Replace telemetry records

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

Note: If no existing data matches the supplied properties, the data will be added to the stream.

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

Update 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
200

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!