Get a Tally conversation turn with acceptance metadata
Returns the authoritative turn record (status, error, linked assistant message id, stream state) plus the refreshed conversation, recent messages, and a nullable server-derived Bookkeeping Startup progress projection. The projection updates through this existing poll without exposing workspace paths, organization ids, raw errors, or model-authored progress. Completed turns include a sanitized acceptance block — provider, model, provider attempts, iteration/token/cost/tool-byte runtime totals, tool call names with read-only flags, failover and mutation-boundary indicators, and continuation state — with no raw tool inputs, tool outputs, or prompt text. The live acceptance harness polls this route to prove model identity, runtime budgets, and safety boundaries.
Request
- Base URL: https://ledgerhq.pro/api/v1
- URL: https://ledgerhq.pro/api/v1/tally/conversations/{id}/turns/{turnId}
- 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
Tally conversation UUID
Tally conversation turn UUID
Query parameters
Set to status to return only { turn } (status, error, partial text, step label) without the conversation payload. Use it for frequent polling, then read the conversation once the turn finishes.
Response
Turn record with acceptance metadata, conversation, and recent messages; with view=status, only the turn record
Changes
No recorded changes to this operation across all 5 revisions of this API.