AI feedback

Saves the caller's thumbs on one output, or updates their rating of it: 201 for a new rating with a Location, 200 for an update. Body: surface (a surface key such as ken_chat, reply_draft, ai_line), targetRef (the output's id on that surface, such as ken_chat:12:turn_3:ken), rating (up or down), reasons (chip keys), note (optional, at most 4,000 characters: a longer one is 400 on note and nothing is saved), outputSnapshot (what the person saw, cut to 16,000 characters), traceId and context (campaignId, contactId, threadId). An unknown surface, a targetRef that does not fit it or another rating is 400 naming the field. The save never looks the output up and never waits for the reward check: reward.status is pending while the note is checked (poll GET /v1/ai-feedback/{feedbackId}), none when rewards do not apply to the caller. A note earns 10 credits at 8 words and 50 at 40 on a thumbs down (a thumbs up caps at 10), once per person per output. Changing the note or reasons updates the same rating and never pays twice. Accepts Idempotency-Key. 60 writes a minute and 2,000 a day per person: past either, 429 quota_exceeded with Retry-After.

The caller's own rating and its reward, for the poll after Send (every 1.5 s for up to 15 s). Another person's rating, another workspace's, a cleared rating or an unknown id is 404.

Removes the caller's thumbs from the output (204). A reward already granted or held on it stays, and a new rating of the same output earns nothing more. Another person's rating, another workspace's or an unknown id is 404; clearing a cleared rating again is 204.

The one implicit signal only the client sees: Rewrite on a Ken reply draft or composer suggestion. Body: surface (reply_draft or reply_suggest), targetRef (the draft's or suggestion's id, such as reply_job:881 or reply_suggest:sug_12) and signal (regenerated). Recorded as a thumbs down that earns nothing (204); a repeat on the same output updates the one record. Anything else is 400 naming the field. Shares the rating write limit.