discovery

List conversations

Deprecated: use discovery.conversations.list.v2 (discovery_conversations_list_v2), which answers the results window its rows read in scope.window; this version lists the same conversations and names in scope.dispatchId the newest run that measured a conversation of the window's last 30 days. Page through every conversation of a campaign's results window, newest or oldest first, optionally narrowed to segments, one assistant, and the campaign brand's outcome (won; mentioned while another brand or none won; absent), and searched, ignoring case, by the customer's name and the transcript's text (the customer's prompts and the assistant's answers). Each row names the customer, the assistant, when it started, how many turns it shows, the outcome, the winner and the brands it named, its first prompt, where a search hit, and how many sources it cited. Read one transcript in full with business.customer-conversations.get (the row's conversationId as id, and its customerId). A campaign without results answers its state and no rows.

get/api/v1/discovery/conversations

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/discovery/conversations
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Query parameters

limitinteger

Number of conversations to return (1–50)

cursorstring

Opaque cursor returned as nextCursor by the previous page

idstring uuid required

Discovery campaign id.

dateRangestring nullable

Result window: all, a preset id, or yyyy-MM-dd..yyyy-MM-dd. Omit for the campaign's default window.

segmentsstring[]

Narrows the read to these segments, ANDed: one axis:id per axis (any number of distinct customer: entries), in canonical axis order. Empty reads the whole dispatch.

searchstring

Text matched, ignoring case, against the customer's name and the transcript (prompts and answers).

engine'chatgpt' | 'gemini' | 'claude' | 'grok'

Only this assistant's conversations.

outcome'won' | 'mentioned' | 'absent'

Only conversations with this outcome for the campaign's brand.

conversationIdstring uuid

Only this conversation: its row when the window and segments hold it, else none, so a link to one conversation reads its row once.

sort'newest' | 'oldest'

By when each conversation started; default newest first.

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Response

Success.

nextCursorstring nullable required
totalCountinteger nullable required

Conversations the filters and search keep; null unless scope.state is ready.

Changes

No recorded changes to this operation across all 1 revision of this API.