GEgetanana
text-ai
text-session-reviews

Put Text Session Review

Create-or-replace the current user's review for this text session.

Single transaction for review + annotations + outcome write; the finding-sync runs after commit so the user sees durable state even if sync throws.

put/api/v1/text-ai/text-sessions/{text_session_id}/review

Request

Path parameters

text_session_idstring uuid required

Request body

verdict'good' | 'par' | 'bad' required

Reviewer's coarse verdict on the whole call (V0.5).

The three values cover the spectrum without overclassifying: the agent nailed it, met the bar, or fell short. Annotations carry the signal — the verdict is a coarse summary only. See sync_review_to_findings.py for the uniform "verdict + 0 annotations → 0 findings" rule (intentional extension beyond the briefing's §9, which only guaranteed it for good/par; V0.5 extends it to bad so the sync function has one consistent rule).

outcomestring required

Response

Successful Response

idstring uuid required
text_session_idstring uuid required
reviewer_user_idstring uuid required
verdict'good' | 'par' | 'bad' required

Reviewer's coarse verdict on the whole call (V0.5).

The three values cover the spectrum without overclassifying: the agent nailed it, met the bar, or fell short. Annotations carry the signal — the verdict is a coarse summary only. See sync_review_to_findings.py for the uniform "verdict + 0 annotations → 0 findings" rule (intentional extension beyond the briefing's §9, which only guaranteed it for good/par; V0.5 extends it to bad so the sync function has one consistent rule).

outcomestring required
created_atstring date-time required
updated_atstring date-time required

Changes

No operation changes recorded.