v1

latestOpenAPI 3.1.02026-07-22128346287.7 KB
Feedback

Feedback Aggregate

Aggregate typed scorer feedback (tags, ratings) over time buckets.

post/feedback/aggregate

Request body

project_idstring required
after_msinteger required

Inclusive lower bound on created_at (milliseconds since epoch).

before_msinteger required

Exclusive upper bound on created_at (milliseconds since epoch).

time_bucket_secondsinteger nullable

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

feedback_typesstring[]

Filter on feedback_type by prefix

tagsstring[]

Filter to feedback that includes any of the given tags

rating_minnumber nullable

Include only rows with a rating >= this value

rating_maxnumber nullable

Include only rows with a rating <= this value

monitor_idsstring[]

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

scorer_idsstring[]

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

span_agent_namesstring[]

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

span_typesstring[]

Filter by span type (turn vs conversation).

group_bystring[]

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

Example request

{
  "project_id": "entity/project"
}

Response

Successful Response

time_bucket_secondsinteger nullable

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

after_msinteger required

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

before_msinteger required

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