read

Returns customer service conversation threads for the current store. Each thread aggregates one email conversation with

Returns customer service conversation threads for the current store. Each thread aggregates one email conversation with category, sentiment, message count, and an AI summary. Use when the user asks about customer complaints, support trends, or specific conversation threads.

post/api/v1/tools/get_cs_threads

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/get_cs_threads
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.magistry.io/api/oauth/authorize, token URL https://app.magistry.io/api/oauth/token, scopes: cs:read)

Request body

status'open' | 'closed' | 'all'

open = attention not resolved (default); closed = attention resolved; all = no filter.

sentiment'positive' | 'neutral' | 'negative'

Optional: filter threads by sentiment. positive ≥ 0.2, negative ≤ -0.2, neutral in between.

limitinteger

Max threads to return (default 10, max 30).

Response

Tool result

okboolean required
resultunknown required

Changes

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