Skip to main content
POST
Feedback Aggregate

Body

application/json

Query for aggregate scores by time bucket and dimension.

project_id
string
required
Example:

"entity/project"

after_ms
integer
required

Inclusive lower bound on created_at (milliseconds since epoch).

Required range: x >= 0
before_ms
integer
required

Exclusive upper bound on created_at (milliseconds since epoch).

Required range: x >= 0
time_bucket_seconds
integer | null

Time bucket size in seconds, e.g. 3600 for 1h buckets

Required range: x > 0
feedback_types
string[]

Filter on feedback_type by prefix

tags
string[]

Filter to feedback that includes any of the given tags

rating_min
number | null

Include only rows with a rating >= this value

Required range: 0 <= x <= 1
rating_max
number | null

Include only rows with a rating <= this value

Required range: 0 <= x <= 1
monitor_ids
string[]

Filter to these monitor ids (exact match; suffix with '*' for prefix match).

scorer_ids
string[]

Filter to these scorer ids (exact match; suffix with '*' for prefix match).

span_agent_names
string[]

Filter to feedback whose span_agent_name matches any of these (exact).

span_types
enum<string>[]

Filter by span type (turn vs conversation).

Available options:
agent_turn,
agent_conversation
group_by
enum<string>[]

Allowed: ['scorer_id', 'span_agent_name', 'span_agent_version', 'span_status_code'].

Available options:
scorer_id,
span_agent_name,
span_agent_version,
span_status_code

Response

Successful Response

Sparse time-series of aggregated scorer feedback (empty buckets omitted).

after_ms
integer
required

Resolved inclusive lower bound, unix epoch ms (UTC).

before_ms
integer
required

Resolved exclusive upper bound, unix epoch ms (UTC).

time_bucket_seconds
integer | null

Time bucket size used (seconds). None when unbucketed.

buckets
FeedbackAggregateBucket · object[]