create_telemetry_export

POST

/telemetry/exports

curl --request POST \
  --url https://api.siteqwality.com/telemetry/exports \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "query": { "v": 1, "signal": "logs", "text": "example", "filters": [ "example" ], "range": { "from": "example", "to": "example" }, "tz": "example", "analytics": { "group_by": [ "example" ], "measure": { "op": "count", "field": "example" }, "interval": "example", "limit": 1, "display": "timeseries" } }, "format": "ndjson" }'

• Production

Authorizations

• bearer_auth

Request Body ^required

Media type application/json

object

query

required

A log, span or trace query: the explorer URL, a saved view, a widget, an alert rule and an MCP call all carry this. text and filters are AND-combined.

object

v

required

integer format: int32

signal

required

The signal of an [EventQuery].

string

Allowed values: logs spans traces

text

The text grammar (6.5.2).

string

filters

The f grammar (6.5.1), parsed for the signal’s scope.

Array<string>

range

required

A window of T2 tokens (now, now-2h) or instants (ISO 8601, epoch milliseconds), resolved when the query is compiled, so a stored view stays rolling.

object

from

required

string

to

required

string

tz

string | null

analytics

One of:

object

Group-by analytics over an [EventQuery]: a time series or a top list.

object

group_by

Up to three fields, in the f field syntax (service, @http.route).

Array<string>

measure

object

op

required

string

Allowed values: count sum avg min max p50 p75 p90 p95 p99

field

A numeric field (duration, @db.rows); none for count.

string | null

interval

A T2 bucket interval or auto; absent means auto.

string | null

limit

Groups returned, 1 to 100; absent means 10.

integer | null format: int32

display

string

Allowed values: timeseries toplist

null

null

format

required

string

Allowed values: ndjson csv

Responses

200

Gzip-compressed NDJSON or CSV attachment

Media type application/gzip

202

Queued export

Media type application/json

object

id

required

string format: uuid

status

required

string

rows_written

integer | null format: int64

truncated

required

boolean

created_at

required

string

completed_at

string | null

expires_at

string | null

download_url

string | null

error_code

string | null

Example ^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "status": "example",
  "rows_written": 1,
  "truncated": true,
  "created_at": "example",
  "completed_at": "example",
  "expires_at": "example",
  "download_url": "example",
  "error_code": "example"
}

422

Narrow the export range or filters