POST
/
datasets
/
{id}
/
query

Authorizations

Authorization
string
headerrequired

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

id
string
required

Query Parameters

saveAsKind
string
streaming-duration
string
nocache
boolean

Body

application/json
endTime
string
required
resolution
string
required

The time resolution of the query’s graph, in seconds. Valid values are the query’s time range /100 at maximum and /1000 at minimum or "auto".

startTime
string
required

start and end time for the query, these must be specified as RFC3339 strings or using relative time expressions (e.g. now-1h, now-1d, now-1w, etc)

aggregations
object[]
continuationToken
string
cursor
string

A cursor for use in pagination. Use the cursor string returned in previous responses to fetch the next or previous page of results.

filter
object
groupBy
string[]
includeCursor
boolean

Specifies whether to include the row identified by the cursor in the results. Default is false.

limit
integer

Specifies the maximum number of events to return. Default is 1000, minimum is 0, maximum is 50000.

order
object[]
project
object[]
queryOptions
object
virtualFields
object[]

Response

200 - application/json
buckets
object
required
format
string
required

Format specifies the result set format. Either "legacy" (default) or "tabular".

status
object
required
fieldsMeta
object[]

FieldsMeta contains the unit information (if we have it) for each field

matches
object[]

Matches hold the matching events of a filter query in the "legacy" result format

tables
object[]

Tables hold the result tables in the "tabular" result format

Was this page helpful?

Run queryTrim dataset