v3

latestOpenAPI 3.1.02026-07-3178343213.9 KB

runs

Submit feedback on an agent run

Records a rating on an agent run artifact. The rating can be POSITIVE or NEGATIVE. Attribution defaults to the authenticated user; API-key callers are attributed to their account instead.

post/v1/runs/{id}/feedback

Path parameters

idstring required

Agent run ID

Headers

Authorizationstring required

Bearer authentication

Request body

rating'POSITIVE' | 'NEGATIVE' required

Rating value to record for this artifact.

artifact_idstring uuid required

Identifier of the artifact to rate.

commentstring nullable

Optional free-text comment explaining the rating. Whitespace is stripped server-side; empty or whitespace-only strings are normalized to null.

Response

feedback recorded successfully

objectstring required

Object type identifier.

idstring uuid required

Unique identifier for the feedback record.

run_idstring uuid required

Identifier of the agent run the feedback is attached to.

rating'POSITIVE' | 'NEGATIVE' required

Rating value submitted by the reviewer.

artifact_idstring uuid required

Identifier of the artifact within the run that was rated.

commentstring nullable required

Optional free-text comment submitted with the rating.

superseded_priorboolean required

True if a prior active rating from the same reviewer for the same (run, artifact) tuple was superseded by this new rating.

created_atstring date-time required

Timestamp when the feedback was created.