Admin

Page a tally transcript

Requires current site-admin browser session or an admin-agent key satisfying admin:chats:read; admin:read also satisfies it. Admin MCP OAuth does not authenticate this REST route. Detail reads write transcript-access audits, not customer data.

get/admin/tally/conversations/{id}

Request

  • Base URL: https://ledgerhq.pro/api/v1
  • URL: https://ledgerhq.pro/api/v1/admin/tally/conversations/{id}
  • 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

Query parameters

pagedtrue required

Use exhaustive paged mode; omission selects the legacy interactive UI response.

limitinteger
cursorstring

Previous nextCursor; keep filters unchanged and consume to null.

reasonstring

Audited inspection reason; REST has a default, MCP requires it.

includeMetadataboolean

Set false for full-text transcript review without large internal metadata. Message text, roles, IDs and pagination are unchanged; coverage.metadataIncluded is explicit.

component'messages' | 'turns'

Independent cursor per component. All stored messages, including hidden/history/tool roles.

Response

Bounded live page, stable id ASC ordering, full message content and connected-app diagnostics with credential redaction only. Connected-app use does not hide a conversation from authenticated admins. No lifetime cap. Not a database snapshot; replay changedSince=scanStartedAt with overlap and periodically scan all history for metadata-only edits.

conversationsobject[]
conversationobject
messagesobject[]
turnsobject[]
nextCursorstring nullable required
hasMoreboolean required

Changes

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