Channels

Create data point

Changed on

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.

Required scope: channel:write

post/v1/channels/data

Request

  • Base URL
    https://dovetail.com/api
  • URL
    https://dovetail.com/api/v1/channels/data
  • Auth
    HTTP bearer

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

Changes

    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property // from the response with the status