Administration

Append a human review to a Tally turn observation

Site-admin/admin-agent quality route. Reviews are attributed, append-only, and cannot alter Tally prompts, routing, authority, or accounting records. Requires admin:tally-quality:write.

post/admin/tally/flight-recorder/turns/{id}/reviews

Request

  • Base URL: https://ledgerhq.pro/api/v1
  • URL: https://ledgerhq.pro/api/v1/admin/tally/flight-recorder/turns/{id}/reviews
  • Auth: one of:
    • HTTP bearer and API key in header x-organization-id
    • HTTP bearer and API key in header x-organization-id

Path parameters

idstring uuid required

Tally turn observation UUID

Headers

Idempotency-Keystring required

Stable retry key for this posting request within the LedgerHQ organization.

Request body

version1 required
verdict'correct' | 'needs_improvement' | 'unsafe' required
issueCodesstring[] required
expectedMode'answer' | 'investigate' | 'execute' | 'continue' | 'cancel' | 'null' nullable required
expectedCapabilityGroupsstring[] required
shouldHaveActedboolean nullable required
notestring nullable required

Response

Idempotent replay of the existing review

Changes

No recorded changes to this operation across all 5 revisions of this API.