v6

latestOpenAPI 3.1.02026-08-04135335658.3 KB

Workflow Runs

Set Workflow Run Event Rating

Endpoint to set the calling user's rating on a specific event in a workflow run.

Upsert, not append: a user has at most one rating per event, so re-rating replaces their previous value while keeping its logical_id and createdAt.

put/workflows/v1/workflow-runs/{workflow_run_id}/events/{event_logical_id}/rating

Path parameters

workflow_run_idstring required

Example:5eb7cf5a86d9755df3a6c593

event_logical_idstring 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.