v6

latestOpenAPI 3.1.02026-08-04135335658.3 KB

Workflow Runs

Set Workflow Run Turn Rating

Endpoint to set the calling user's rating on a whole turn (one input/output pair).

A turn rating is a judgement of the turn itself — it deliberately does not fan out onto the turn's individual events, which carry their own independent ratings.

put/workflows/v1/workflow-runs/{workflow_run_id}/turns/{turn_index}/rating

Path parameters

workflow_run_idstring required

Example:5eb7cf5a86d9755df3a6c593

turn_indexinteger required

Request body

value'down' | 'up' | 'strong_up' required

Quality judgement a reviewer can leave on a workflow run event or turn.

Stored as the string, never as the numeric score: a score is derivable (see RATING_SCORES) and keeping the name means new values can be added without re-interpreting existing records.

Response

Successful Response

ratingsobject[]

All ratings on the target after the write, one per user

feedback_usersobject

Display identities for the authors in ratings. Sent on every write so a rating left by someone who joined after the page loaded still renders with a name.