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.
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
Number of conversations to return (1–50)
Opaque cursor returned as nextCursor by the previous page
Discovery campaign id.
Result window: all, a preset id, or yyyy-MM-dd..yyyy-MM-dd. Omit for the campaign's default window.
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.
Text matched, ignoring case, against the customer's name and the transcript (prompts and answers).
Only this assistant's conversations.
Only conversations with this outcome for the campaign's brand.
Only this conversation: its row when the window and segments hold it, else none, so a link to one conversation reads its row once.
By when each conversation started; default newest first.
Headers
Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.
Response
Success.
Changes
No recorded changes to this operation across all 1 revision of this API.