Admin

Page all tally conversations

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

Request

  • Base URL: https://ledgerhq.pro/api/v1
  • URL: https://ledgerhq.pro/api/v1/admin/tally/conversations
  • Auth: one of:
    • HTTP bearer and API key in header x-organization-id
    • HTTP bearer and API key in header x-organization-id

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.

firmOrganizationIdstring uuid
companyOrganizationIdstring uuid
changedSincestring date-time

Inclusive lower bound, e.g. UTC midnight for today.

changedBeforestring date-time

Exclusive upper bound; omit lower bound for older discovery.

createdBeforestring date-time

Exclusive upper bound; omit lower bound for older discovery.

resolution'all' | 'unresolved'

Conservative candidates; ordinary Tally chats have no resolved state. Inspect coverage.unresolvedDefinition.

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.