RateRunRequest

POST /v1/runs/{run}/rate: one gesture on a finished run (D44).

The note travels here because it lives in the run's own content and nowhere else - never an event attribute, never a metric. The event the worker publishes carries the rating and whether a note exists, and not a byte of the note itself.

Type object

Shape

Field	Type	Description
ratingrequired	Rating	One gesture on a finished run (D44): good or not good. An unrated run is a normal state, which is why the header holds an `Option<RunRating>` and this enum has no "unrated" arm.
note	RatingNote or null
rated_byrequired	ActorRef

Example

{
  "rating": "good",
  "note": "string",
  "rated_by": {
    "profile": "00000000-0000-4000-8000-000000000000",
    "kind": "person"
  }
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

POST/v1/runs/{run}/rate
Rate a finished run

Generated from contract version 1. Last updated November 12, 2026.