Widgets

Run Widget Query

Run a widget spec for a window and return its rows with the window answered.

post/api/v1/public/widgets/query

Request

  • Base URL
    https://app.traceroot.ai
  • URL
    https://app.traceroot.ai/api/v1/public/widgets/query
  • Auth
    HTTP bearer

Query parameters

project_idstring nullable

Target project for the request. Required when authenticating with a user session token (a user credential is only meaningful scoped to a project); for an API key it is optional and, if given, must match the key's project.

Request body

bucket_secondsinteger nullable
end_timestring date-time nullable
range'30m' | '1h' | '3h' | '6h' | '1d' | '7d' | '14d' | '30d' | '60d' | '90d' nullable

A preset window ending now, by the site picker's id. Give this or explicit start_time/end_time; neither means the site's 24-hour default.

start_timestring date-time nullable

Response

Successful Response

columnsstring[] required
metaobject

Changes

No recorded changes to this operation across all 1 revision of this API.