discovery

Export conversations (v3)

Export a campaign's conversations of a date range as CSV (one row per conversation, no transcripts), JSONL, or Markdown (both with transcripts), optionally filtered: each conversation measured for the campaign's results, dated by the UTC day it ended. Answers the campaign's results window over the range (scope) and the file's name, type and size with a short-lived url to GET it (fetch it before expiresAt; call again for a fresh export). A campaign without results exports an empty file. Every export is audited.

get/api/v1/discovery/conversations/export-v3

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/discovery/conversations/export-v3
  • 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

campaignIdstring uuid required

Discovery campaign id.

format'csv' | 'jsonl' | 'markdown'

csv: one row per conversation, no transcripts. jsonl: one JSON conversation per line, with its transcript. markdown: readable transcripts.

enginestring

Only assistants whose name contains this text (text filters ignore case).

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

Only conversations of this overall sentiment.

topicstring

Only conversations with a topic containing this text.

labelstring

Only conversations whose win reason, loss reason, or decision factor contains this text.

sourcestring

Only conversations with a source whose URL or site name contains this text.

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

Only conversations your brand won, lost, was mentioned in, or was absent from.

labelsstring

Only customers on a list (Labels) whose name contains this text.

productstring

Only conversations about a product (revenue line) whose name contains this text.

audiencestring

Only customers of an audience whose name contains this text.

channelstring

Only customers of a channel whose name contains this text.

marketstring

Only customers of a market whose name contains this text.

dateRangestring nullable

The days whose conversations the file holds: all, a preset id, or yyyy-MM-dd..yyyy-MM-dd. Omit for the campaign's default range.

Headers

Point11-Organizationstring uuid

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

Response

Success.

filenamestring required

Suggested file name for saving the bytes

contentTypestring required
byteLengthinteger required
urlstring uri nullable required

Short-lived presigned URL that GETs the bytes; null when this deployment cannot sign the object

expiresAtstring date-time nullable required

When url stops working (minutes after the call); null with url

exportIdstring uuid required

This export's id, recorded on its audit row.

rowCountinteger required

Conversations in the file.

format'csv' | 'jsonl' | 'markdown' required

Changes

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