Skip to main content
POST
Feedback Stats

Body

application/json

Request for aggregated feedback statistics over time buckets.

project_id
string
required
start
string<date-time>
required

Inclusive start time (UTC, ISO 8601).

end
string<date-time> | null

Exclusive end time (UTC, ISO 8601). Defaults to now if omitted.

feedback_type
string | null

Filter by feedback_type.

trigger_ref
string | null

Filter by trigger_ref (exact or prefix match for all-versions).

granularity
integer | null

Bucket size in seconds. If omitted, auto-selected based on time range.

timezone
string
default:UTC

IANA timezone for bucket alignment.

metrics
FeedbackMetricSpec · object[]

Metrics to aggregate from payload_dump.

Response

Successful Response

Response with time-series feedback statistics.

start
string<date-time>
required

Resolved start time (always UTC, regardless of the requested timezone).

end
string<date-time>
required

Resolved end time (always UTC, regardless of the requested timezone).

granularity
integer
required

Bucket size used (in seconds)

timezone
string
required

Timezone used for bucket alignment

buckets
Buckets · object[]

Time-bucketed aggregations. Each dict has 'timestamp' (ISO string), 'count' (int), and '{agg}_{slug}' keys for each requested metric+aggregation.

window_stats
Window Stats · object | null

Aggregations over the full query window, keyed by metric slug (e.g. 'output_score'). Each value maps agg name to result.