Annotate a Run
Attach human signal (rating + required comment + optional target) to a run your org owns. Feeds the same eval corpus the engine learns from.
Authorizations
Send the credential as Authorization: Bearer <key>.
Scoped partner credentials use the exclusive nxsk_v1_... namespace.
Each scoped key is bound at issuance to one organization, one canonical
named environment, an explicit engine set, and a least-privilege
capability set. A malformed, unknown, rotated, or revoked nxsk_ key
fails closed and is never retried as a legacy key.
Capabilities used by this API are runs:write, runs:read,
engines:read, catalog:read, webhooks:manage,
runs:defensibility:read, runs:test, conversations:use, and
conversations:export. Operation descriptions name the required
capability.
Grandfathered nx_live_... and nx_test_... keys retain their existing
broad access during the compatibility window.
Path Parameters
Engine identifier slug (e.g. default).
Body
good, bad, neutral Required free-text note. Cannot be empty.
"Bound the recommended carrier; the ranking matched our judgment."
Optional pointer at the output element the note is about.
Optional caller-supplied identifier for who submitted the signal.