observability

Record Eval Feedback

Report what happened AFTER an eval run — whether its recommendation was applied, and how you know. Call when you have acted on a report: rewritten a prompt, filed the improved copy, or decided against it. Requires evidence (did_it_myself | reported_to_me | inferred); report only what you observed, never what you assume a person did. Pass applied_to and the server checks the target actually contains it.

post/api/platform/v1/eval-runs/{id}/feedback

Request

  • Base URL: https://docs.amdahl.ai
  • URL: https://docs.amdahl.ai/api/platform/v1/eval-runs/{id}/feedback
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idstring required

Alias for eval_run_id, carrying the REST path segment. Pass eval_run_id; this exists so POST /eval-runs/:id/feedback resolves.

Request body

eval_run_idstring

The run this feedback is about.

outcome'used' | 'used_with_edits' | 'not_used' | 'unsure' required

What happened to the recommendation. unsure is a real answer and is excluded from both halves of any adoption rate — prefer it to guessing.

evidence'did_it_myself' | 'reported_to_me' | 'inferred' required

How you know. did_it_myself = you performed the action in this session (the only value that can be verified). reported_to_me = a person told you. inferred = you concluded it; honest, but excluded from published rates. Never claim first-hand knowledge of something a person did outside your session.

subject_keystring

What the feedback is about. Omit (or 'run') for the run as a whole; otherwise a stable key naming one recommendation, so the same recommendation across runs can be counted together.

what_happenedstring

Free text, unconstrained. Say what you actually did, or why the recommendation was not usable — the reason is worth more than the verdict.

applied_toobject

Where it was applied, e.g. { "kind": "agent", "id": "<uuid>" }. Recognised kinds (agent, routine, knowledge_doc) are dereferenced and checked; anything else is stored unverified rather than rejected.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.