Sign in

v1

latestOpenAPI 3.0.22026-07-261040577.4 KB
Channels

Create data point

Send a new data point to a channel for automated AI analysis. Each data point represents a single piece of customer feedback (e.g. an app review, a support ticket, or an NPS response).

The text field contains the content to analyze, and timestamp records when the feedback was originally received (in ISO 8601 format). You can optionally attach source_title and source_url to track provenance, and include metadata key-value pairs for additional context.

Once created, Dovetail will automatically classify the data point against the channel's topics.

Returns the data point object without the text content.

post/v1/channels/data

Request body

textstring required

The data point's content, used to analyze and classify the data point.

channel_idstring required

Unique identifier of the channel that the data point is associated with.

timestampstring required

The data point's timestamp in ISO8601 format.

source_titlestring

The title of the original source from which this data point was extracted.

source_urlstring

The URL of the original source from which this data point was extracted.

metadataobject

Optional key-value metadata to be included with the data point.

Example request

{
  "text": "Support email requesting a trial for Dovetail app."
}

Response

201